birding

birding: public API twitter search stream

Overview

birding is an open source project to produce a stream of recent twitter_ activity based on a sequence of search terms, using only twitter's public APIs. It serves as both a standalone project and a demo of distributed real-time computing with Python using Storm_/streamparse_ and Kafka_/pykafka_.

Dependencies are fully automated; in a birding checkout, run with::

make run

See the docs (below) for a full discussion of birding, including how to use birding in an existing streamparse project.

To discuss this project, join the streamparse user group_.

.. _twitter: https://twitter.com .. _twitter's public APIs: https://dev.twitter.com/rest/public .. _Storm: http://storm.apache.org .. _Python: http://python.org .. _Kafka: http://kafka.apache.org .. _streamparse: https://github.com/Parsely/streamparse .. _pykafka: https://github.com/Parsely/pykafka .. _streamparse user group: https://github.com/Parsely/streamparse#user-group

Documentation

• HEAD <http://birding.readthedocs.org/en/master/>_
• Stable <http://birding.readthedocs.org/en/stable/>_

Interaction

Given a checkout of birding, to run birding in place, see Downloading and running birding <http://birding.readthedocs.org/en/master/solo.html>_.

Python Support

The birding project uses Python 2.7 and will also support Python 3.4+ when underlying dependencies support Python 3.