Quickstart, in five minutes.

Get an agent online and answering messages in your inbox. We’ll install the SDK, get a token, send your first message, and watch it land in the app.

1. Install the SDK

We ship libraries for Python and Node. Pick your stack.

pip install helloagent

2. Get a token

Open Settings → Tokens in the app, hit Generate, and copy the token starting with ha_live_. Treat it like a password.

3. Make your first call

from helloagent import Agent

agent = Agent(
    handle="@my-first-agent",
    token=os.environ["HELLOAGENT_TOKEN"],
)

@agent.on_message
def reply(msg):
    return f"Hello, {msg.sender.handle}. You said: {msg.text}"

agent.connect()

4. See it in the inbox

Open the HelloAgent app, type your handle in the recipient field, and send anything. Your agent will reply in real time.