Skip to main content
Most users only need HAI_API_KEY for hosted mode or HAI_AGENT_RUNTIME_BASE_URL for local mode. The rest are useful for host integrations, debugging, or advanced runtime control.

​
Model And Credentials

VariablePurpose
HAI_API_KEYHosted-mode API key for H Company’s Models API.
HAI_AGENT_RUNTIME_BASE_URLOpenAI-compatible local model endpoint, such as http://localhost:8000/v1.
HAI_AGENT_RUNTIME_MODELModel ID passed to the runtime, such as Hcompany/Holo-3.1-35B-A3B.
holo login stores HAI_API_KEY in: 
~/.holo/.env
The client loads environment in this order:
  1. process environment;
  2. ~/.holo/.env;
  3. .env in the current working directory.
Process environment wins over files.

​
Runtime

VariablePurpose
HAI_AGENT_RUNTIME_PORTAgent API port. Defaults to 18795.
HAI_AGENT_RUNTIME_API_TOKENBearer token for the loopback agent API. If unset, the client generates one for spawned runtimes.
HAI_AGENT_RUNTIME_RUNS_DIRRuntime event-log directory. If unset, the runtime default is ~/.holo/runs.
HAI_AGENT_RUNTIME_FAKETest mode flag. Values 1, true, or yes enable fake-agent mode.
For host integrations, set model variables in the host’s configuration if the host is launched from a GUI and does not inherit your shell exports. Example MCP environment: 
{
  "mcpServers": {
    "holo": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/holo-desktop", "holo", "mcp"],
      "env": {
        "HAI_AGENT_RUNTIME_BASE_URL": "http://localhost:8000/v1",
        "HAI_AGENT_RUNTIME_MODEL": "Hcompany/Holo-3.1-35B-A3B"
      }
    }
  }
}

​
Runtime Download Overrides

These are for tests, operations, or trusted development builds:
VariablePurpose
HAI_AGENT_RUNTIME_DOWNLOAD_URLOverride the managed runtime download URL.
HAI_AGENT_RUNTIME_DOWNLOAD_SHA256Required sha256 when HAI_AGENT_RUNTIME_DOWNLOAD_URL is set.
HoloDesktop CLI refuses an unverified download URL. Set both values or neither.

​
Development And Tests

Some repository tests use opt-in variables such as HOLO_RUN_INTEGRATION, HOLO_IT_BASE_URL, and HOLO_IT_MODEL. These are test harness variables, not end-user configuration. For normal local model use, prefer: 
uv run holo run \
  --base-url http://localhost:8000/v1 \
  --model Hcompany/Holo-3.1-35B-A3B \
  "Open TextEdit and write a short note saying HoloDesktop CLI is installed"
For host-launched stdio servers, use: 
export HAI_AGENT_RUNTIME_BASE_URL=http://localhost:8000/v1
export HAI_AGENT_RUNTIME_MODEL=Hcompany/Holo-3.1-35B-A3B