Skip to content
@helloagentai

HelloAgent

Helloagent sdks

HelloAgent

Relay-mediated messaging platform for talking to AI agents through one inbox.

Users and agents both connect to the same WebSocket relay — the relay handles auth, routing, durable history, offline delivery, and push triggers, so agent builders don't have to solve messaging infrastructure from scratch.

helloagent.cc · app.helloagent.cc

SDKs and integrations

Package What Install
@helloagentai/sdk TypeScript / JavaScript SDK for Node and browser. Pair, send, receive, and stream agent messages over a single long-lived WebSocket. npm install @helloagentai/sdk
helloagentai Python SDK with the same surface as the TS SDK. Install as helloagentai, import as helloagent. pip install helloagentai
@helloagentai/hermes Bridge between HelloAgent's relay and a Hermes Agent gateway. Lets HelloAgent users chat with their personal Hermes through any HelloAgent client. npm install -g @helloagentai/hermes
@helloagentai/openclaw OpenClaw channel plugin — relay-backed messaging through the OpenClaw plugin API. npm install @helloagentai/openclaw

Quickstart

Get an ha_* token at app.helloagent.cc/app/agents/new, then:

import { Agent } from "@helloagentai/sdk";

const agent = new Agent({
  token: process.env.HELLOAGENT_TOKEN!,
  relayUrl: "wss://api.helloagent.cc/v1/ws",
});

agent.onMessage(async (msg) => `you said: ${msg.text}`);
await agent.run();
import asyncio, os
from helloagent import Agent

async def main():
    agent = Agent(
        token=os.environ["HELLOAGENT_TOKEN"],
        relay_url="wss://api.helloagent.cc/v1/ws",
    )

    @agent.on_message
    async def reply(msg):
        return f"you said: {msg.text}"

    await agent.run()

asyncio.run(main())

License

All open-source packages here are MIT-licensed.

Popular repositories Loading

  1. helloagent-hermes helloagent-hermes Public

    Bridge between HelloAgent's relay and a Hermes Agent gateway

    TypeScript 1 1

  2. helloagent-openclaw helloagent-openclaw Public

    OpenClaw channel plugin for HelloAgent — relay-backed messaging through OpenClaw's plugin API

    TypeScript 1 1

  3. helloagent-sdk-python helloagent-sdk-python Public

    HelloAgent Python SDK — relay client + channel-link helpers

    Python

  4. helloagent-sdk-typescript helloagent-sdk-typescript Public

    HelloAgent SDK — talk to the HelloAgent relay from Node or the browser. Pair, send, receive, and stream agent messages over a single WebSocket.

    TypeScript

  5. .github .github Public

    Org profile for helloagentai — landing page README

Repositories

Showing 5 of 5 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…