adding the core file that is run directly by your python interpreter
updating readme with usage and description