update README and better API