hai-agents 0.1.6

Python SDK for H Company's Agent API: autonomous agents powered by Holo.

Python SDK for the H Company Agent API. Launch autonomous agents powered by Holo, stream their progress, and steer them mid-run.

Documentation  ·  Get an API key  ·  PyPI  ·  TypeScript SDK  ·  H Company

Installation

pip install hai-agents

Install the optional command-line entry point when you want local tools:

pip install "hai-agents[cli]"

Requires Python 3.10 or newer. Grab an API key at portal.hcompany.ai and export it:

export H_API_KEY=hk-...

Quickstart

Launch the built-in h/web-surfer-holo3-1-35b agent, which ships with its own browser, and describe the task in plain language. run_session polls until the agent finishes and returns the final answer.

from hai_agents import Client, run_session

client = Client()  # reads H_API_KEY from the environment

result = run_session(
    client,
    agent="h/web-surfer-holo3-1-35b",
    messages="What are the top 3 stories on Hacker News right now?",
)

print(result.status)  # "completed"
print(result.answer)

An AsyncClient mirrors this API for asyncio.

CLI

The hai-agents[cli] extra installs the hai command:

hai login                  # browser sign-in; stores a key in ~/.config/hai/.env
hai run "Summarize the H Agent API quickstart"
hai --json run "Reply with exactly: hello" --max-steps 3 --max-time 60
hai sessions list
hai sessions get <session-id>
hai sessions send <session-id> "continue"
hai sessions cancel <session-id>
hai sessions share <session-id>
hai mcp install            # wire the hai-agents MCP server into every detected editor
hai mcp install list       # see supported clients (Cursor, VS Code, Claude Code, Windsurf)

hai mcp install adds the remote hai-agents MCP server to your local editors and writes your API key into each client config (in plaintext, so keep them private). On clients that support agent skills (Cursor, Claude Code) it also symlinks a SKILL.md that teaches the model how to drive the server.

hai login opens your browser, mints a per-machine API key, and writes it to ~/.config/hai/.env. hai whoami shows the resolved endpoint and whether you are authenticated; hai logout removes the stored key.

Credentials resolve from flags, then HAI_API_KEY/H_API_KEY in the environment, then a local .env, then ~/.config/hai/.env. Use --base-url or HAI_API_BASE_URL to target a specific Agent Platform host.

Documentation

Guides, core concepts, and the full API reference live at hub.hcompany.ai/agent-api, covering streaming progress, steering a live session, regions, structured output, and error handling.

License

MIT