aiohttp · Python Simple Repository Browser

Project Links

Meta

Maintainer: aiohttp team <team@aiohttp.org>

Requires Python: >=3.9

Classifiers

Development Status

5 - Production/Stable

Framework

AsyncIO

Intended Audience

Developers

Operating System

POSIX
MacOS :: MacOS X
Microsoft :: Windows

Programming Language

Python
Python :: 3
Python :: 3.9
Python :: 3.10
Python :: 3.11
Python :: 3.12
Python :: 3.13
Python :: 3.14

Topic

Internet :: WWW/HTTP

Key Features

Supports both client and server side of HTTP protocol.
Supports both client and server Web-Sockets out-of-the-box and avoids Callback Hell.
Provides Web-server with middleware and pluggable routing.

Getting started

Client

To get something from the web:

import aiohttp
import asyncio

async def main():

    async with aiohttp.ClientSession() as session:
        async with session.get('http://python.org') as response:

            print("Status:", response.status)
            print("Content-type:", response.headers['content-type'])

            html = await response.text()
            print("Body:", html[:15], "...")

asyncio.run(main())

This prints:

Status: 200
Content-type: text/html; charset=utf-8
Body: <!doctype html> ...

Coming from requests ? Read why we need so many lines.

Server

An example using a simple server:

# examples/server_simple.py
from aiohttp import web

async def handle(request):
    name = request.match_info.get('name', "Anonymous")
    text = "Hello, " + name
    return web.Response(text=text)

async def wshandle(request):
    ws = web.WebSocketResponse()
    await ws.prepare(request)

    async for msg in ws:
        if msg.type == web.WSMsgType.text:
            await ws.send_str("Hello, {}".format(msg.data))
        elif msg.type == web.WSMsgType.binary:
            await ws.send_bytes(msg.data)
        elif msg.type == web.WSMsgType.close:
            break

    return ws


app = web.Application()
app.add_routes([web.get('/', handle),
                web.get('/echo', wshandle),
                web.get('/{name}', handle)])

if __name__ == '__main__':
    web.run_app(app)

Documentation

https://aiohttp.readthedocs.io/

Demos

https://github.com/aio-libs/aiohttp-demos

External links

Feel free to make a Pull Request for adding your link to these pages!

Communication channels

aio-libs Discussions: https://github.com/aio-libs/aiohttp/discussions

Matrix: #aio-libs:matrix.org

We support Stack Overflow. Please add aiohttp tag to your question there.

Requirements

Optionally you may install the aiodns library (highly recommended for sake of speed).

License

aiohttp is offered under the Apache 2 license.

Keepsafe

The aiohttp community would like to thank Keepsafe (https://www.getkeepsafe.com) for its support in the early days of the project.

Source code

The latest developer version is available in a GitHub repository: https://github.com/aio-libs/aiohttp

Benchmarks

If you are interested in efficiency, the AsyncIO community maintains a list of benchmarks on the official wiki: https://github.com/python/asyncio/wiki/Benchmarks

3.12.7rc0 Jun 02, 2025

3.12.1rc0 May 26, 2025

3.12.0 May 24, 2025

3.12.0rc1 May 24, 2025

3.12.0rc0 May 24, 2025

3.12.0b3 May 22, 2025

3.12.0b2 May 22, 2025

3.12.0b1 May 22, 2025

3.12.0b0 May 20, 2025

3.11.0rc2 Nov 13, 2024

3.11.0rc1 Nov 11, 2024

3.11.0rc0 Nov 10, 2024

3.11.0b5 Nov 10, 2024

3.11.0b4 Nov 08, 2024

3.11.0b3 Nov 06, 2024

3.11.0b2 Nov 03, 2024

3.11.0b1 Nov 02, 2024

3.11.0b0 Oct 29, 2024

3.10.11 Nov 13, 2024

3.10.11rc0 Nov 13, 2024

3.10.6rc2 Sep 24, 2024

3.10.6rc1 Sep 23, 2024

3.10.6rc0 Sep 23, 2024

3.10.0rc0 Jul 29, 2024

3.10.0b1 Jul 22, 2024

3.9.5 Apr 16, 2024

3.9.4 Apr 11, 2024

3.9.4rc0 Feb 16, 2024

3.9.0rc0 Nov 14, 2023

3.7.4.post0 Mar 06, 2021

3.6.0a12 Aug 29, 2019

3.6.0a11 Aug 29, 2019

2.0.0rc1 Mar 15, 2017

0.22.0b6 Jul 14, 2016

0.22.0b5 Jul 14, 2016

0.22.0b4 Jul 14, 2016

0.22.0b3 Jul 14, 2016

0.22.0b2 Jul 14, 2016

0.22.0b1 Jul 14, 2016

0.22.0b0 Jul 14, 2016

0.22.0a0 May 05, 2016

Wheel compatibility matrix

Platform	CPython 3.9	CPython 3.10	CPython 3.11	CPython 3.12	CPython 3.13	CPython 3.14	CPython (additional flags: t) 3.14
macosx_10_13_universal2
macosx_10_13_x86_64
macosx_10_9_universal2
macosx_10_9_x86_64
macosx_11_0_arm64
manylinux2014_aarch64
manylinux2014_armv7l
manylinux2014_ppc64le
manylinux2014_s390x
manylinux2014_x86_64
manylinux_2_17_aarch64
manylinux_2_17_armv7l
manylinux_2_17_ppc64le
manylinux_2_17_s390x
manylinux_2_17_x86_64
manylinux_2_28_aarch64
manylinux_2_28_ppc64le
manylinux_2_28_s390x
manylinux_2_28_x86_64
manylinux_2_31_armv7l
manylinux_2_31_riscv64
manylinux_2_39_riscv64
musllinux_1_2_aarch64
musllinux_1_2_armv7l
musllinux_1_2_ppc64le
musllinux_1_2_riscv64
musllinux_1_2_s390x
musllinux_1_2_x86_64
win32
win_amd64