PySocks

A Python SOCKS client module. See https://github.com/Anorov/PySocks for more information.

pysocks Permissive license BSD Abandoned ★ 1,275 v1.7.1 released 2019-09-20

Install

pysocks on PyPI

pip

pip install pysocks

uv

uv add pysocks

poetry

poetry add pysocks

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,519 days since the last release
Last repo commit	2023-07-17
First released	2013-12-17
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: PySocks-1.7.1-py27-none-any.whl; PySocks-1.7.1-py3-none-any.whl

Keywords: socks, proxy

Programming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6

About PySocks

from the package's own PyPI description — quoted content, verbatim

PySocks

PySocks lets you send traffic through SOCKS and HTTP proxy servers. It is a modern fork of SocksiPy with bug fixes and extra features.

Acts as a drop-in replacement to the socket module. Seamlessly configure SOCKS proxies for any socket object by calling socket_object.set_proxy().

Features

SOCKS proxy client for Python 2.7 and 3.4+
TCP supported
UDP mostly supported (issues may occur in some edge cases)
HTTP proxy client included but not supported or recommended (you should use urllib2's or requests' own HTTP proxy interface)
urllib2 handler included. pip install / setup.py install will automatically install the sockshandler module.

Installation

pip install PySocks

Or download the tarball / git clone and...

python setup.py install

These will install both the socks and sockshandler modules.

Alternatively, include just socks.py in your project.

Warning: PySocks/SocksiPy only supports HTTP proxies that use CONNECT tunneling. Certain HTTP proxies may not work with this library. If you wish to use...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

PySocks is a SOCKS and HTTP proxy client that acts as a drop-in replacement for Python's socket module, enabling TCP and UDP traffic routing through proxy servers.

Installation is straightforward with no runtime dependencies and low friction. However, the package is abandoned—last release was 2019-09-20 and last commit 2023-07-17—so security patches and compatibility fixes will not be forthcoming.

BSD permissive license allows commercial and private use with minimal restrictions, typical of mature networking libraries.

Usage

pip install PySocks

Import the module and create a proxy socket, then call set_proxy() with proxy type and address before connecting through the proxy.

Requires a SOCKS proxy server running and accessible at the specified address and port; Python >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.* required.

Verdict: PySocks is a stable, dependency-free SOCKS proxy client for Python 2.7 and 3.4+. Its abandonment since 2019-09-20 means it will not receive security updates or compatibility fixes; use only if locked into older Python versions or if proxy functionality is non-critical to your application's security posture.

Needs verification

Whether the package remains compatible with Python 3.10+ despite classifiers only listing up to 3.6
Any known incompatibilities with modern TLS/SSL proxy configurations or SOCKS5 extensions
Whether UDP relay support is production-ready or remains experimental as described

socks proxy clienthttp proxy pythonsocket proxy wrappertcp proxy tunnelingsocks4 socks5 clientproxy socket replacementnetwork proxy routing