varan is a python server performing real time monitoring of twitter entities.

• realtime monitoring of twitter entities (e.g. hashtags)
• configurable "realtime" meaning (up to the second for indexing, think 1-2 digit milliseconds for querying)
• python library & server
• very fast storage based on redis
• very fast web service based on cyclone

• python 2.7+
• redis 2.2+
• tweetstream

On Ubuntu 12.x it is recommended to setup your box like this:

sudo apt-get install redis-server
sudo `which pip` install -r requirements.txt
hg clone https://bitbucket.org/runeh/tweetstream && cd tweetstream && python setup.py bdist_egg

In case you don't have pip installed, you can:

wget http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg
sudo bash setuptools-0.6c11-py2.7.egg
sudo `which easy_install` pip

Launch the server:

PYTHONPATH=../tweetstream/dist/*egg:. python -m varan.server -c conf/ratp.conf

Then point your brower to http://localhost:8989/web/index.html

Alternatively, you can see a nice monitoring of Paris urban transport here (best viewed with Firefox)

varan is still a prototype. see TODO.

hand-tested on python 2.7.x, redis 2.2+, cyclone 1.0+

MIT. see LICENSE

varan is another name for monitor lizard