requests-unixsocket2
Use requests to talk HTTP via a UNIX domain socket
Decision gist · record as of 2026-08-14
Yes, if you need to make HTTP requests to services listening on UNIX domain sockets (Docker, systemd, etc.) and want to reuse the familiar requests API. The low install friction and permissive license make it a straightforward choice. The aging maintenance status is not a blocker for this narrow, stable use case, but verify that the fork's divergence from the original project meets your needs.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >=3.9
- Low friction installation with only requests and urllib3 as runtime dependencies.
- Marked as aging (345 days since last release), so maintenance activity is limited but the package remains functional for its narrow use case.
License · maintenance · safety
ISC (permissive) — ISC license is permissive and imposes minimal restrictions; you can use, modify, and distribute this package freely in commercial and private projects.
last release 2025-09-03 (345 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 513,354 downloads/mo, #6,247 on PyPI
Alternatives
Verify before relying
pip install requests-unixsocket2
import requests_unixsocket
session = requests_unixsocket.Session()
r = session.get('http+unix://%2Fvar%2Frun%2Fdocker.sock/info')
print(r.status_code)- Whether abstract namespace socket support (Linux-only feature) works reliably across different kernel versions
- Current state of the upstream origin project and how this fork diverges from it
What it is and what it does
requests-unixsocket2 is a thin adapter that teaches the requests HTTP library to communicate over UNIX domain sockets instead of TCP connections. This is useful for talking to services that listen on local sockets—like the Docker daemon on /var/run/docker.sock—without needing a separate HTTP client library or lower-level socket code.
You can use it two ways: instantiate a special Session object and call methods on it, or monkeypatch the requests module globally (or temporarily via context manager) to make standard requests.get() and similar calls work with socket URLs. It supports both regular UNIX sockets and Linux abstract namespace sockets (prefixed with a NULL byte). The package depends only on requests and urllib3, so installation is straightforward.
Use it for
- Query the Docker daemon API by connecting to /var/run/docker.sock without spawning a subprocess
- Communicate with system services that expose HTTP-like APIs over UNIX sockets
- Build tools that interact with local socket-based services while reusing existing requests-based code
- Test HTTP clients against mock services listening on abstract namespace sockets in CI/CD pipelines
- Avoid network overhead and port conflicts by using UNIX sockets for inter-process HTTP communication
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to make HTTP requests to services listening on UNIX domain sockets (Docker, systemd, etc.) and want to reuse the familiar requests API.
The low install friction and permissive license make it a straightforward choice. The aging maintenance status is not a blocker for this narrow, stable use case, but verify that the fork's divergence from the original project meets your needs.
Install
requests-unixsocket2 on PyPI
Before you install
Low friction installation with only requests and urllib3 as runtime dependencies. Marked as aging (345 days since last release), so maintenance activity is limited but the package remains functional for its narrow use case.
Requires Python >=3.9
License in practice
ISC license is permissive and imposes minimal restrictions; you can use, modify, and distribute this package freely in commercial and private projects.
Quickstart
pip install requests-unixsocket2
import requests_unixsocket
session = requests_unixsocket.Session()
r = session.get('http+unix://%2Fvar%2Frun%2Fdocker.sock/info')
print(r.status_code)Verify before relying
- Whether abstract namespace socket support (Linux-only feature) works reliably across different kernel versions
- Current state of the upstream origin project and how this fork diverges from it
Package facts
| License | ISC permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesrequestsurllib3 |
| Maintenance | Aging 345 days since the last release |
| First released | |
| Downloads | 513,354 / month, #6,247 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersIntended Audience :: Information TechnologyLicense :: OSI Approved :: ISC License (ISCL)Operating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3 |
Evidence: requests_unixsocket2-1.0.1-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 › “http over unix socket”
- requests-unixsocket2Extends the requests library to make HTTP calls over UNIX domain…
- requests-unixsocketExtends the requests library to make HTTP calls over UNIX domain…
- clamav-clientA Python client library for the ClamAV antivirus engine that connects…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also requests-unixsocket · manhole · requests-ntlm2 · requests-ntlm3 · PySocks · httpie · requests-mock · httpx-socks · hyper-up