Installation

pip install bolder-ai

Requirements

• Python 3.9 or newer (tested through 3.13)
• Network access to https://ai-gateway.bolder.services (or your self-hosted gateway URL)

The only hard dependency is httpx. Optional extras pull in provider SDKs for auto-wrapping.

Optional extras

Install extras for the providers you use — they’re not required for the core SDK.

pip install 'bolder-ai[openai]'       # enables beval.wrap(OpenAI())
pip install 'bolder-ai[anthropic]'    # enables beval.wrap(Anthropic())
pip install 'bolder-ai[all]'          # both

If you already have openai or anthropic installed as direct dependencies, you can use beval.wrap(...) without the extra — the extras are a convenience.

Package manager notes

uv

uv add bolder-ai
uv add 'bolder-ai[openai]'

Poetry

poetry add bolder-ai
poetry add bolder-ai --extras openai

pip with constraints

The SDK follows semver. Pin a minor version if you want patch updates but no breaking changes:

bolder-ai~=0.1

Distribution name vs. import name

import beval  # not "bolder_ai"

This is intentional — bolder-ai is the shipping identity, beval is the product it plugs into. Tooling that reads pyproject.toml will see bolder-ai; your code reads beval.

Verify the install

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

Expected output: 0.1.0 (or newer).

Upgrading

pip install --upgrade bolder-ai

See the Changelog for breaking changes between versions.