---
id: aiohttp-socks
version: "0.12.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aiohttp_socks — Proxy connector for aiohttp

License: permissive · Maintenance: active · Downloads: 3.3M/mo

## What it is and what it does

aiohttp-socks is a proxy connector library that extends aiohttp's HTTP client to route requests through SOCKS and HTTP proxies. It wraps python-socks to provide a single integration point with aiohttp, supporting SOCKS4(a), SOCKS5(h), and HTTP CONNECT proxies individually or chained together. The library is designed for async applications that need to tunnel HTTP traffic through proxy infrastructure without managing low-level socket details.

You use it by instantiating a ProxyConnector with proxy credentials and passing it to aiohttp.ClientSession, then making requests normally. It handles authentication, remote DNS resolution for SOCKS5, and multi-proxy chains through a dedicated ChainProxyConnector class. The package maintains compatibility with recent aiohttp releases through a minimal integration surface.

Use it for:

- Route aiohttp requests through a corporate SOCKS5 proxy with authentication.
- Chain multiple proxies for layered anonymity or network segmentation in async applications.
- Tunnel HTTP traffic through HTTP CONNECT proxies in async web scrapers or API clients.
- Test async HTTP clients against proxy infrastructure in CI/CD pipelines.
- Build async applications that need to respect network policies requiring proxy routing.

## Worth the install?

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

Provides a proxy connector for aiohttp that supports SOCKS4(a), SOCKS5(h), HTTP (CONNECT) proxies, and proxy chains for async HTTP requests.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and solves a specific problem (proxy support in aiohttp) with a clean API. It is well-positioned in the ecosystem (top 5000 PyPI packages) and supports current Python versions. Install if you need proxy support for aiohttp-based async HTTP clients.

## Install

pip install aiohttp-socks
uv add aiohttp-socks
poetry add aiohttp-socks

## Installing aiohttp_socks

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (2 days old) and steady repository activity; supports current Python versions from 3.9 through 3.14.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in most commercial and open-source projects without significant restriction.

Quickstart:

pip install aiohttp_socks

import aiohttp
from aiohttp_socks import ProxyConnector

async def fetch(url):
    connector = ProxyConnector.from_url('socks5://user:password@127.0.0.1:1080')
    async with aiohttp.ClientSession(connector=connector) as session:
        async with session.get(url) as response:
            return await response.text()

Requires Python >= 3.9 and aiohttp >= 3.10.0; async context required.

Verify before relying:

- Performance characteristics when chaining multiple proxies or under high concurrency.
- Compatibility guarantees with aiohttp versions beyond 3.10.0.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aiohttp proxy connector, socks5 async proxy, asyncio socks proxy, aiohttp socks support, proxy chaining aiohttp, http connect proxy async, async-http, proxy-networking

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