Could you write some more documentation for this please as others have suggested in the comments above.
How to install, what functionality (can you post as well as read?), why we would want to install this over using a browser. What made you want to develop this?
Just clone the repo and run python hnreader.py.
This application runs in the "system tray" in Mac OS X. It's just reader. Later I am willing to integrate "pocket" to save for reading later. I developed this just for fun. Plus it's a convient way to check HN news without switching from the application you're using and openning a browser ...
So.. how does one install this?
No install procedure for the moment. This is a work in progress. If you want to try just clone the git repo and run in a terminal: python hnreader.py
There is a setup.py file that can be used to create a Mac OS X app bundle using py2app but I am not satisfied with py2app ...