How to Install `httpcore` in Python

v1.0.9 Web & HTTP Python >=3.8

A minimal low-level HTTP client.

Install pip install httpcore

What is httpcore?

A minimal low-level HTTP client.

The HTTP Core package provides a minimal low-level HTTP client, which does one thing only. Sending HTTP requests.

It does not provide any high level model abstractions over the API, does not handle redirects, multipart uploads, building authentication headers, transparent HTTP caching, URL parsing, session cookie handling, content or charset decoding, handling JSON, environment based configuration defaults, or any of that Jazz.

Sending HTTP requests. Thread-safe / task-safe connection pooling. HTTP(S) proxy & SOCKS proxy support. Supports HTTP/1.1 and HTTP/2. Provides both sync and async interfaces. Async backend support for and .

PyPI page → Author: Tom Christie <tom@tomchristie.com>

Quick Start

Minimal example to get started with httpcore:

import httpcore

print(httpcore.__version__)

Installation

pip (standard)

pip install httpcore

Virtual environment (recommended)

python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install httpcore

pip3

pip3 install httpcore

conda

conda install -c conda-forge httpcore

Poetry

poetry add httpcore

Dependencies

Installing httpcore will also install these packages:

certifi h11

Verify the Installation

After installing, confirm the package is available:

python -c "import httpcore; print(httpcore.__version__)"

If this prints a version number, installation succeeded. If you see a ModuleNotFoundError, see the errors section below.

Installation Errors

Common errors when installing httpcore with pip.

ModuleNotFoundError: No module named 'httpcore'

Cause: The package is not installed in the current Python environment.

Fix: Run pip install httpcore. If using a virtual environment, ensure it is activated first.

ModuleNotFoundError: No module named 'httpcore' (installed but still failing)

Cause: pip installed the package into a different Python than the one running your script.

Fix: Use python -m pip install httpcore to install into the interpreter you are running.

ImportError: cannot import name 'X' from 'httpcore'

Cause: The function or class does not exist in the installed version.

Fix: Check the version with pip show httpcore and upgrade with pip install --upgrade httpcore.

pip: command not found

Cause: pip is not in PATH or Python was not added to PATH during installation.

Fix: Try python -m pip install httpcore. On macOS/Linux try pip3.

PermissionError: [Errno 13] Permission denied

Cause: No write access to the system Python package directory.

Fix: Use a virtual environment, or add --user: pip install --user httpcore

SSL: CERTIFICATE_VERIFY_FAILED

Cause: pip cannot verify PyPI's SSL certificate — common behind corporate proxies.

Fix: Try: pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org httpcore

ConnectionError: Failed to establish a new connection

Cause: Server unreachable, URL invalid, or firewall/proxy blocking the connection.

Fix: Verify the URL and network access. Set HTTP_PROXY / HTTPS_PROXY env vars if behind a proxy.

SSLError: CERTIFICATE_VERIFY_FAILED

Cause: The remote server's SSL certificate cannot be verified.

Fix: Update CA certificates on your system. For testing only, disable SSL verification (never in production).

Recent Releases

Version	Released
`1.0.9` latest	2025-04-24
`1.0.8`	2025-04-11
`1.0.7`	2024-11-15
`1.0.6`	2024-10-01
`1.0.5`	2024-03-27

Full release history on PyPI →

Manage httpcore

Upgrade to latest version

pip install --upgrade httpcore

Install a specific version

pip install httpcore==1.0.9

Uninstall

pip uninstall httpcore

Check what is installed

pip show httpcore

Last updated: 2026-04-11 • Data from PyPI

How to Install httpcore in Python