# aiohttp > Async http client/server framework (asyncio) - **URL**: https://www.freshcrate.ai/projects/aiohttp - **Author**: pypi - **Category**: Frameworks - **Latest version**: `v3.14.0` (2026-06-01) - **License**: Apache-2.0 AND MIT - **Source**: https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI - **Homepage**: https://pypi.org/project/aiohttp/ - **Language**: Python - **GitHub**: 16,409 stars, 2,253 forks - **Registry**: pypi (`aiohttp`) - **Tags**: `pypi` ## Description ================================== 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://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/endpoint?url=https://codspeed.io/badge.json :target: https://codspeed.io/aio-libs/aiohttp :alt: Codspeed.io status for aiohttp 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: ... Coming from `requests `_ ? Read `why we need so many lines `_. 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 `_ * `Built with aiohttp `_ * `Powered by aiohttp `_ 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 ============ - attrs_ - multidict_ - yarl_ - frozenlist_ Optionally you may install the aiodns_ library (highly recommended for sake of speed). .. _aiodns: https://pypi.python.org/pypi/aiodns .. _attrs: https://github.com/python-attrs/attrs .. _multidict: https://pypi.python.org/pypi/multidict .. _frozenlist: https://pypi.org/project/frozenlist/ .. _yarl: https://pypi.python.org/pypi/yarl .. _async-timeout: https://pypi.python.org/pypi/async_timeout 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/w ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `v3.14.0` | 2026-06-01 | High | We have a new website! https://aio-libs.org Subscribe to the news feed to find out more about what we're working on in future. Features -------- - Added ``RequestKey`` and ``ResponseKey`` classes, which enable static type checking for request & response context storages in the same way that ``AppKey`` does for ``Application`` -- by :user:`gsoldatov`. *Related issues and pull requests on GitHub:* #11766. - Added :func:`~aiohttp.encode_basic_auth` for encoding HTTP Basic Authent | | `3.13.5` | 2026-04-21 | Low | Imported from PyPI (3.13.5) | | `v3.13.5` | 2026-03-31 | Medium | Bug fixes --------- - Skipped the duplicate singleton header check in lax mode (the default for response parsing). In strict mode (request parsing, or ``-X dev``), all RFC 9110 singletons are still enforced -- by :user:`bdraco`. *Related issues and pull requests on GitHub:* #12302. ---- | | `v3.13.5` | 2026-03-31 | Medium | Bug fixes --------- - Skipped the duplicate singleton header check in lax mode (the default for response parsing). In strict mode (request parsing, or ``-X dev``), all RFC 9110 singletons are still enforced -- by :user:`bdraco`. *Related issues and pull requests on GitHub:* #12302. ---- | | `v3.13.5` | 2026-03-31 | Medium | Bug fixes --------- - Skipped the duplicate singleton header check in lax mode (the default for response parsing). In strict mode (request parsing, or ``-X dev``), all RFC 9110 singletons are still enforced -- by :user:`bdraco`. *Related issues and pull requests on GitHub:* #12302. ---- | | `v3.13.5` | 2026-03-31 | Medium | Bug fixes --------- - Skipped the duplicate singleton header check in lax mode (the default for response parsing). In strict mode (request parsing, or ``-X dev``), all RFC 9110 singletons are still enforced -- by :user:`bdraco`. *Related issues and pull requests on GitHub:* #12302. ---- | | `v3.13.5` | 2026-03-31 | Medium | Bug fixes --------- - Skipped the duplicate singleton header check in lax mode (the default for response parsing). In strict mode (request parsing, or ``-X dev``), all RFC 9110 singletons are still enforced -- by :user:`bdraco`. *Related issues and pull requests on GitHub:* #12302. ---- | | `v3.13.5` | 2026-03-31 | Medium | Bug fixes --------- - Skipped the duplicate singleton header check in lax mode (the default for response parsing). In strict mode (request parsing, or ``-X dev``), all RFC 9110 singletons are still enforced -- by :user:`bdraco`. *Related issues and pull requests on GitHub:* #12302. ---- | | `v3.13.5` | 2026-03-31 | Medium | Bug fixes --------- - Skipped the duplicate singleton header check in lax mode (the default for response parsing). In strict mode (request parsing, or ``-X dev``), all RFC 9110 singletons are still enforced -- by :user:`bdraco`. *Related issues and pull requests on GitHub:* #12302. ---- | | `v3.13.5` | 2026-03-31 | Medium | Bug fixes --------- - Skipped the duplicate singleton header check in lax mode (the default for response parsing). In strict mode (request parsing, or ``-X dev``), all RFC 9110 singletons are still enforced -- by :user:`bdraco`. *Related issues and pull requests on GitHub:* #12302. ---- | ## Dependency audit - **Score**: 85/100 - **Total deps**: 12 - **Resolved**: 9 - **Unresolved**: 3 - **License conflicts**: 0 - **Warnings**: 5 - **Scanned**: 2026-05-18 ## Citation - HTML: https://www.freshcrate.ai/projects/aiohttp - Markdown: https://www.freshcrate.ai/projects/aiohttp.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/aiohttp/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._