# Anorov/PySocks

A SOCKS proxy client and wrapper for Python.

Repository: https://github.com/Anorov/PySocks
Canonical: https://ross.abutalabs.com/products/pysocks
Language: Python
License: NOASSERTION
License Family: other
Topics: proxy, socks-proxy
Last push: 2023-07-17T05:15:25+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 5307, "days_push": 1143, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1277, forks 267 (observed 2026-08-28T04:04:13.245504+00:00)

## What it is
PySocks is a Python library that lets you route TCP (and mostly UDP) traffic through SOCKS4, SOCKS5, and HTTP CONNECT proxy servers. It acts as a drop-in replacement for the standard socket module and underpins SOCKS proxy support in libraries like requests.

## Use cases
- route python socket traffic through a socks5 proxy
- make requests use a socks proxy
- connect through tor with python
- monkeypatch python sockets to use a default proxy
- add socks4/socks5 support to a python app

## When to choose
- you need SOCKS4/SOCKS5 proxying at the socket level in Python
- you want requests to support socks5:// proxy URLs
- you need a drop-in socket.socket replacement with proxy support

## When to avoid
- you only need HTTP proxying - use your HTTP client's native proxy support
- you need reliable UDP proxying in all edge cases
- you want a maintained library with active development

## Facets
- artifact type: library
- maturity: maintenance
- function: proxy, http-client, networking
- domain: networking, privacy, developer-tools
- platform: python, cross-platform
- tags: socks-proxy, socks4, socks5, socket-wrapper, requests-integration

## Member repositories
- Anorov/PySocks (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:13.245504+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:02:48.076884+00:00, confidence not recorded.
  - readme: https://github.com/Anorov/PySocks (fetched 2026-08-28T04:04:13.245504+00:00, sha 7a78c848cd4e)
  - registry_pypi: https://pypi.org/pypi/pysocks/json (fetched 2026-08-29T12:13:36.979836+00:00, sha 624a0c23a2f2)
- Data as of 2026-08-30T08:39:29.467469+00:00.