---
id: asysocks
version: "0.2.18"
license: unclear
license_treatment: permissive
maintenance: aging
---

# asysocks

License: permissive · Maintenance: aging · Downloads: 121.1K/mo

## What it is and what it does

asysocks is a pure-Python library for building proxy-aware applications using SOCKS5, SOCKS4, and HTTP proxy protocols asynchronously. It provides both client and server implementations that can be embedded in your own code or used via command-line tools. The client supports two modes: a listener that creates a local TCP server to tunnel connections through a proxy (useful when you cannot modify the target application), and a queue mode where you pass asyncio.Queue objects to handle proxy communication within your own async code.

The library depends on asn1crypto, cryptography, and h11 for protocol handling and cryptographic operations. It includes built-in tools for common tasks like port scanning through proxies, SOCKS5 authentication testing, and running a standalone proxy server with traffic monitoring. The project is maintained but aging—last updated 289 days ago—and has a modest user base.

Use it for:

- Tunnel connections from proxy-unaware applications through SOCKS/HTTP proxies without modifying the application itself
- Implement proxy support in async Python scripts using queue-based communication with a proxy server
- Run a SOCKS4/SOCKS5/HTTP proxy server with traffic monitoring and interception capabilities
- Perform port scanning or network reconnaissance through existing proxy infrastructure
- Test SOCKS5 authentication mechanisms with the built-in bruteforcer tool

## Worth the install?

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

Asynchronous SOCKS5, SOCKS4, and HTTP proxy client and server library in pure Python, supporting both listener and queue-based modes for proxy-aware applications.

Yes, if you need async proxy client/server functionality in pure Python. The permissive MIT license, low install friction, and lack of known vulnerabilities make it safe to use. The aging maintenance status is a minor concern for new projects, but the stable API and active repository suggest it is not abandoned. Suitable for pentesting tools, proxy-aware applications, and network utilities.

## Install

pip install asysocks
uv add asysocks
poetry add asysocks

## Installing asysocks

Before you install: Low install friction with a pure-Python wheel distribution. Maintenance status is aging—last release was 289 days ago—but the repository remains active and unarchived.

License in practice: MIT license (permissive) allows unrestricted use, modification, and distribution in both open-source and proprietary projects with minimal obligations.

Quickstart:

pip install asysocks

from asysocks.client import SOCKSClient
client = SOCKSClient()
await client.connect('proxy_host', proxy_port, 'target_host', target_port)

Requires Python 3.6 or later; asyncio event loop must be running to use the client.

Verify before relying:

- Whether the 'security' component mentioned in the description is actually implemented or remains TBD
- Performance characteristics and concurrency limits under load
- Exact port and host values for typical proxy configurations

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 121.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

socks proxy client server, async socks5 socks4, http proxy python, proxy tunneling library, asynchronous proxy forwarding, socks authentication, proxy port scanning, proxy-protocol, async-networking, pentesting

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