Install RouteHub

Prerequisites

Python 3.10 or higher
An API key for at least one provider, or a local server such as Ollama

Install the package

pip install -U routehub

uv add routehub

poetry add routehub

git clone https://github.com/The-Swarm-Corporation/RouteHub.git
cd RouteHub
pip install -e .

RouteHub has three direct dependencies: openai, pydantic and tiktoken. It works with openai 2.x and 3.x.

Faster JSON with the `fast` extra

The fast extra installs orjson, which RouteHub uses for JSON encoding and decoding when it is available.

pip install "routehub[fast]"

uv add "routehub[fast]"

Set ROUTEHUB_USE_ORJSON=0 to fall back to the standard json module without uninstalling orjson.

Set a provider key

RouteHub reads each provider’s key from its environment variable on every call. Set the ones you need:

export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."
export GROQ_API_KEY="gsk_..."

You can also pass api_key= to any call. See Providers for every variable name.

Keep keys in a .env file or a secrets manager and never commit them. RouteHub never writes keys to logs, including with set_verbose=True.

Verify the install

mock_response returns a real ChatCompletion without a network call or an API key, so you can check the install offline:

import routehub

print(routehub.__version__)

response = routehub.completion(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "ping"}],
    mock_response="pong",
)
print(response.choices[0].message.content)  # pong

Getting Started

Guides

Reference

Install RouteHub

Prerequisites

Install the package

Faster JSON with the `fast` extra

Set a provider key

Verify the install

Next steps

Quickstart

Configuration

​Prerequisites

​Install the package

​Faster JSON with the fast extra

​Set a provider key

​Verify the install

​Next steps

Quickstart

Configuration

Prerequisites

Install the package

Faster JSON with the `fast` extra

Set a provider key

Verify the install

Next steps