asysocks

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 on this page — 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

asysocks on PyPI

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

Evidence: asysocks-0.2.18-py3-none-any.whl

Tags

More Networking packages