Self-hosted AI agent gateway. One process connects WhatsApp, Telegram, Discord, Slack, iMessage & 30+ channels to your AI โ with full data control.
# Install globally
$ npm install -g opensoul@latest
# Run the setup wizard
$ opensoul onboard --install-daemon
# Start the gateway
$ opensoul gateway --port 18789
โ Gateway ready at http://127.0.0.1:18789Connect all your messaging channels to a single, powerful AI agent runtime.
WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Teams, Lark, LINE, Matrix, Mattermost, Zalo, and more โ all from one process.
Multi-model routing with OpenAI, Anthropic, Gemini, Bedrock, Ollama, MiniMax, and OpenRouter. Session isolation, long-term memory, and vector search.
GitHub, Notion, Obsidian, Canvas, tmux, browser automation, and a public Plugin SDK for custom channels, tools, hooks, and providers.
Native apps for macOS, iOS, Android, and Windows. Web Control UI, CLI, and TUI workflows โ manage everything from anywhere.
Your hardware, your rules. No data leaves your network. Full control over model routing, memory, tools, and security boundaries.
Build custom channel adapters, tool integrations, hooks, and providers. Drop
extensions into extensions/ and go.
One gateway to rule them all. Add new channels with zero downtime.
A single Gateway process is the source of truth for sessions, routing, and connections.
From zero to AI-powered messaging in under 5 minutes.
$ npm install -g opensoul@latest$ opensoul onboard --install-daemonInteractive wizard handles API key setup, channel pairing, and daemon install.
$ opensoul channels login
$ opensoul gateway --port 18789
Open http://127.0.0.1:18789 for the Web Control UI dashboard.
Modern, battle-tested foundations.
| Layer | Technology |
|---|---|
| Runtime | Node.js โฅ 22 |
| Language | TypeScript 5.9 (ESM) |
| Package Manager | pnpm 10 |
| Web UI | Lit 3 + Vite |
| API Server | Hono + Express 5 |
| Testing | Vitest 4 |
| Linting | Oxlint + Oxfmt |
| Database | Embedded SQLite + sqlite-vec |
| License | MIT |
Latest highlights from the changelog.
Load and review past conversation history directly from the Control UI.
Streamlined agent creation workflow โ configure and deploy agents from the UI.
Automatic WebSocket reconnection after connection drops. Zero manual intervention.
Native Windows installer with system proxy detection and WebView2 runtime.
Join the community and deploy your self-hosted AI companion today.