heypi

Chat agents for your team, with approvals, durable state, and sandboxed tools. Slack, Discord, Telegram, and webhooks.

This repo contains the core heypi package, optional runtime providers, and runnable examples.

Start here: packages/heypi

• packages/heypi: Core framework: adapters, tools, approvals, state, admin, scheduler, CLI.
• packages/create-heypi: App scaffolder for npm create heypi@latest.
• packages/heypi-runtime-docker: Docker runtime provider with one warm container per runtime scope.
• packages/heypi-runtime-gondolin: Gondolin runtime provider with one warm VM per runtime scope.

• examples/slack-devops: Slack DevOps assistant with runtime tools, runbooks, memory, secrets, SSH host inventory, and approvals.
• examples/discord-gondolin: Discord project assistant with Gondolin, memory, scoped skills, secret requests, and file attachments.
• examples/telegram-workout: Telegram fitness coach with saved profile/plan and heartbeat check-ins.
• examples/webhook-github-docker: GitHub issue automation with webhook input, Docker repo inspection, and trusted GitHub writeback.

pnpm install
pnpm run check
pnpm run typecheck
pnpm run test
pnpm run build:all

Run examples:

pnpm run dev:slack
pnpm run dev:discord
pnpm run dev:telegram
pnpm run dev:webhook

Dry-run packages before publishing:

pnpm run pack:dry:packages
pnpm run publish:dry:packages

MIT