Topical is a publish/subscribe based messaging system organised around topics.

Users may subscribe and unsubscribe to messages in a topic and post messages to any topic (even those they are not subscribed to). They can also request to receive any messages from a topic in order to read them. Once a user has received a message they will not receive it again.

To run Topical, you will need Python 3 and the virtualenv tool. To initialise the virtual environment and run topical:

$ virtualenv --python=python3 venv
$ . venv/bin/activate
$ python3 setup.py develop
$ topical

By default topical will run on port 8080, you can use the --port option to change it if you already have software running on port 8080.

Disclaimer - this works on Ubuntu 15.10 but should also work on any other environment with python3 and virtualenv available

After activating the virtual environment, tests can be run with:

$ python3 setup.py nosetests

This will run unit and acceptance tests and generate coverage reports