Check your open source dependency risks. Get immediate insight about security, stability and licensing risks.

De-risk your app now

Security

	Vulnerabilities
Version	Suggest	Low	Medium	High	Critical

4.0.0a1	0	0
4.0.0a0	0	0
3.12.13	0	0
3.12.12	0	0
3.12.11	0	0
3.12.10	0	0
3.12.9	0	0
3.12.8	0	0
3.12.7	0	0
3.12.7rc0	0	0
3.12.6	0	0
3.12.4	0	0
3.12.3	0	0
3.12.2	0	0
3.12.1	0	0
3.12.1rc0	0	0
3.12.0rc1	0	0
3.12.0rc0	0	0
3.12.0b3	0	0
3.12.0b2	0	0
3.12.0b1	0	0
3.12.0b0	0	0
3.12.0	0	0
3.11.18	0	0
3.11.17	0	0
3.11.16	0	0
3.11.15	0	0
3.11.14	0	0
3.11.13	0	0
3.11.12	0	0
3.11.11	0	0
3.11.10	0	0
3.11.9	0	0
3.11.8	0	0
3.11.7	0	0
3.11.6	0	0
3.11.5	0	0
3.11.4	0	0
3.11.3	0	0
3.11.2	0	0
3.11.1	0	0
3.11.0rc2	0	0
3.11.0rc1	0	0
3.11.0rc0	0	0
3.11.0b5	0	0
3.11.0b4	0	0
3.11.0b3	0	0
3.11.0b2	0	0
3.11.0b1	0	0
3.11.0b0	0	0
3.11.0	0	0
3.10.11	0	0
3.10.11rc0	2	0
3.10.10	2	0
3.10.9	2	0
3.10.8	2	0
3.10.7	2	0
3.10.6	2	0
3.10.6rc2	2	0
3.10.6rc1	2	0
3.10.6rc0	2	0
3.10.5	1	0
3.10.4	1	0
3.10.3	1	0
3.10.2	1	0
3.10.1	2	0
3.10.0rc0	2	0
3.10.0b1	2	0
3.10.0	2	0
3.9.5	2	0
3.9.4	2	0
3.9.4rc0	5	1
3.9.3	4	0
3.9.2	4	0
3.9.1	5	1
3.9.0rc0	5	1
3.9.0b1	5	1
3.9.0b0	5	1
3.9.0	5	1
3.8.6	7	1
3.8.5	8	2
3.8.4	9	3
3.8.3	9	3
3.8.2	9	3
3.8.1	10	3
3.8.0b0	9	3
3.8.0a7	9	3
3.8.0	9	3
3.7.4.post0	10	3
3.7.4	10	3
3.7.3	11	3
3.7.2	11	3
3.7.1	11	3
3.7.0b1	11	3
3.7.0b0	11	3
3.7.0	11	3
3.6.3	11	3
3.6.2	11	3
3.6.2a2	11	3
3.6.2a1	11	3
3.6.2a0	11	3
3.6.1	11	3
3.6.1b4	11	3
3.6.1b3	11	3
3.6.0b0	11	3
3.6.0a9	11	3
3.6.0a8	11	3
3.6.0a7	11	3
3.6.0a6	11	3
3.6.0a5	11	3
3.6.0a4	11	3
3.6.0a3	11	3
3.6.0a2	11	3
3.6.0a12	11	3
3.6.0a11	11	3
3.6.0a1	11	3
3.6.0a0	11	3
3.6.0	11	3
3.5.4	11	3
3.5.3	11	3
3.5.2	11	3
3.5.1	11	3
3.5.0b3	11	3
3.5.0b2	11	3
3.5.0b1	11	3
3.5.0a1	11	3
3.5.0	11	3
3.4.4	11	3
3.4.3	11	3
3.4.2	11	3
3.4.1	11	3
3.4.0b2	11	3
3.4.0b1	11	3
3.4.0a3	11	3
3.4.0a0	11	3
3.4.0	11	3
3.3.2	11	3
3.3.2a0	11	3
3.3.1	11	3
3.3.0a0	11	3
3.3.0	11	3
3.2.1	11	3
3.2.0	11	3
3.1.3	11	3
3.1.2	11	3
3.1.1	11	3
3.1.0	11	3
3.0.9	11	3
3.0.8	11	3
3.0.7	11	3
3.0.6	11	3
3.0.5	11	3
3.0.4	11	3
3.0.3	11	3
3.0.2	11	3
3.0.1	11	3
3.0.0b4	11	3
3.0.0b3	11	3
3.0.0b2	11	3
3.0.0b1	11	3
3.0.0b0	11	3
3.0.0	11	3
2.3.10	12	3
2.3.9	12	3
2.3.8	12	3
2.3.7	12	3
2.3.6	12	3
2.3.5	12	3
2.3.4	12	3
2.3.3	12	3
2.3.2	12	3
2.3.2b3	12	3
2.3.2b2	12	3
2.3.1	12	3
2.3.1a1	12	3
2.3.0a4	12	3
2.3.0a3	12	3
2.3.0a2	12	3
2.3.0a1	12	3
2.3.0	12	3
2.2.5	12	3
2.2.4	12	3
2.2.3	12	3
2.2.2	12	3
2.2.1	12	3
2.2.0	12	3
2.1.0	12	3
2.0.7	12	3
2.0.6	12	3
2.0.5	12	3
2.0.4	12	3
2.0.3	12	3
2.0.2	12	3
2.0.1	12	3
2.0.0rc1	12	3
2.0.0	12	3
1.3.5	12	3
1.3.4	12	3
1.3.3	12	3
1.3.2	12	3
1.3.1	12	3
1.3.0	12	3
1.2.0	12	3
1.1.6	12	3
1.1.5	12	3
1.1.4	12	3
1.1.3	12	3
1.1.2	12	3
1.1.1	12	3
1.1.0	12	3
1.0.5	12	3
1.0.3	12	2
1.0.2	12	2
1.0.1	12	2
1.0.0	12	2
0.22.5	12	2
0.22.4	12	2
0.22.3	12	2
0.22.2	12	2
0.22.1	12	2
0.22.0b6	12	2
0.22.0b5	12	2
0.22.0b4	12	2
0.22.0b3	12	2
0.22.0b2	12	2
0.22.0b1	12	2
0.22.0b0	12	2
0.22.0a0	12	2
0.22.0	12	2
0.21.6	12	2
0.21.5	12	2
0.21.4	12	2
0.21.2	12	2
0.21.1	12	2
0.21.0	12	2
0.20.2	12	2
0.20.1	12	2
0.20.0	12	2
0.19.0	12	2
0.18.4	12	2
0.18.3	12	2
0.18.2	12	2
0.18.1	12	2
0.18.0	12	2
0.17.4	12	2
0.17.3	12	2
0.17.2	12	2
0.17.1	12	2
0.17.0	12	2
0.16.6	12	2
0.16.5	12	2
0.16.4	12	2
0.16.3	12	2
0.16.2	12	2
0.16.1	12	2
0.16.0	12	2
0.15.3	12	2
0.15.2	12	2
0.15.1	12	2
0.15.0	12	2
0.14.4	12	2
0.14.3	12	2
0.14.2	12	2
0.14.1	12	2
0.14.0	12	2
0.13.1	12	2
0.13.0	12	2
0.12.0	12	2
0.11.0	12	2
0.10.2	12	2
0.10.1	12	2
0.10.0	12	2
0.9.3	12	2
0.9.2	12	2
0.9.1	12	2
0.9.0	12	2
0.8.4	12	2
0.8.3	12	2
0.8.2	12	2
0.8.1	12	2
0.8.0	12	2
0.7.3	12	2
0.7.2	12	2
0.7.1	12	2
0.7.0	12	2
0.6.5	12	2
0.6.4	12	2
0.6.3	12	2
0.6.2	12	2
0.6.1	12	2
0.6.0	12	2
0.5.0	12	2
0.4.4	12	2
0.4.3	12	2
0.4.2	12	2
0.4.1	12	2
0.4	12	2
0.3	12	2
0.2	12	2
0.1	12	2

Stability

Latest release:

4.0.0a1 - This version is safe to use because it has no known security vulnerabilities at this time. Find out if your coding project uses this component and get notified of any reported security vulnerabilities with Meterian-X Open Source Security Platform

Licensing

Maintain your licence declarations and avoid unwanted licences to protect your IP the way you intended.

Apache-2.0 - Apache License 2.0

Not a wildcard

Not proprietary

OSI Compliant

================================== Async http client/server framework

.. image:: https://raw.githubusercontent.com/aio-libs/aiohttp/master/docs/aiohttp-plain.svg :height: 64px :width: 64px :alt: aiohttp logo

.. image:: https://github.com/aio-libs/aiohttp/workflows/CI/badge.svg :target: https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI :alt: GitHub Actions status for master branch

.. image:: https://codecov.io/gh/aio-libs/aiohttp/branch/master/graph/badge.svg :target: https://codecov.io/gh/aio-libs/aiohttp :alt: codecov.io status for master branch

.. image:: https://img.shields.io/endpoint?url=https://codspeed.io/badge.json :target: https://codspeed.io/aio-libs/aiohttp :alt: Codspeed.io status for aiohttp

.. image:: https://badge.fury.io/py/aiohttp.svg :target: https://pypi.org/project/aiohttp :alt: Latest PyPI package version

.. image:: https://img.shields.io/pypi/dm/aiohttp :target: https://pypistats.org/packages/aiohttp :alt: Downloads count

.. image:: https://readthedocs.org/projects/aiohttp/badge/?version=latest :target: https://docs.aiohttp.org/ :alt: Latest Read The Docs

.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat :target: https://matrix.to/#/%23aio-libs:matrix.org :alt: Matrix Room — #aio-libs:matrix.org

.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat :target: https://matrix.to/#/%23aio-libs-space:matrix.org :alt: 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

Client

To get something from the web:

.. code-block:: python

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:

.. code-block::

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

Coming from requests <https://requests.readthedocs.io/>_ ? Read why we need so many lines <https://aiohttp.readthedocs.io/en/latest/http_request_lifecycle.html>_.

Server

An example using a simple server:

.. code-block:: python

# 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

Third party libraries <http://aiohttp.readthedocs.io/en/latest/third_party.html>_
Built with aiohttp <http://aiohttp.readthedocs.io/en/latest/built_with.html>_
Powered by aiohttp <http://aiohttp.readthedocs.io/en/latest/powered_by.html>_

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 <https://matrix.to/#/#aio-libs:matrix.org>_

We support Stack Overflow <https://stackoverflow.com/questions/tagged/aiohttp>_. Please add aiohttp tag to your question there.

Requirements

multidict_
yarl_
frozenlist_

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

.. _aiodns: https://pypi.python.org/pypi/aiodns .. _multidict: https://pypi.python.org/pypi/multidict .. _frozenlist: https://pypi.org/project/frozenlist/ .. _yarl: https://pypi.python.org/pypi/yarl

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

Componentpedia / Listings / aiohttp

aiohttp