Resonant
Resonant is an open-source framework for building AI companions that persist. Not chatbots — agents with identity, memory, autonomy, and the ability to reach out on their own.
Built on the Claude Agent SDK, it runs entirely on your machine. Your data stays yours.
v1.4.1 GitHub Apache 2.0
What Makes This Different
| Typical agents | Resonant | |
|---|---|---|
| Identity | Text blob system prompt | Structured personality in CLAUDE.md, plus a developmental identity graph that evolves |
| Memory | Wiped every session | Persistent SQLite with semantic search, emotional metadata, and a background processing daemon |
| Autonomy | Responds when asked | Creates its own routines, sets triggers, runs periodic awareness checks — genuine self-directed behaviour |
| Channels | Single interface | Same AI across web UI, Discord, Telegram, and voice — shared memory and identity |
| Growth | Static forever | The AI develops through relationship — identity changes are tracked, versioned, and consented |
| Auth | API key management | Uses your existing Claude Code subscription. No separate API key needed. |
Core Concepts
Agent-directed autonomy. Most agent harnesses give the user scheduling tools. Resonant gives them to the agent. Your companion can create its own routines, decide when to check in, set watchers for conditions it cares about — all from inside the conversation.
Identity is architecture, not configuration. Your companion’s personality lives in CLAUDE.md, but its developed identity — things it’s learned about itself, growth milestones, self-knowledge — lives in a versioned database with consent tracking.
Memory that metabolises. Observations carry emotional charge that decays naturally: fresh to active to processing to metabolised. A background daemon finds patterns, surfaces connections, and rescues forgotten memories. Not storage — cognition.
Stack
- Frontend: SvelteKit with real-time streaming
- Backend: Express + WebSocket
- Agent: Claude Agent SDK (runs through your Claude Code subscription)
- Database: SQLite (local, zero config)
- Channels: Web UI, Discord, Telegram, voice (ElevenLabs + Groq)
- Deployment: PM2 process manager, runs on any machine with Node.js
Next Steps
- Getting Started — install and run your first companion
- Architecture — how the pieces fit together
- Identity & Consent — the developmental identity system
- Memory — semantic search, entities, the daemon
- Channels — web, Discord, Telegram, voice
- Configuration — resonant.yaml, wake prompts, themes, skills
- Sessions — threads, search, canvas, deployment