Skip to main content
The hexr CLI is distributed as part of the hexr-sdk Python package. Installing the SDK with the [cli] extra adds the hexr command to your shell path — there is no separate binary to download or manage.

​
Install

uv pip install "hexr-sdk[cli]" --extra-index-url https://pypi.hexr.cloud/simple/
uv resolves and installs packages significantly faster than pip. If you haven’t switched yet, run pip install uv or see the uv docs.

​
Verify the installation

$ hexr --version
hexr 0.2.1

$ hexr --help
Usage: hexr [OPTIONS] COMMAND [ARGS]...

  Hexr — Identity-first runtime for AI agents.

Options:
  --verbose, -v  Verbose output
  --debug        Debug logging
  --version      Show version

Commands:
  build    Analyze agent and generate deployment artifacts
  push     Build and push container image
  deploy   Deploy agent to Kubernetes
  audit    Security audit and SBOM generation
  login    Authenticate with Hexr Cloud
  logout   Remove saved credentials
  status   Show deployed agents
  cache    Credential cache management

​
Prerequisites

Different commands require different tools. Install only what you need for your workflow.
ToolRequired forInstall
Python 3.10+CLI executionbrew install python@3.11
Dockerhexr push (local builds)docker.com
kubectlhexr deploy, hexr statusbrew install kubectl
gcloudhexr push --cloudcloud.google.com/sdk
If you’re using Hexr Cloud, hexr push --cloud and hexr deploy --cloud offload container builds and deployments to Hexr’s managed infrastructure. In that case you only need Python and the gcloud CLI authenticated to your project.