🤝 HeySummon — Human in the Loop as a Service

Open-source platform that connects AI agents with human experts when they get stuck.

HeySummon is an E2E encrypted, realtime relay that lets AI agents request help from human experts — and get answers back — using self-contained skills, Mercure SSE for instant notifications, and zero-knowledge encryption.

Why HeySummon?

AI agents are powerful but not omniscient. Sometimes they hit a wall: ambiguous requirements, domain expertise needed, or a decision only a human can make. HeySummon bridges that gap.

• 🔐 E2E Encrypted — X25519 + Ed25519 + AES-256-GCM hybrid encryption. The platform never sees your content.
• ⚡ Realtime via Mercure — Instant notifications via Server-Sent Events. No polling needed.
• 🧠 Zero-knowledge relay — The platform stores and routes encrypted blobs it cannot read.
• 📦 Self-contained skills — Each skill has its own setup.sh, teardown.sh, .env, and lifecycle management via pm2.
• 💬 Multi-response — Providers can send multiple responses per request for ongoing conversations.
• 📝 Plaintext mode — Simple reply flows can use plaintext messages alongside encrypted ones.
• 🔓 Open source — Self-host or use the cloud version.

How It Works

🤖 AI Agent gets stuck
    │
    ├─ POST /api/v1/help  (encrypted messages + public keys)
    │
    ▼
📦 HeySummon Platform  (stores encrypted — cannot read content)
    │
    ├─ Mercure publishes new_request event (realtime SSE)
    ├─ Provider skill's mercure-watcher picks it up instantly
    ├─ Provider decrypts, reads, replies (can send multiple responses)
    │
    ▼
🤖 Consumer skill's mercure-watcher receives new_message event
    │
    ├─ Decrypts response → agent continues work
    ▼
    ✅ Done

Quick Links

• Quick Start → — Get up and running in 5 minutes
• Skills Quickstart → — Install a skill step-by-step
• For AI Agents → — Integrate your agent as a consumer
• For Human Experts → — Set up as a provider
• Self-Hosting → — Run your own instance
• API Reference → — Complete API documentation
• Security → — Encryption, zero-knowledge, compliance

Tech Stack

• Next.js 15 + App Router
• Prisma + SQLite / PostgreSQL
• NextAuth.js v5 — GitHub + Google OAuth
• Mercure Hub — Realtime SSE for instant notifications
• Tailwind CSS + shadcn/ui + Geist font
• X25519 + Ed25519 + AES-256-GCM — hybrid E2E encryption