Installation

Requirements

Python 3.10+
Access to Hexr private PyPI (pypi.hexr.cloud)

Install with uv (Recommended)

uv pip install "hexr-sdk[cli]" --extra-index-url https://pypi.hexr.cloud/simple/

Install with pip

pip install "hexr-sdk[cli]" --extra-index-url https://pypi.hexr.cloud/simple/

Configure Private PyPI

To avoid passing --extra-index-url every time, add it to your pip configuration:

[global]
extra-index-url = https://pypi.hexr.cloud/simple/

[[tool.uv.index]]
url = "https://pypi.hexr.cloud/simple/"

Verify Installation

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

0.2.7

What’s Included

The hexr package includes:

Module	Dependencies
Core (`hexr_agent`, `hexr_tool`, `hexr_llm`)	`opentelemetry-api`, `opentelemetry-sdk`, `grpcio`
`hexr.vault`	`httpx`
`hexr.gateway`	`httpx`
`hexr.sandbox`	`httpx`
`hexr.browser`	`httpx`
`hexr.guard`	`httpx`
`hexr.a2a`	`httpx`, `pydantic`

Core dependencies are minimal. Lazy-loaded modules only import their dependencies when first accessed.

In Kubernetes (Automatic)

When you hexr deploy, the SDK is installed automatically via an init container:

initContainers:
  - name: install-hexr-sdk
    image: python:3.11-slim
    command: ["pip", "install", "--target=/shared/site-packages", "hexr"]
    env:
      - name: PIP_INDEX_URL
        value: "https://pypi.hexr.cloud/simple/"

You don’t need to include hexr in your agent’s requirements.txt — it’s injected at deployment time.

SDK Overview

Decorators & Functions

Modules

Installation

Requirements

Install with uv (Recommended)

Install with pip

Configure Private PyPI

Verify Installation

What’s Included

In Kubernetes (Automatic)

​Requirements

​Install with uv (Recommended)

​Install with pip

​Configure Private PyPI

​Verify Installation

​What’s Included

​In Kubernetes (Automatic)

Requirements

Install with uv (Recommended)

Install with pip

Configure Private PyPI

Verify Installation

What’s Included

In Kubernetes (Automatic)