inital working commit

First draft of a working commit for the API. Still needs fully testing
and the API has a lot more to expose.
updating readme

nothing special, just a bit more to the readme than the name of the
project