An always-on AI agent that works so you don't have to.
Vandelay is a self-hosted AI agent built on Agno that runs 24/7 with memory, tools, scheduling, and multi-channel access out of the box.
You get a personal agent that:
- Remembers everything across sessions (SQLite-backed memory)
- Has 100+ tool integrations ready to enable (search, email, GitHub, databases, browser, and more)
- Runs scheduled tasks and monitors itself via heartbeat
- Connects over Terminal, Telegram, WhatsApp, and WebSocket
- Supports agent teams with a built-in Vandelay Expert specialist
One command to install, one to run.
| Feature | Description |
|---|---|
| TUI Dashboard | Full command centre — chat, config, agents, scheduler, and live status in one place |
| 100+ Tools | Enable any tool with vandelay tools enable <slug> |
| Persistent Memory | SQLite-backed memory and session history that survives restarts |
| Multi-Channel | Terminal, Telegram, WhatsApp, WebSocket - same agent, shared memory |
| Knowledge / RAG | Add docs, PDFs, code - vector-searched and injected into context |
| Scheduler + Cron | Natural-language cron jobs, heartbeat with active hours — managed from the TUI |
| Agent Teams | Supervisor with specialist delegation and scoped tools |
| Browser Control | Anti-detect Firefox via Camoufox for web automation |
| Shell Safety | Trust / Confirm / Tiered modes, destructive commands always blocked |
| Daemon Service | vandelay daemon install - systemd (Linux), launchd (macOS), PID-file (Windows) |
| Self-Hosted First | Your data stays on your server. No cloud lock-in. |
# Install from source
git clone https://github.com/shaunymca/vandelay.git
cd vandelay
uv sync
uv tool install -e .
# Open the TUI dashboard (onboarding runs automatically on first launch)
vandelay
# Start the agent server (in a separate terminal, or install the daemon)
vandelay startFor a full walkthrough including prerequisites, configuration, and deployment, see the documentation site.
| Section | Description |
|---|---|
| Getting Started | Installation, quickstart, first message in under 5 minutes |
| Concepts | Architecture, agents, teams, memory, knowledge, channels, safety |
| Guides | Teams, custom tools, Telegram, Google services, scheduling, templates |
| Tools | 100+ tool catalog grouped by category, built-in toolkits |
| CLI Reference | Every command documented with examples |
| Configuration | Full config schema, env vars, examples |
| Deployment | VPS setup, systemd daemon, security hardening, troubleshooting |
Vandelay is built on Agno, an open-source framework for building multi-modal agents with memory, tools, and team support. Agno handles the model layer, tool integrations, memory backends, and team coordination — Vandelay wraps it into a ready-to-deploy platform.
MIT - see LICENSE