Skip to main content

Socks5 proxy client for Python

Project description


Ermes is a socks5 implementation for Python (3.X only), the usage is quite straightforward.

from ermes import Socks5Proxy, Socks5Error
import socket

proxy = Socks5Proxy(("", 1080),
    username="the username no more than 255 chars or None",
    password="the password no more than 255 chars or None",
sock = socket.socket()
# use proxy.connect(sock, address)
# instead of sock.connect(address),
proxy.connect(sock, ("", 80))

# just do anything like a usual socket with `sock`


  • Authentication support is limited, only 0x00 (No auth) and 0x02 (username/password) is supported
  • Only command code 0x01 (TCP/IP stream) is supported
  • No IPv6 support
  • SOCKS5 only

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Ermes, version 0.1a
Filename, size File type Python version Upload date Hashes
Filename, size Ermes-0.1a.tar.gz (2.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page