SocketSwap
SocketSwap is a python package that allows to proxy any third-party libraries traffic through a local TCP Proxy
Decision gist · record as of 2026-08-14
Yes, if you have a specific need to proxy a library that lacks native proxy support and you accept the maintenance risk. The package is simple, has no dependencies, and carries a permissive license. However, dormancy (last update 2024-01-15, only 2 stars) means you should verify it works with your target library and Python version before relying on it in production, and be prepared to fork or patch it if issues arise.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a working SOCKS5 proxy server already running and accessible at the address you specify.
- Installation is straightforward with no runtime dependencies.
- The package is dormant—last updated 2024-01-15 with only 2 repository stars—so expect no active maintenance or bug fixes.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute SocketSwap freely in commercial or private projects with minimal restrictions.
last release 2023-09-29 (1050 days) · last repo commit 2024-01-15 · 2 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 468,812 downloads/mo, #6,491 on PyPI
Alternatives
Verify before relying
from SocketSwap import ProxySwapContext
import socket
def socket_factory():
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.connect(("localhost", 5432))
return s
with ProxySwapContext(socket_factory, "127.0.0.1", 2222):
# traffic now proxied through 127.0.0.1:2222
pass- Whether the package works reliably with modern Python versions beyond 3.5, given classifiers list only 3.4 and 3.5.
- Whether the package handles concurrent connections or is limited to single-threaded use.
- Real-world stability and edge-case handling given the minimal repository activity and low star count.
What it is and what it does
SocketSwap is a Python proxy wrapper that intercepts socket connections from third-party libraries and routes them through a local TCP SOCKS5 proxy. It solves the problem of adding proxy support to libraries that don't natively provide it—useful when you need to tunnel traffic through a corporate proxy, VPN, or other intermediary without modifying the library code itself.
The package offers two usage modes: a context manager that runs the proxy in a daemon process, or a direct blocking script. It has no runtime dependencies and installs cleanly. However, it is dormant—the last release was 2023-09-29 and the last commit 2024-01-15—so it receives no active maintenance, and the repository has minimal adoption (2 stars).
Use it for
- Proxy database client connections (e.g., psycopg2, pymongo) through a corporate firewall or VPN.
- Route third-party library HTTP/HTTPS traffic through a SOCKS5 proxy without modifying library code.
- Test applications behind a proxy by intercepting and redirecting socket connections in a test harness.
- Tunnel non-Python native libraries' network traffic through a proxy in mixed-language environments.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you have a specific need to proxy a library that lacks native proxy support and you accept the maintenance risk.
The package is simple, has no dependencies, and carries a permissive license. However, dormancy (last update 2024-01-15, only 2 stars) means you should verify it works with your target library and Python version before relying on it in production, and be prepared to fork or patch it if issues arise.
Install
socketswap on PyPI
Before you install
Installation is straightforward with no runtime dependencies. The package is dormant—last updated 2024-01-15 with only 2 repository stars—so expect no active maintenance or bug fixes.
Requires a working SOCKS5 proxy server already running and accessible at the address you specify.
License in practice
MIT license is permissive; you can use, modify, and distribute SocketSwap freely in commercial or private projects with minimal restrictions.
Quickstart
from SocketSwap import ProxySwapContext
import socket
def socket_factory():
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.connect(("localhost", 5432))
return s
with ProxySwapContext(socket_factory, "127.0.0.1", 2222):
# traffic now proxied through 127.0.0.1:2222
passVerify before relying
- Whether the package works reliably with modern Python versions beyond 3.5, given classifiers list only 3.4 and 3.5.
- Whether the package handles concurrent connections or is limited to single-threaded use.
- Real-world stability and edge-case handling given the minimal repository activity and low star count.
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 1,050 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 468,812 / month, #6,491 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: POSIX :: LinuxProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.4Programming Language :: Python :: 3.5 |
Evidence: SocketSwap-0.1.11-py2.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 › “python socks5 proxy wrapper”
- SocketSwapSocketSwap intercepts and redirects network traffic from third-party…
- PySocksPySocks provides a SOCKS and HTTP proxy client that acts as a drop-in…
- python-socksProvides SOCKS4(a), SOCKS5(h), and HTTP CONNECT proxy client…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also hass-web-proxy-lib · PySocks · mitmproxy-windows · pproxy · asysocks · googlenewsdecoder · python-socks · httpx-socks · aiohttp_socks · websockify