> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hexr.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Hexr Python SDK from the private PyPI registry.

## Requirements

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

***

## Install with uv (Recommended)

```bash theme={null}
uv pip install "hexr-sdk[cli]" --extra-index-url https://pypi.hexr.cloud/simple/
```

## Install with pip

```bash theme={null}
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:

<CodeGroup>
  ```ini pip.conf (~/.config/pip/pip.conf) theme={null}
  [global]
  extra-index-url = https://pypi.hexr.cloud/simple/
  ```

  ```toml pyproject.toml theme={null}
  [[tool.uv.index]]
  url = "https://pypi.hexr.cloud/simple/"
  ```
</CodeGroup>

***

## Verify Installation

```bash theme={null}
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:

```yaml theme={null}
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.