Skip to main content
Get from zero to your first Holo request in three steps. If you want the model lineup, capabilities, and pricing first, see Models; for what Holo is and the ways to use it, see the overview.

​
Get started

1

Get an API key

Generate a key on Portal-H and export it. The free tier gives rate-limited access to holo3-1-35b-a3b and does not ask for a credit card.
export HAI_API_KEY="your-api-key-here"
2

Install the OpenAI client

The Models API is OpenAI-compatible, so the official client works as-is, only the base_url changes.
pip install openai

npm install openai
3

Make your first request

Point the client at H by overriding base_url, then send a request. Holo is multimodal: you can send text, images, or both. Here is a minimal text request to confirm your key and client are working.
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.hcompany.ai/v1/",
    api_key=os.environ.get("HAI_API_KEY"),
)

response = client.chat.completions.create(
    model="holo3-1-35b-a3b",
    messages=[{"role": "user", "content": "In one sentence, what is a computer-use agent?"}],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.hcompany.ai/v1/",
  apiKey: process.env.HAI_API_KEY,
});

const response = await client.chat.completions.create({
  model: "holo3-1-35b-a3b",
  messages: [{ role: "user", content: "In one sentence, what is a computer-use agent?" }],
});

console.log(response.choices[0].message.content);

curl https://api.hcompany.ai/v1/chat/completions \
  -H "Authorization: Bearer $HAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "holo3-1-35b-a3b",
    "messages": [{"role": "user", "content": "In one sentence, what is a computer-use agent?"}]
  }'
The same API and code paths work for all models; swap model for holo3-122b-a10b when you need maximum performance (model comparison).That is the whole setup. To use Holo on real screens, send a screenshot and continue with the agent loop or element localization below.

​
Next steps

Agent loop

How to use Holo in your computer-use harness.

Element localization

Get click coordinates from a screenshot.

Models

IDs, limits, pricing, and lifecycle.