I'm sure you've got some cool stuff here, but until you update your readme with at minimum one full, self contained working example, no-one is going to try this.
You should also turn your readme into a markdown file and incorporate the HOWTO into it. It'll make it appear a lot friendlier.