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

​
Model and credentials

holo login stores HAI_API_KEY in:
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

GUI-launched hosts do not inherit shell exports, so set model variables in the host’s own config. See Local mode from hosts and the MCP env block in Agent hosts.

​
Runtime download overrides

These are for operations or trusted development builds: HoloDesktop CLI refuses an unverified download URL. Set both values or neither.

​
Next steps

Hosted or local models

Where these variables are set in practice.

Paths and files

Where the CLI stores keys, runs, and the runtime.