add setuptools generated files
add first setup.py version
relax software versions a bit
minor syntax
add convenience imports
more instructions