PySocks
A Python SOCKS client module. See https://github.com/Anorov/PySocks for more information.
Decision gist · record as of 2026-08-14
Yes, if you need SOCKS proxy support and are working with Python 2.7 or early Python 3 versions. The zero-dependency installation and socket-level compatibility make it straightforward to integrate. No, if you are starting a new project—use your HTTP client's native proxy support instead, or consider maintained alternatives. The abandonment status means security issues and compatibility problems will not be fixed.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a SOCKS proxy server running and accessible at the configured address and port; connection will fail if the proxy is unreachable.
- Installation is straightforward with no runtime dependencies.
- However, the package is abandoned—last release was 2019-09-20 and last commit 2023-07-17—so security patches and compatibility fixes are unlikely.
License · maintenance · safety
BSD (permissive) — BSD permissive license allows commercial and private use with minimal restrictions, making it safe to include in most projects.
last release 2019-09-20 (2520 days) · last repo commit 2023-07-17 · 1,275 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 69,215,407 downloads/mo, #474 on PyPI
Alternatives
Verify before relying
pip install PySocks
Then in your code, set a proxy on a socket object and connect normally through it, or monkeypatch the standard library socket module to apply a default proxy globally to all connections.- Whether UDP support remains reliable across modern Python versions and network conditions, given the description notes 'issues may occur in some edge cases'.
- Compatibility with current HTTP proxy implementations, since the description warns that certain HTTP proxies may not work with CONNECT tunneling.
- Whether the package works reliably with Python versions beyond 3.6, given classifiers only list support through 3.6.
What it is and what it does
PySocks is a SOCKS proxy client library that lets you send TCP and UDP traffic through SOCKS4, SOCKS5, or HTTP proxy servers. It wraps Python's standard socket module, allowing you to configure a proxy once and then use sockets normally—or monkeypatch the standard library to apply a default proxy globally. The package includes a urllib2 handler for integrating proxies into HTTP requests.
The library is a modern fork of SocksiPy and supports Python 2.7 and 3.4+. It has no external runtime dependencies, making installation and deployment simple. However, the project is no longer actively maintained, with the last release in 2019, so it may not address issues with modern proxy servers or Python versions.
Use it for
- Route socket connections through a SOCKS proxy to bypass network restrictions or anonymize traffic.
- Integrate proxy support into legacy Python 2.7 applications that rely on raw socket operations.
- Add SOCKS proxy capability to urllib2-based HTTP clients using the included sockshandler module.
- Monkeypatch the standard library to apply a single proxy to all outbound connections in a script.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need SOCKS proxy support and are working with Python 2.7 or early Python 3 versions.
The zero-dependency installation and socket-level compatibility make it straightforward to integrate. No, if you are starting a new project—use your HTTP client's native proxy support instead, or consider maintained alternatives. The abandonment status means security issues and compatibility problems will not be fixed.
Install
pysocks on PyPI
Before you install
Installation is straightforward with no runtime dependencies. However, the package is abandoned—last release was 2019-09-20 and last commit 2023-07-17—so security patches and compatibility fixes are unlikely.
Requires a SOCKS proxy server running and accessible at the configured address and port; connection will fail if the proxy is unreachable.
License in practice
BSD permissive license allows commercial and private use with minimal restrictions, making it safe to include in most projects.
Quickstart
pip install PySocks
Then in your code, set a proxy on a socket object and connect normally through it, or monkeypatch the standard library socket module to apply a default proxy globally to all connections.Verify before relying
- Whether UDP support remains reliable across modern Python versions and network conditions, given the description notes 'issues may occur in some edge cases'.
- Compatibility with current HTTP proxy implementations, since the description warns that certain HTTP proxies may not work with CONNECT tunneling.
- Whether the package works reliably with Python versions beyond 3.6, given classifiers only list support through 3.6.
Package facts
| License | BSD permissive |
| Python support | Supports the current Python release >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.* |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Abandoned 2,520 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 69,215,407 / month, #474 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6 |
Evidence: PySocks-1.7.1-py27-none-any.whl; PySocks-1.7.1-py3-none-any.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 › “socks proxy client”
- PySocksPySocks provides a SOCKS and HTTP proxy client that acts as a drop-in…
- socksioSocksio is a sans-I/O SOCKS protocol implementation that handles the…
- httpx-socksAdds SOCKS4(a), SOCKS5(h), and HTTP CONNECT proxy support to httpx…
Give your agent the search over MCP, or paste the wish link into any chat.
More Internet packages
Botocore provides low-level, data-driven access to Amazon Web Services APIs, serving as the foundation for the AWS CLI and boto3 libraries.
Install it if you need programmatic access to AWS services.
Provides an async client for AWS services using botocore and aiohttp, allowing you to call AWS APIs asynchronously within asyncio-based applications.
Install it if you need to call AWS services from async Python code; it is the standard way to do so.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides a platform-independent file locking mechanism to coordinate access to files across processes and threads.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides common Protocol Buffer message definitions used across Google Cloud APIs, enabling Python clients to interact with Google services.
See also asysocks · pproxy · SocketSwap · socksio · free-proxy · python-socks · httpx-socks · proxyproviders · aiohttp_socks · websockets-proxy