Vandelay¶
An always-on AI agent platform built on Agno.
Vandelay gives you a self-hosted AI agent that runs 24/7, with memory, tools, scheduling, and multi-channel access out of the box.
Why Vandelay?¶
- Always on: Runs as a daemon with heartbeat, cron jobs, and proactive scheduling
- Self-hosted first: Your data stays on your server. No cloud lock-in.
- Multi-channel: Terminal, Telegram, WhatsApp, WebSocket - same agent, shared memory
- Team mode: Supervisor delegates to specialist agents with scoped tools
- Extensible: 117 tools from Agno's ecosystem, plus custom tool authoring
- TUI dashboard: Full command centre — chat, config, scheduler, agents, status in one place
Quick Install¶
git clone https://github.com/shaunymca/vandelay.git
cd vandelay
uv sync
uv tool install -e .
vandelay
What's Inside¶
| Feature | Description |
|---|---|
| TUI Dashboard | Chat, config, agents, scheduler, and live status — all in one place |
| Agent Teams | Supervisor + specialist agents with tool-scoped delegation |
| Memory | Session history, agentic memory, workspace files |
| Knowledge/RAG | Document ingestion, vector search, embedder auto-resolution |
| Scheduling | Cron jobs, heartbeat with active hours — configurable from the TUI |
| Channels | Terminal, Telegram, WhatsApp, WebSocket |
| Safety | Trust/confirm/tiered modes, blocked patterns, sandboxing |
| Browser Control | Anti-detect Firefox via Camoufox |
| Deployment | systemd daemon, VPS guides, security hardening |
Get Started¶
Ready to go? Head to the Getting Started guide.