---
id: pysocks
version: "1.7.1"
license: BSD
license_treatment: permissive
maintenance: abandoned
---

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

License: permissive · Maintenance: abandoned · Popularity: top 1,000 on PyPI

## Install

pip install pysocks
uv add pysocks
poetry add pysocks

## Description

PySocks
=======

PySocks lets you send traffic through SOCKS and HTTP proxy servers. It is a modern fork of [SocksiPy](http://socksipy.sourceforge.net/) 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...

## AI interpretation — verify before relying

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.

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.

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