httpx

name	httpx
description	httpx — modern Python HTTP client with sync + async APIs, HTTP/2, strict timeouts, and a broadly requests-compatible surface. Use when: httpx, python httpx, AsyncClient, Client, httpx.get, async http client, requests replacement, HTTP/2 python, follow_redirects, raise_for_status, MockTransport, respx, pytest-httpx, ASGITransport, requests migration, async aiohttp alternative, BasicAuth, DigestAuth, custom Auth flow, streaming download, http2=True, connection pool. SKIP: requests (legacy sync-only, →requests-legacy); aiohttp (different ecosystem); urllib3 low-level; Node fetch (→nodejs).
stacks	["httpx","python"]
tags	["http-client","python","async","networking"]
packages	["httpx","h2","respx","pytest-httpx"]
manifests	["pyproject.toml"]
source	vechkasov-global-skills
risk	medium-stakes

🎯 Version Requirements (May 2026)

Primary pins:

• httpx: 0.28.x
• Python: 3.14.x

Source of truth: STACK_VERSIONS.md — verified 2026-05-16

Usage

Loaded automatically when its description matches the active task. Read only the section you need.

Use this skill when

• Calling external HTTP APIs from Python — REST, JSON, multipart, streaming
• Replacing requests in a project — Session → Client, allow_redirects → follow_redirects, exception hierarchy changes
• Writing async code that talks to multiple upstreams concurrently with AsyncClient + asyncio.gather
• Sharing a long-lived HTTP client across a FastAPI / Starlette / worker process (connection pooling)
• Testing a FastAPI app via httpx.AsyncClient(transport=ASGITransport(app=app)) — in-memory, no port
• Mocking HTTP in tests — MockTransport, respx, or pytest-httpx
• Enabling HTTP/2 multiplexing for high-concurrency clients (http2=True + h2 extra)
• Tuning timeouts (connect, read, write, pool), proxies, mTLS, custom SSL context
• Building custom auth — bearer tokens, OAuth2 refresh, request-signing — via the httpx.Auth flow API
• Adding retry/backoff around an httpx call (via tenacity or stamina — httpx itself has no built-in retry)
• Streaming large downloads or uploads — iter_bytes, iter_lines, aiter_*, file-like upload, SSE

Do not use this skill when

• Project still uses requests and you only want a one-off fix — use requests-legacy (cascade)
• Project is on aiohttp and not migrating — different ecosystem
• Task is low-level connection / TLS work below httpx — use urllib3 or node:tls directly
• The HTTP call is inside a Node service — use , , or skills