Configuration - H Platform Docs

Most users need only holo login, or HAI_AGENT_RUNTIME_BASE_URL and HAI_AGENT_RUNTIME_MODEL to run the model yourself. The rest is for agent hosts, debugging, and custom runtimes.

Environment variables

Variable	Purpose
`HAI_API_KEY`	API key for H’s hosted models.
`HAI_AGENT_RUNTIME_BASE_URL`	Your OpenAI-compatible model server, such as `http://localhost:8000/v1`. Same as `holo run --base-url`.
`HAI_AGENT_RUNTIME_MODEL`	Model ID, such as `holo4-35b-a3b`. Same as `holo run --model`. Required with `HAI_AGENT_RUNTIME_BASE_URL`.
`HAI_AGENT_RUNTIME_PORT`	Loopback port of the runtime. Defaults to `18795` for hosted inference; each self-hosted server and model gets its own port.
`HAI_AGENT_RUNTIME_API_TOKEN`	Bearer token for the runtime. Generated when unset.
`HAI_AGENT_LOCAL_BINARY_PATH`	Run this `hai-agent-runtime` executable.
`HAI_AGENT_LOCAL_CACHE_DIR`	Runtime cache. Defaults to `~/.hai/agent-runtime`.
`HAI_AGENT_RUNTIME_DOWNLOAD_URL`, `HAI_AGENT_RUNTIME_DOWNLOAD_SHA256`	Download a trusted runtime build. Set both or neither.

HAI_API_KEY is read from, in order: the process environment, ~/.holo/.env, .env in the current directory, then ~/.config/hai/.env. XDG_CONFIG_HOME, when set, replaces ~/.config. Apps launched from the Dock or Start menu do not inherit shell exports, so set variables for agent hosts in the host’s MCP env block. See Agent hosts.

Files

~/.config/hai/ and ~/.hai/agent-runtime/ are shared with the hai-agents SDK and the hai CLI. Treat all of these as sensitive.

Path	Purpose
`~/.config/hai/.env`	API key saved by `holo login`.
`~/.config/hai/stop`	Stop request written by `holo stop` and the double-`Esc` kill switch. A task obeys only a stop filed after it started.
`~/.config/hai/desktop.lock`	Held by the agent driving the desktop, so one runs at a time.
`~/.holo/agents.md`, `memories.md`, `rules.md`, `holo-memories.md`	Instructions loaded into every run. See Customize.
`~/.holo/skills/`	Skills, bundled and your own.
`~/.holo/settings.json`	Which bundled skills were seeded.
`~/.holo/.env`	Older key location. Still read, and cleared by `holo logout`.
`~/.holo/logs/holo-guard.log`	Kill-switch errors on macOS.
`~/.hai/agent-runtime/logs/hai-agent-runtime-<port>.log`	Runtime startup and error log.
`~/.hai/agent-runtime/state/agent-token-<port>`	Owner-only token so local clients can share a runtime. Removed when the runtime stops.
`~/.hai/agent-runtime/state/agent-inference-<port>`	What that runtime infers against, so a client never attaches to one serving another model.
`~/Library/LaunchAgents/ai.hcompany.holo.guard.plist`	macOS: starts the kill switch at login.
`holo-guard.cmd` in your Startup folder	Windows: starts the kill switch at login.
`~/.config/autostart/holo-guard.desktop`	Linux: starts the kill switch at graphical login.

Runtime

The runtime is resolved in this order:

HAI_AGENT_LOCAL_BINARY_PATH;
hai-agent-runtime on PATH;
the managed install under ~/.hai/agent-runtime/bin/<version>/;
a sha256-verified download of the pinned version.

holo doctor shows which one it will use. On platforms without a published runtime, put your own hai-agent-runtime on PATH.