types-PySocks
Typing stubs for PySocks
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- 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).
- Low friction installation with no runtime dependencies.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in most projects without restriction.
last release 2026-05-18 (88 days) · last repo commit 2026-08-14 · 37 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 583,727 downloads/mo, #5,891 on PyPI
Alternatives
Verify before relying
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- 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
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 on this page. Verify before relying on it.
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
types-pysocks on PyPI
Before you install
Low friction installation with no runtime dependencies. Actively maintained as part of typeshed, with recent releases and no known vulnerabilities.
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).
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 PySocksVerify 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 the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 88 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 583,727 / month, #5,891 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Typing :: Stubs Only |
Evidence: types_pysocks-1.7.1.20260518-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 › “type stubs pysocks”
- types-PySocksProvides type stubs for PySocks, enabling static type checkers like…
- PySocksPySocks provides a SOCKS and HTTP proxy client that acts as a drop-in…
- types-assertpyProvides type stubs enabling static type checkers like mypy and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also types-mock · types-toml · types-protobuf · types-assertpy · types-python-http-client · types-cffi · types-mypy-extensions · types-pysftp · types-polib · types-ldap3