httpcore

Common errors

Warnings

Install

Install compatibility verified last tested: 2026-05-12

Imports

• httpcore

  import httpcore

  All public API is exposed at the top-level httpcore namespace

• ConnectionPool
  wrong

  http = httpcore.SyncConnectionPool()

  correct

  import httpcore
  http = httpcore.ConnectionPool()

  SyncConnectionPool was the pre-1.0 name; use ConnectionPool in 1.x

• AsyncConnectionPool

  import httpcore
  http = httpcore.AsyncConnectionPool()

  Requires httpcore[asyncio] or httpcore[trio] to be installed

• HTTPProxy

  import httpcore
  proxy = httpcore.HTTPProxy(proxy_url='http://proxy:8080')

  Use proxy= kwarg on ConnectionPool() since 1.0.7 instead of wrapping manually

• request (top-level function)

  import httpcore
  response = httpcore.request('GET', 'https://example.com')

  Convenience function only; does not pool connections — use ConnectionPool for production

Quickstart stale last tested: 2026-04-23

Demonstrates the one-off request helper, the recommended ConnectionPool pattern, streaming, and async usage.

import httpcore

# One-off request (no connection reuse)
response = httpcore.request('GET', 'https://httpbin.org/get')
print(response.status)   # int, e.g. 200
# Headers are List[Tuple[bytes, bytes]] — decode explicitly
for name, value in response.headers:
    print(name.decode(), value.decode())
print(response.content)  # bytes

# Production pattern: reuse a ConnectionPool
with httpcore.ConnectionPool() as http:
    r = http.request('GET', 'https://httpbin.org/get')
    print(r.status)

# Streaming large response
with httpcore.stream('GET', 'https://httpbin.org/stream-bytes/1024') as r:
    for chunk in r.iter_stream():
        pass  # process chunk (bytes)

# Async (requires: pip install 'httpcore[asyncio]')
import asyncio

async def main():
    async with httpcore.AsyncConnectionPool() as http:
        r = await http.request('GET', 'https://httpbin.org/get')
        print(r.status)

asyncio.run(main())