added readme and improved api