How to Set Up a Simple Python WebSocket with AioHTTP

December 2, 2021

A web socket consists of two significant endpoints. One end sends data, and the other end receives data. Take an example of what you can do over the internet. In this case, different nodes/computers are connected to establish a connection that will allow you to send or receive data.

A node can be a server or a client. A client sends a request, and the server will send back a response. These connections between the server and client are achieved through sockets. Thus, a socket acts as the communication endpoint.

This guide will help you understand the socket concept by building client-server socket architecture using the AioHTTP.

AioHTTP is an asynchronous HTTP client/server for Python and asyncio.

The library supports client and HTTP servers, client WebSockets and server WebSockets out of the box without callbacks.

We will build a WebSocket by setting up the client and the server with AioHTTP and sending data between the client and the server.

Table of contents


  1. Python 3.7 or later installed on your machine.
  2. Basic knowledge of Python programming.

Setting up a virtual environment using virtualenv

Virtualenv is a library for creating an independent Python environment. All the libraries we install will be installed locally for our project. First, create a project folder and open it in a command line.

Then install virtualenv by running the following command:

pip3 install virtualenv

If you have pre-installed virtualenv, ensure that your pip is up to date by running the following command from your terminal.

pip --version

You can check the version of virtualenv installed on your computer by running:

which virtualenv

If the virtualenv version is not up to date, run this command to get the latest version installed:

python3 -m pip install --upgrade pip

This will output the path as the already installed virtualenv. Initialize the environment for this project using virtualenv

python3 -m virtualenv .

Then run Activate to activate this environment by running:

  • For the Windows operating system, run this command in your:
  1. Powershell terminal
  1. Command prompt
  • For Unix systems use:
source /Scripts/activate

At this point, virtualenv is set up, and we can proceed to the next step.

Installing AioHTTP

To install AioHTTP along with the related modules, run the following command:

pip install aiohttp[speedups]

The above command will install AioHTTP along with the following packages:

The modules ensure that the AioHTTP module is as fast as possible when receiving and sending requests.

Building a server with AioHTTP

Create a file in the project folder. We will configure an AioHTTP server here.

Import the web module from the aiohttp library.

from aiohttp import web

The web module will enable us to create a local webserver. First, add a dummy list of todos.

todos = [
    {"id":"1","title":"Go to the garden"},
    {"id":"2","title":"Go to the market"},
    {"id":"3","title":"Prepare dinner"},

The dummy data will be the server’s response when called by the client.

Create a handler function that will send the dummy data.

async def handle(request):
    return web.json_response(todos)

Notice that the handler is an async function returning JSON data.

  • Initialize the application, set up the routes with their listeners, and add scripts for starting a server as shown below:
app = web.Application()

app.add_routes([web.get('/', handle),
        web.get('/todos', handle)])

if __name__ == '__main__':

Here we target the / route and the /todos route, both of which will be handled by the same function. We are also starting our server by running the application instance.

You can start the server by running the following command on your terminal. Before running the command, ensure you are in the project folder that hosts the file.


Your response should be similar to;

========= Running on =======

The server is up and running, and as you can the server is listening on port 8080.

Building a client with AioHTTP

Create a file in the project folder. Next, let’s configure the client using the AioHTTP.

Import the aiohttp and asyncio modules.

import aiohttp
import asyncio
  • aiohttp will create a client session that will listen to the server.

  • asyncio will initialize an event loop which the client will listen to.

Create a method for creating the client session and listening to the server.

async def main():
    async with aiohttp.ClientSession() as session:
        async with session.get('http://localhost:8080/todos') as response:

            print(await response.json())

Here we are creating a client session, awaiting the response from our local server, and printing out the status and JSON response from the server.

Initialize an event loop and run the main function in the event loop until completion.

loop = asyncio.get_event_loop()

The event loop will only close when the main function has been fully executed.

Sending data between client and server

To send the client and the server data, we need to run the file to receive the dummy data we set from the server.

Open a separate tab of your terminal and run the following command inside the project folder.


The above command will run the main function inside the file, and your response should be comparable to:

        'title': 'Go to the garden'
        'title': 'Go to the market'
        'title': 'Prepare dinner'


We have built a simple WebSocket by setting up an AioHTTP server and client and sending data between them. Check the following resources to learn more about the AioHTTP client and server.

Peer Review Contributions by: Odhiambo Paul