---
id: socksio
version: "1.0.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# socksio — Sans-I/O implementation of SOCKS4, SOCKS4A, and SOCKS5.

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

## Install

pip install socksio
uv add socksio
poetry add socksio

## Description

# SOCKSIO

[![Build Status](https://travis-ci.org/sethmlarson/socksio.svg?branch=master)](https://travis-ci.org/sethmlarson/socksio)
[![codecov](https://codecov.io/gh/sethmlarson/socksio/branch/master/graph/badge.svg)](https://codecov.io/gh/sethmlarson/socksio)
[![Supported Python Versions](https://img.shields.io/pypi/pyversions/socksio.svg)](https://pypi.org/project/socksio)
[![PyPI](https://img.shields.io/pypi/v/socksio.svg)](https://pypi.org/project/socksio)

Client-side sans-I/O SOCKS proxy implementation.
Supports SOCKS4, SOCKS4A, and SOCKS5.

`socksio` is a sans-I/O library similar to
[`h11`](https://github.com/python-hyper/h11) or
[`h2`](https://github.com/python-hyper/hyper-h2/), this means the library itself
does not handle the actual sending of the bytes through the network, it only
deals with the implementation details of the SOCKS protocols so you can use
it in any I/O library you want.

## Current status: stable

Features not yet implemented:

- SOCKS5 GSS-API authentication.
- SOCKS5 UDP associate requests.

## Usage

TL;DR check the [examples directory](examples/).

Being sans-I/O means that in order to test `socksio` you need an I/O library.
And the most basic...

## AI interpretation — verify before relying

A sans-I/O library implementing SOCKS4, SOCKS4A, and SOCKS5 proxy protocols, letting you build SOCKS clients with any I/O library by handling protocol details separately from network I/O.

Verdict: A stable, zero-dependency sans-I/O SOCKS implementation suitable for integrating proxy support into any async or sync I/O framework. MIT-licensed, actively maintained, and free of known vulnerabilities. Best for developers building proxy-aware clients who want protocol handling decoupled from network I/O.

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