A multiplayer chat agent for your team.

Most AI assistants are single-player. heypi puts one agent in your team's Slack, Discord, or Telegram, with sandboxed tools, approvals, and an audit trail for anything sensitive. An app you own, not a workflow platform. 

npm create heypi@latest my-agent
Configure agent

Your agent is just files

No dashboard to configure. An agent is a folder you edit and commit to git. The scaffolder writes it for you. 

my-agent/
├─ index.ts
└─ agent/
   ├─ instructions.md
   ├─ tools/
   ├─ skills/
   └─ jobs/
  • instructions.md: who the agent is and how it behaves.
  • tools/: TypeScript functions it can call.
  • skills/: runbooks it can follow on demand.
  • jobs/: scheduled and recurring work.
  • index.ts: chat platforms, runtime, and state.

Everything a shared agent needs

heypi wraps a Pi agent with what a team actually needs: a place in chat, governed tools, durable state, and a record of everything it does.

Chat platforms

Add Slack, Discord, Telegram, or a trusted webhook. One agent, shared by everyone.

Approvals

Gate sensitive actions behind human approval, with named approvers for your team.

Audit trail

Record every turn, tool call, approval, and result in SQLite. Know who asked for what.

Files & commands

Let the agent read and write files, run commands, and search a scoped workspace.

Sandboxing

Run those commands in built-in just-bash, or a Docker, Gondolin, or custom sandbox.

Memory

Keep durable notes, scoped by channel, user, thread, adapter, or agent.

Skills

Let the agent build and reuse runbooks and standing instructions.

Secrets

Collect credentials through an encrypted handoff, never pasted in chat.

Scheduling

Run cron jobs and heartbeat check-ins against explicit channels and users.

File attachments

Receive files from chat and send generated files back.

Admin panel

Inspect chats, calls, approvals, memory, jobs, and config in one place.

Custom tools

Add trusted TypeScript tools for your own apps, data, and APIs.

Read docs →

FAQ

What is heypi?

heypi is a TypeScript framework for multiplayer chat agents: one Pi agent your whole team uses in Slack, Discord, Telegram, and trusted webhook entrypoints, with approvals, audit trails, scoped runtime tools, memory, secrets, jobs, and an admin UI.

How do I use heypi?

Run npm create heypi@latest. It scaffolds a TypeScript app, prompts for adapter, runtime, and model, writes starter agent files, and prepares environment placeholders. You can still build the same app manually with createHeypi(), loadAgent(), and an adapter.

Is heypi a workflow platform?

No. heypi is optimized for chat-ops agents with governed tool access. It records interrupted work during startup recovery, but it does not replay arbitrary in-flight agent turns after a process crash.

What can I connect it to?

The core package supports Slack, Discord, Telegram, and webhooks. You can also write custom adapters through the integration APIs.

Which models can I use?

heypi delegates model calls to Pi. Configure the model in agent configuration and provide provider credentials, such as OPENAI_API_KEY, through the Node process environment.

Do I need Docker or a VM?

No. The default runtime is just-bash. Use Docker or Gondolin runtime providers when the agent needs a real container or VM boundary, native binaries, package installs, or a workspace that behaves more like Linux.

Can agents ask before acting?

Yes. Tool calls can require approval before they continue. heypi records who requested the action, who approved it, what ran, and how it ended. See tools and confirmations.

What does heypi store?

Your heypi app stores data on your own server. By default, chat history, tool calls, approvals, jobs, and admin metadata are saved in SQLite. Files created or received by the agent, including attachments, memory, skills, and saved secrets, live as files in the app workspace. heypi.dev is only the website and docs.

How much does heypi cost?

heypi is free and open source. You still pay for your own infrastructure, model provider, chat platform, and any external runtime provider you choose.

Is heypi open source?

Yes. The code is on GitHub, packages are published on npm, and the license is in the repository.

Who built this?

heypi is built by Ronan Berder.

Why did you build this?

Most AI assistants are single-player: one person, one private chat. Teams need something different. A shared agent in a shared channel needs channel adapters, scoped context, runtime boundaries, approvals, audit logs, and secret handoff. heypi packages those pieces around Pi.

How can I help?

Star the project, report issues, send pull requests, or sponsor development.