hai-agents 0.1.2

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

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.

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