GitHub - hunvreus/heypi: Chat agents for your team, with approvals and sandboxed tools. Slack, Discord, Telegram, webhooks.

Team chat agents with approvals, audit, and sandboxed tools. Slack, Discord, Telegram, and trusted webhooks.

heypi is for governed chat-ops agents that work in shared channels while keeping sensitive actions reviewable. This repo contains the core heypi package, optional runtime providers, and runnable examples.

Start here: packages/heypi

Packages

• 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

• 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.

Development

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

Run examples:

(cd examples/slack-devops && pnpm dev)
(cd examples/discord-gondolin && pnpm dev)
(cd examples/telegram-workout && pnpm dev)
(cd examples/webhook-github-docker && pnpm dev)

Dry-run packages before publishing:

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

License

MIT