aiohttp
Async http client/server framework (asyncio)
Decision gist · record as of 2026-08-14
Yes. aiohttp is production-stable (Development Status 5), actively maintained, widely used (top 100 PyPI by downloads), has no known vulnerabilities, and is dual-licensed permissively. Medium install friction is standard for compiled async libraries. Install it if you need async HTTP client or server capabilities in asyncio-based applications.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; asyncio event loop must be running to execute async code.
- Medium install friction due to compiled wheel distributions across many platforms.
- Active maintenance with a release 22 days ago and 16522 repository stars.
License · maintenance · safety
Apache-2.0 AND MIT (permissive) — Dual-licensed under Apache-2.0 AND MIT (permissive), allowing both commercial and private use with minimal restrictions on modification and distribution.
last release 2026-07-23 (22 days) · last repo commit 2026-08-14 · 16,522 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 643,629,740 downloads/mo, #49 on PyPI
Alternatives
Verify before relying
import aiohttp
import asyncio
async def main():
async with aiohttp.ClientSession() as session:
async with session.get('https://python.org') as response:
print(await response.text())
asyncio.run(main())- Performance characteristics compared to other async HTTP frameworks in typical workloads.
- Whether aiodns is included or must be installed separately for DNS performance gains.
What it is and what it does
aiohttp provides a production-stable async HTTP client and server framework built on Python's asyncio. It handles both sides of the HTTP protocol—making outbound requests and serving inbound traffic—with native WebSocket support and a middleware-based routing system for servers. The client side offers session management and connection pooling for concurrent requests, while the server side provides request handlers, WebSocket echo capabilities, and pluggable routing without callback nesting.
The package sits at the intersection of web development and async I/O, designed for applications that need to handle many concurrent connections efficiently. It has 9 runtime dependencies (attrs, multidict, yarl, frozenlist, aiosignal, async-timeout, aiohappyeyeballs, propcache, typing_extensions) and distributes pre-compiled wheels across multiple architectures and Python versions, though this adds medium install friction. It supports Python 3.10 through 3.14 and is actively maintained.
Use it for
- Building async REST APIs and web services that handle many concurrent client connections.
- Creating async HTTP clients for scraping, API integration, or microservice communication.
- Implementing real-time bidirectional communication with WebSocket support in web applications.
- Running a lightweight async web server with middleware and dynamic routing for async handlers.
- Concurrent data fetching from multiple external APIs within a single application.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
aiohttp is production-stable (Development Status 5), actively maintained, widely used (top 100 PyPI by downloads), has no known vulnerabilities, and is dual-licensed permissively. Medium install friction is standard for compiled async libraries. Install it if you need async HTTP client or server capabilities in asyncio-based applications.
Install
aiohttp on PyPI
Before you install
Medium install friction due to compiled wheel distributions across many platforms. Active maintenance with a release 22 days ago and 16522 repository stars. Requires 9 runtime dependencies including attrs, multidict, yarl, and frozenlist.
Requires Python 3.10 or later; asyncio event loop must be running to execute async code.
License in practice
Dual-licensed under Apache-2.0 AND MIT (permissive), allowing both commercial and private use with minimal restrictions on modification and distribution.
Quickstart
import aiohttp
import asyncio
async def main():
async with aiohttp.ClientSession() as session:
async with session.get('https://python.org') as response:
print(await response.text())
asyncio.run(main())
Verify before relying
- Performance characteristics compared to other async HTTP frameworks in typical workloads.
- Whether aiodns is included or must be installed separately for DNS performance gains.
Package facts
| License | Apache-2.0 AND MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 9 packagesaiohappyeyeballsaiosignalasync-timeoutattrsfrozenlistmultidictpropcachetyping_extensionsyarl |
| Maintenance | Actively maintained 22 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 643,629,740 / month, #49 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableFramework :: AsyncIOIntended Audience :: DevelopersOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Internet :: WWW/HTTP |
Evidence: aiohttp-3.14.3-cp310-cp310-macosx_10_9_universal2.whl; aiohttp-3.14.3-cp310-cp310-macosx_10_9_x86_64.whl; aiohttp-3.14.3-cp310-cp310-macosx_11_0_arm64.whl; aiohttp-3.14.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; aiohttp-3.14.3-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl; aiohttp-3.14.3-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl; aiohttp-3.14.3-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl; aiohttp-3.14.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl; aiohttp-3.14.3-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl; aiohttp-3.14.3-cp310-cp310-musllinux_1_2_aarch64.whl; aiohttp-3.14.3-cp310-cp310-musllinux_1_2_armv7l.whl; aiohttp-3.14.3-cp310-cp310-musllinux_1_2_ppc64le.whl; aiohttp-3.14.3-cp310-cp310-musllinux_1_2_riscv64.whl; aiohttp-3.14.3-cp310-cp310-musllinux_1_2_s390x.whl; aiohttp-3.14.3-cp310-cp310-musllinux_1_2_x86_64.whl; aiohttp-3.14.3-cp310-cp310-win32.whl; aiohttp-3.14.3-cp310-cp310-win_amd64.whl; aiohttp-3.14.3-cp310-cp310-win_arm64.whl; aiohttp-3.14.3-cp311-cp311-macosx_10_9_universal2.whl; aiohttp-3.14.3-cp311-cp311-macosx_10_9_x86_64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “async http client server”
- aiohttpaiohttp is an async HTTP client and server framework built on…
- pyforked-daapdA Python client library for communicating with Owntone (forked-daapd)…
- pytest-aiohttpPytest plugin that provides fixtures for testing aiohttp applications…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
yarl provides an immutable URL class for parsing, decomposing, and constructing URLs with automatic percent-encoding and decoding of URL components.
See also aiohttp-wsgi · moonraker-api · aiosonic · aiohttp-asyncmdnsresolver · aiohttp-basicauth · molotov · onvif-zeep-async · matrix-nio · aioresponses · aiointercept