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

> ## Agent Instructions
> H Platform has four products: the Agents API (managed computer-use agents, base URL https://agp.eu.hcompany.ai/api/v2 or https://agp.hcompany.ai/api/v2 for the US), the Models API (OpenAI-compatible Holo vision-language models at https://api.hcompany.ai/v1), HoloDesktop CLI (Holo on the user's own desktop), and HoloTab (a free no-code Chrome extension that runs Holo in the user's browser, with recordable routines and schedules).
> Authenticate with a bearer API key from the HAI_API_KEY environment variable. SDKs: `pip install hai-agents` (Python, `from hai_agents import Client`) and `npm install hai-agents` (TypeScript, `import { HaiAgentsClient } from "hai-agents"`). CLI: `hai`.
> Agents do work in a browser or on a desktop; describe the task as an imperative instruction. To run a task quickly, prefer the pre-built agent `h/web-surfer-flash`. Read results from the session's `latest_answer` after it reaches a terminal status.
> Sessions are the unit of work; wait for a terminal status (completed, failed, timed_out, interrupted) before reading the answer. Use webhooks or the `changes` long-poll endpoint to follow progress.

# Environment variables

> Every environment variable HoloDesktop CLI and hai-agent-runtime read: API key, local model endpoint, port, token, runs dir, download overrides.

Most users only need `HAI_API_KEY` for hosted mode or `HAI_AGENT_RUNTIME_BASE_URL` for local mode (see [Hosted or local models](/holo-desktop-cli/getting-started/hosted-or-local-models)). The rest are useful for host integrations, debugging, or advanced runtime control.

## Model and credentials

| Variable | Purpose |
| - | - |
| `HAI_API_KEY` | Hosted-mode API key for H's Models API. |
| `HAI_AGENT_RUNTIME_BASE_URL` | OpenAI-compatible local model endpoint, such as `http://localhost:8000/v1`. |
| `HAI_AGENT_RUNTIME_MODEL` | Model ID passed to the runtime, such as `holo3-1-35b-a3b`. |

`holo login` stores `HAI_API_KEY` in:

```text theme={"system"}
~/.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

| Variable | Purpose |
| - | - |
| `HAI_AGENT_RUNTIME_PORT` | Agent API port. Defaults to `18795`. |
| `HAI_AGENT_RUNTIME_API_TOKEN` | Bearer token for the loopback agent API. If unset, the client generates one for spawned runtimes. |
| `HAI_AGENT_RUNTIME_RUNS_DIR` | Runtime event-log directory. If unset, the runtime default is `~/.holo/runs`. |

GUI-launched hosts do not inherit shell exports, so set model variables in the host's own config. See [Local mode from hosts](/holo-desktop-cli/getting-started/hosted-or-local-models#local-mode-from-hosts) and the MCP `env` block in [Agent hosts](/holo-desktop-cli/integrations/agent-hosts#connect-over-mcp).

## Runtime download overrides

These are for operations or trusted development builds:

| Variable | Purpose |
| - | - |
| `HAI_AGENT_RUNTIME_DOWNLOAD_URL` | Override the managed runtime download URL. |
| `HAI_AGENT_RUNTIME_DOWNLOAD_SHA256` | Required sha256 when `HAI_AGENT_RUNTIME_DOWNLOAD_URL` is set. |

HoloDesktop CLI refuses an unverified download URL. Set both values or neither.

## Next steps

<CardGroup cols={2}>
  <Card title="Hosted or local models" icon="server" href="/holo-desktop-cli/getting-started/hosted-or-local-models">
    Where these variables are set in practice.
  </Card>

  <Card title="Paths and files" icon="folder" href="/holo-desktop-cli/reference/paths-and-files">
    Where the CLI stores keys, runs, and the runtime.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.