---
id: httpx-aiohttp
version: "0.2.0"
license: Copyright © 2025, Karen Petrosyan. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:… (full text in the JSON record)
license_treatment: unclear
maintenance: active
---

# httpx-aiohttp — Aiohttp transport for HTTPX

License: unclear · Maintenance: active · Downloads: 5.5M/mo

## What it is and what it does

httpx-aiohttp is a bridge that lets you use aiohttp as the underlying transport for httpx HTTP clients. It delegates socket-level HTTP messaging to aiohttp while keeping httpx's convenient high-level API for authentication, retries, cookies, and request/response handling. This is useful when you want aiohttp's specific behavior or integration but prefer httpx's interface and feature set.

The package is actively maintained, recently released, and has low installation friction. It supports both the standard httpx and an optional httpx2 extra. Since it's a thin adapter between two established async HTTP libraries, it's primarily useful in projects that already depend on both or that need aiohttp specifically for compatibility or performance reasons.

Use it for:

- Use it when you need httpx's API but your project is already built around aiohttp and its ecosystem.
- Use it to add httpx's retry and authentication features on top of an existing aiohttp-based async HTTP stack.
- Use it to migrate from pure aiohttp to httpx while keeping aiohttp as the transport layer for compatibility.
- Use it in projects that require aiohttp's specific connection pooling or session management behavior with httpx's higher-level interface.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides aiohttp-based transports for httpx, allowing httpx to use aiohttp for low-level HTTP messaging while keeping httpx's high-level features like authentication, retries, and cookies.

Yes, if you need both httpx and aiohttp in the same project. The package is actively maintained, has no known vulnerabilities, and low install friction. If you're already using httpx without aiohttp, there's no reason to add this dependency unless you specifically need aiohttp's transport behavior.

## Install

pip install httpx-aiohttp
uv add httpx-aiohttp
poetry add httpx-aiohttp

## Installing httpx-aiohttp

Before you install: Low install friction with only two runtime dependencies (aiohttp and httpx). Active maintenance with a recent release 20 days ago and commits through July 2026.

License in practice: Licensed under BSD 3-Clause. License treatment is marked unclear in the metadata, but the raw license text is the standard BSD 3-Clause, which is permissive and suitable for most use cases.

Quickstart:

pip install httpx-aiohttp

import httpx
from httpx_aiohttp import AiohttpTransport

async with httpx.AsyncClient(transport=AiohttpTransport()) as client:
    response = await client.get('https://example.com')

Requires Python 3.9 or later and an async context (asyncio event loop running).

Verify before relying:

- Whether httpx2 extra support is production-ready or experimental
- Performance characteristics compared to httpx's default transports
- Specific aiohttp version compatibility constraints beyond what pip resolves

## Package facts

- License: Copyright © 2025, Karen Petrosyan. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:… (full text in the JSON record) (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 5.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

httpx aiohttp transport, async http client aiohttp, httpx integration aiohttp, aiohttp backend httpx, async http with httpx, aiohttp httpx bridge, async-http, transport-adapter

[View on SkillFed](https://skillfed.io/packages/httpx-aiohttp) · [View on PyPI](https://pypi.org/project/httpx-aiohttp/)