Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A Chat Server based on sockjs, websocket and tornado

Project Description

A sockJS based Chat-Server/Chat-System primary using the SockJS protocol.


Author:Anirban Roy Das
Copyright(C):2016, Anirban Roy Das <>

Check sockjsChat/LICENSE file for full Copyright notice.


sockjsChat is a very basic Chat Server which can be set up locally to chat in your LAN. It supports both Public Chat among all participants connected simultaneously at a particulartime and also Private Chat between those individual participants.

It uses the sockjs protocol to implement the real time message passing system. SockJS is implemented in many languages, primarily javascript to talk to servers in real time using its protocol, which tries to create a duplex bi-directional connectin between the Client(browser) and the Server. The server should also implement the sockjs protocol. Thus, using the sockjs-tornado library which exposes the sockjs protocol in tornado server. It first tries to create a Websocket connection, and if it fails then it fallbacks to other transport mechanisms, such as ajax, long polling, etc.

You can read more about sockjs here

Technical Specs

sockjs-client:Advance Websocket Javascript Client
Tornado:async python web server
sockjs-tornado:sockjs websocket server implementation for Tornado



  1. python 2.7+
  2. tornado
  3. sockjs-tornado
  4. sockjs-client


pip install sockjsChat

If the above dependencies do not get installed by the above command, then use the below steps to install them one by one.

Step 1 - Install pip

Follow the below methods for installing pip. One of them may help you to install pip in your system.

Step 2 - Install tornado

pip install tornado

Step 3 - Install sockjs-tornado

pip install sockjs-tornado


After having installed sockjsChat, just run the following command to use it :

  • Start Server

    $ sockjsChat [options]
  • Options

    –port:Port number where the chat server will start
  • Example

    $ sockjsChat --port=8765
  • Stop Server

    Click Ctrl+C to stop the server.


  1. Add Private Chat functionality.
  2. Manage Presence Management, sent, delivered acknowledgements.
  3. Message Persistence and delivery of messages to offline clients.
  4. Add Blog post regarding this topic.
Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
sockjsChat-1.1.0-py2-none-any.whl (28.5 kB) Copy SHA256 Checksum SHA256 py2 Wheel May 8, 2016
sockjsChat-1.1.0.tar.gz (26.3 kB) Copy SHA256 Checksum SHA256 Source May 8, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting