experimental/sources/: aiohttp-3.9.5 metadata and description

Homepage Simple index

Async http client/server framework (asyncio)

  • Development Status :: 5 - Production/Stable
  • Framework :: AsyncIO
  • Intended Audience :: Developers
  • License :: OSI Approved :: Apache Software License
  • Operating System :: POSIX
  • Operating System :: MacOS :: MacOS X
  • Operating System :: Microsoft :: Windows
  • Programming Language :: Python
  • Programming Language :: Python :: 3
  • Programming Language :: Python :: 3.8
  • Programming Language :: Python :: 3.9
  • Programming Language :: Python :: 3.10
  • Programming Language :: Python :: 3.11
  • Programming Language :: Python :: 3.12
  • Topic :: Internet :: WWW/HTTP
description_content_type text/x-rst
license Apache 2
maintainer aiohttp team <team@aiohttp.org>
maintainer_email team@aiohttp.org
  • Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org
  • Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org
  • CI: GitHub Actions, https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI
  • Coverage: codecov, https://codecov.io/github/aio-libs/aiohttp
  • Docs: Changelog, https://docs.aiohttp.org/en/stable/changes.html
  • Docs: RTD, https://docs.aiohttp.org
  • GitHub: issues, https://github.com/aio-libs/aiohttp/issues
  • GitHub: repo, https://github.com/aio-libs/aiohttp
provides_extras speedups
  • aiosignal>=1.1.2
  • attrs>=17.3.0
  • async-timeout<5.0,>=4.0; python_version < "3.11"
  • frozenlist>=1.1.1
  • multidict<7.0,>=4.5
  • yarl<2.0,>=1.0
  • aiodns; (sys_platform == "linux" or sys_platform == "darwin") and extra == "speedups"
  • Brotli; platform_python_implementation == "CPython" and extra == "speedups"
  • brotlicffi; platform_python_implementation != "CPython" and extra == "speedups"
requires_python >=3.8
File Tox results History
7 MB
aiohttp logo

GitHub Actions status for master branch codecov.io status for master branch Latest PyPI package version Latest Read The Docs Matrix Room — #aio-libs:matrix.org Matrix Space — #aio-libs-space:matrix.org

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


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], "...")


This prints:

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

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


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:

    return ws

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

if __name__ == '__main__':





Communication channels

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

gitter chat https://gitter.im/aio-libs/Lobby

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


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


aiohttp is offered under the Apache 2 license.


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


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