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.

Filename, size & hash SHA256 hash help File type Python version Upload date
Ermes-0.1a.tar.gz (2.7 kB) Copy SHA256 hash SHA256 Source None Jan 19, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page