1. Code
  2. Python

Build a Real-Time Chat Application With Modulus and Python

This post is part of a series called Getting Started with Modulus.
Build a Real-Time Chat Application With Modulus and Laravel 5
Build a Real-Time Chat Application With Modulus and Spring Boot
Sponsored Content

This sponsored post features a product relevant to our readers while meeting our editorial guidelines for being objective and educational.

First of all, let me show you the final look of the chat application that we will completed by the end of this article.

Chat Demo Page

We will implement the application with Flask, Gunicorn for standalone WSGI application, and Flask-SocketIO for real-time communication.

1. Scenario

Let's look at an example scenario that we can use throughout this article as we build the application:

  1. Alberto wants to use our application so he opens it in the browser.
  2. He selects a nickname and logs in to chat.
  3. He writes something in the text area and presses Enter
  4. The entered text will be broadcast to the users that are currently logged in to the chat app.

As you can see, this is a very simple application that will cover all the basics of a web application. Let's continue with the project design.

2. Prerequisites

Before proceeding with implementing the project, we need to review some required dependencies and libraries. I will perform the installation process in Ubuntu to make the installation much easier.

2.1. Python

You can simply install Python by simply executing the following command:

2.2. pip

pip is a package management system used to install and manage software packages written in Python. We will use this for installing Python packages for our application. You can install pip by executing following command:

2.3. Virtualenv

This tool enables you to create isolated Python environment. This means, you can switch your context to environment that has Python related properties and switch back to your normal environment if you do not have Python development. You can install Virtualenv by executing following command:

2.4. Gunicorn

Gunicorn stands for Green Unicorn and it is a Python WSGI (Web Server Gateway Interface) HTTP server for UNIX. Gunicorn acts like an interface between the web server and your Python application. We will use this for running our Flask application as standalone WSGI application. We need to use gunicorn@18.0 because newer versions have some problems that need to be resolved.

We are done with the installation part. Let's continue with project setup.

3. Project Setup

Create a project directory as you want;

Go to the newly created directory and create a virtual environment for Python development like this:

You can change the name of environment according to your needs. Virtual environment is created but is not activated yet. If you execute following command;

Your Python virtual environment will be activated, and we are ready to install requirements within this virtual environment. In order to be sure about virtual environment, you can check your command line starts with virtual environment name in parenthesis and you will see following;

Virtualenv activated console

3.1. Dependency Installation

We need to install some dependent libraries for our project. Create a file called requirements.txt in the root directory of your project and put following content inside file:

These dependencies will help us to create a real-time web application. Now let's install dependencies with following command

3.2 Project Skeleton

Thus far, we have created a project and installed required software. Now, let's add project specific files.

Add a file called and put the following content into it:

This is simple Flask application that runs through the Flask-SocketIO module. The first and second route is for rendering the main page and the login page. The third route is for handling the message event on the chat channel. 

When client sends a message to this endpoint, it will be broadcasted to the connected clients. This is done by emit() command. The first parameter is the message payload and second one is for setting broadcast value. If it is true, message will be broadcasted to the clients. 4th router is for simple ACK message for client side to ensure that client is connected to the socket.

3.3 Templates

We have two pages - chat.html and login.html. You can see the content of the login.html below:

This is a simple login system that includes user information stored in the cookie. When you select a nickname and proceed, your nickname will be stored to the cookie and you will be redirected to the chat page. Let's have a look at chat.html.

As we already said, the client-side can use the SocketIO JavaScript implementation on the front-end. The required client-side library is fetched from CDN. Actually, all the CSS and JavaSCript files are fetched from a CDN in order to make the application faster and to reduce the project size. You can clone this project and run it on your local computer easily.

When you go to chat page after successful login, the cookie will be checked to see if the user is logged in or not. If not, user will be redirected to login page again. If you successfully go to the chat page, there will be a socket connection between client and server. SocketIO is used on client side, and server side has been already implemented in above sections. When user clicks the Enter key or presses the Enter button, the text written in message area will be emit() to the server-side. The message will be handled on the server-side and will be broadcasted to the connected clients through hte chat channel. 

4. Running Project

We will run this project as stand-alone WSGI application. In order to do this, you can use the following command:

We are running gunicorn command with two arguments. The first is the worker class and it comes from gevent-socketio. The second is the application name with its module. Here, the module is and the application name is app (which is on the eighth line in  When you execute above command, you will see output like this:

Console run output

When you got to, you will see the following screen:

Chat page

5. Deployment

We will use Modulus for our deployment environment. First of all, create an account on Modulus and go to the Dashboard to create a new project. Fill in the Project Name and select Python box from project types and click CREATE PROJECT. 

After a successful account creation, we can proceed with the deployment. You can do deployment to Modulus in two ways:

  1. Zip your project and upload it from your Modulus dashboard
  2. Install Modulus client and deploy from command line

I will use command line deployment for this project. First of all, install Node.js on your computer. 

When we start our deployment to Modulus, Modulus will perform the following command on their side:

We have already required dependency file - requirements.txt and then it will perform following to start deployed project:

However, we need to override this command in order to make our application up. Create a file called app.json and put following command inside file:

Now we are ready to upload the file to Modulus. Open up a command line console and execute following command.

You are ready to use Modulus CLI, run following command to login Modulus.

You will be prompted for your username/email and password. Enter required credentials and it is time to deploy. Go to your project directory and execute following command.

Above command will deploy current project to the Modulus that you have created before. Do not forget to replace project name with the one you have created before. If everything is fine, you will see a success message in the console, and test your application by following url provided within the successful message in the console.

6. Conclusion

The main purpose of this tutorial was show you how to create a real-time chat application with Flask and SocketIO. We have used Modulus for PaaS provider and it has really simple steps to deploy your application to the production environment.

Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.