fixes for setup, readme and functional improvements