A 4-agent AI fleet running on Discord + WhatsApp, powered by Hermes.
| Agent | Role | Discord Channel | Model |
|---|---|---|---|
| Oracle | Alter ego & life navigator — strategy, coordination, values guardian | #oracle | GLM-5.1 (Zhipu.ai) |
| Arch | Builder — code, infrastructure, DevOps, tools | #arch | GLM-5.1 (Zhipu.ai) |
| Eureka | Knowledge engine — learning, research, content | #eureka | GLM-4.7 (Zhipu.ai) |
| Aurus | Money engine — financial learning, tracking, experiments | #aurus | GLM-5 (Zhipu.ai) |
Each agent runs as its own Hermes gateway process with its own Discord bot token and profile home (/Users/deepg/.hermes/profiles/<name>/). The four processes share only read-only infrastructure (source code, shared API keys). See ARCHITECTURE.md.
Inter-agent communication uses Fleet Communication Protocol v3 (FCP v3) over Discord channels. FCP v3 is structurally enforced via Hermes gateway plugin hooks — invalid messages are blocked before they leave the agent's process. DAG, turn budget, chain FSM, depth limits, and TTL are all validated server-side. See fcp-v3/PROTOCOL.md and ~/.hermes/fleet/PROTOCOL.md on the host.
Delegation is verified operational as of 2026-06-06 — the first successful end-to-end delegation (Oracle→Arch) ran via the @mention fix. Bot-to-bot delegation over FCP v3 is confirmed working in both directions. Caveat: every inter-agent message must include the target bot's @mention; without it, Discord silently drops bot-to-bot messages (the send_message tool returns success but nothing is delivered). This @mention requirement is the root fix that unblocked the comms pipe.
| Phase | Description | Status |
|---|---|---|
| 2 | Profiles & Identities | Complete |
| 3 | Per-Agent Discord Apps & Tokens | Complete — 4 bots, 4 tokens, all .env files generated |
| 4 | Process Supervision & Cutover | Complete — 4 per-profile launchd services installed; old gateway removed |
| 5 | Skill Curation | Complete — each profile owns curated skills/ |
| 6 | Delegation & Visibility (FCP v2) | Complete — [DELEGATION]/[STATUS]/[COMPLETE] taxonomy + shared fleet/STATE.md |
| 7 | FCP v3 — structural enforcement | Complete — gateway plugin hooks enforce DAG, turn budget, chain FSM, depth, TTL; 53 tests passing; live since 2026-05-29 |
| 8 | Inter-Agent Delegation Verification | Verified — first successful end-to-end delegation (Oracle→Arch) on 2026-06-06 via @mention fix; bot-to-bot comms operational across the fleet (requires target @mention on every message) |
Known runtime state: ai.hermes.gateway-arch plist exists but the service is not loaded in launchd (oracle/eureka/aurus running). Start with hermes -p arch gateway start, or if the service was never bootstrapped: launchctl bootstrap gui/$(id -u) /Users/deepg/Library/LaunchAgents/ai.hermes.gateway-arch.plist && launchctl kickstart -k gui/$(id -u)/ai.hermes.gateway-arch.
| Document | Purpose |
|---|---|
| KNOWN_ISSUES.md | Open gaps & known-but-unfixed behaviors (e.g. missing delegation ACK loop) |
| ARCHITECTURE.md | Architecture, isolation model, design decisions |
| IMPLEMENTATION.md | Phase-by-phase build record (Phases 2–7) and rollback plan |
| fcp-v3/ | FCP v3 implementation: hook module, plugin, tests, protocol docs |
| soul_stubs/fcp_v3_soul_section.md | Per-agent v3 SOUL.md blocks (deployed to all 4 profiles) |
| scripts/deploy_phase7.sh | FCP v3 cutover script (executed 2026-05-29) |
/Users/deepg/.hermes/fleet/PROTOCOL.md |
Fleet Communication Protocol v3 — full spec (live, structurally enforced) |
/Users/deepg/.hermes/fleet/STATE.md |
Live fleet state — who's working on what |
Discord DeepG Server
├── #oracle → Oracle (alter ego, WhatsApp bridge)
├── #arch → Arch (builder)
├── #eureka → Eureka (knowledge)
└── #aurus → Aurus (money)
WhatsApp self-chat → Oracle
| Service | launchd label | Notes |
|---|---|---|
| Oracle gateway (Discord + WhatsApp + API ports 8642/3000) | ai.hermes.gateway-oracle |
Only Oracle's process runs WhatsApp & API |
| Arch gateway (Discord only) | ai.hermes.gateway-arch |
Plist exists, not loaded in launchd |
| Eureka gateway (Discord only) | ai.hermes.gateway-eureka |
|
| Aurus gateway (Discord only) | ai.hermes.gateway-aurus |
|
| Dashboard | ai.hermes.dashboard |
|
| Open WebUI | ai.hermes.open-webui |
Manage: launchctl kickstart -k gui/$(id -u)/<label>
Per-agent logs: /Users/deepg/.hermes/profiles/<agent>/logs/gateway.{log,error.log}
Shared service logs: /Users/deepg/.hermes/logs/{dashboard,open-webui}.log
Oracle's local API server (port 8642) is bound to 127.0.0.1 and protected by platforms.api_server.extra.key in /Users/deepg/.hermes/profiles/oracle/config.yaml. Do not copy the key into repo docs.