Awesome Open Source
Awesome Open Source


Travis CI Status Coveralls Code Coverage PyPi

msg is a simple, but powerful service-oriented RESTful messaging library.

msg focuses on the overlapping core features of any messaging system, so you can skip to implementing the cool parts. You can use msg to build live chat/instant messenger, a forum, a Twitter clone, a blog, etc.

msg runs in Python 2 and 3. msg can be configured to use any database supported by SQLAlchemy.

The beauty in this project is that its focus/scope is tiny, the barebones of any messaging system, which we perfect for you.

For the REST API, setup instructions, deployment instructions, and more, please read The Official msg Wiki!

Quick Start

  1. install and launch redis server
  2. pip install msg
  3. gunicorn msg.msg:app --worker-class gevent --bind localhost:5000


  1. install and launch redis server
  2. Edit msg/ or override
  3. pip install -r requirements/develop.txt

If you're using a non-default database:

python -c "import msg.msg; msg.msg.init_db()"


For the demo to work you need to install the Allow-Control-Allow-Origin: * plugin for Firefox, Chrome, whatever.

  1. cd examples
  2. python
  3. Checkout http://localhost:8080/ and http://localhost:8080/stream

If you're using httpie (sudo apt install httpie) here are some example commands:

  1. Create a user: http POST localhost:5000/user username=kitten password=yarn
  2. Create a message: http POST localhost:5000/message text="i love kittens" --auth kitten:yarn

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (822,998
Restful (29,266
Redis (23,916
Messaging (5,753
Messaging Library (43