hai-agents 0.1.5

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 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