update README and fix flake8

3 jobs for 55-update-scripts-api in 2 minutes and 40 seconds (queued for 1 second)