harmonize API and update dependencies
Minor update
Update examples