improved readme and build system and comments in python example