---
id: types-pysocks
version: "1.7.1.20260518"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-PySocks — Typing stubs for PySocks

License: permissive · Maintenance: active · Downloads: 583.7K/mo

## What it is and what it does

types-pysocks is a type stub package that bridges the gap between the PySocks SOCKS proxy library and static type checkers. It provides type annotations for PySocks so that tools like mypy and pyright can understand and validate how you're using the library in your code, catching type errors before runtime.

The stubs are generated and maintained as part of the typeshed project, which is the canonical repository for type information for the Python standard library and popular third-party packages. This package is a thin distribution layer that makes those stubs available via pip. It has no runtime dependencies and is designed purely to support development-time type checking.

Use it for:

- Enable mypy or pyright to type-check code that imports and uses PySocks for SOCKS proxy connections
- Catch type mismatches in proxy configuration or socket operations before running code
- Integrate PySocks into a typed Python project without disabling type checking for that module
- Validate correct usage of PySocks API when refactoring or adding new proxy functionality

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for PySocks, enabling static type checkers like mypy and pyright to validate code using the PySocks SOCKS proxy library.

Yes, if you use PySocks and want static type checking. Install it alongside your type checker (mypy or pyright) to get accurate type validation for PySocks code. It has no runtime cost and is actively maintained. If you don't use a type checker or don't use PySocks, there's no reason to install it.

## Install

pip install types-pysocks
uv add types-pysocks
poetry add types-pysocks

## Installing types-PySocks

Before you install: Low friction installation with no runtime dependencies. Actively maintained as part of typeshed, with recent releases and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows use in most projects without restriction.

Quickstart:

pip install types-pysocks

# Then use with your type checker in your project
# mypy or pyright will automatically discover the stubs when checking code that imports PySocks

Requires Python 3.10 or later. Stubs are only useful when used alongside a type checker (mypy 2.1.0, pyright 1.1.409, or compatible).

Verify before relying:

- Whether stubs remain accurate for PySocks versions other than 1.7.1
- Compatibility with type checkers beyond mypy 2.1.0 and pyright 1.1.409

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 583.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs pysocks, pysocks type hints, mypy pysocks annotations, static typing socks proxy, pyright pysocks types, type checking proxy library, type-stubs, static-typing

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