completes README.md; basic design of APIs
package.json: add keywords and deps
completes main functionalities; fixes #1