AI-powered Discord bot for the Volvox developer community — a pnpm monorepo containing the bot (Node.js, ESM JavaScript, discord.js v14) and a web dashboard (Next.js 16, TypeScript, React 19). Powered by Claude.
git clone https://github.com/VolvoxLLC/volvox-bot.git
cd volvox-bot
cp .env.example .env
# Edit .env — fill in DISCORD_TOKEN, ANTHROPIC_API_KEY, and DISCORD_CLIENT_ID at minimum
docker compose up --build| Service | URL |
|---|---|
| Bot API | http://localhost:6968 |
| Web Dashboard | http://localhost:6969 |
| PostgreSQL | localhost:5432 |
| Redis | localhost:6379 |
Requires PostgreSQL 17+ and (optionally) Redis 7+ running on your machine.
git clone https://github.com/VolvoxLLC/volvox-bot.git
cd volvox-bot
pnpm install
cp .env.example .env # Edit .env with your tokens
pnpm migrate # Run database migrations
pnpm deploy # Register slash commands with Discord
pnpm start # Start the botFor the web dashboard:
pnpm --prefix web install
pnpm mono:dev # Start bot + dashboard togetherUse
pnpm dev(bot only) orpnpm mono:dev(all workspaces) for file-watching dev mode.
- 🧠 AI Chat — Mention the bot to chat with Claude. Per-channel conversation history with context management.
- 🎯 Smart Triage — Two-step evaluation (fast classifier + responder) for chime-ins and rule enforcement.
- 🤖 AI Auto-Moderation — Automated toxicity, spam, and harassment detection with configurable thresholds.
- 👍👎 AI Feedback — Thumbs up/down reactions on AI responses, tracked in dashboard analytics.
- 🧠 User Memory — Long-term memory per user via mem0 for personalized interactions.
- 👋 Dynamic Welcome Messages — Template-based onboarding with DM sequences and role menus.
- 🎭 Reaction Roles — Role menus with custom/Unicode emoji support.
- 📊 Reputation / XP System — Engagement tracking with configurable levels and role rewards.
- ⭐ Starboard — Highlight popular messages with star reactions.
- 🎤 Voice Activity Tracking — Voice channel metrics and leaderboards.
- 🏆 Challenges — Daily coding challenges with submissions and leaderboards.
- 🎫 Tickets — Support ticket system with threads.
- 💬 Polls · ✂️ Snippets · ⏰ Reminders · 💤 AFK · 📌 Showcase · 👀 Code Review
- ⚔️ Full Suite — warn, kick, ban, tempban, softban, timeout, purge, lock/unlock, slowmode.
- 🛡️ Protected Roles — Admins/mods protected from moderation actions.
- 📋 Case Management — Moderation history with warn editing, removal, and escalation.
- 📝 Scheduled Announcements — One-time or recurring messages.
- 🌐 Web Dashboard — Next.js admin panel with Discord OAuth2, dark/light themes, mobile support.
- 📊 Analytics — Message activity, command usage, voice time, AI feedback with PDF export.
- 📜 Audit Log — Complete action history with filtering, export, and WebSocket streaming.
- ⚡ Redis Caching — Distributed caching with graceful in-memory fallback.
- ⚙️ Runtime Config — All settings editable via
/configcommand or dashboard. Stored in PostgreSQL with live reload. - 💾 Backup & Restore — Export/import config with automatic scheduled backups.
Copy .env.example to .env — it contains full documentation for every variable.
Required: DISCORD_TOKEN, ANTHROPIC_API_KEY, DATABASE_URL, DISCORD_CLIENT_ID
Optional: REDIS_URL, SENTRY_DSN, BOT_API_SECRET, LOG_LEVEL, and more — see the file.
pnpm test # Run bot tests
pnpm test:coverage # With 85% coverage enforcement
pnpm lint # Biome lint + format check
pnpm lint:fix # Auto-fix
pnpm mono:dev # Dev mode (all workspaces)
pnpm mono:build # Build all workspaces
pnpm mono:typecheck # Typecheck all workspacesSee CONTRIBUTING.md for workflow, conventions, and PR process. See AGENTS.md for codebase rules. See DESIGN.md for the dashboard design system.
MIT — see LICENSE.
Built with ❤️ by the Volvox team.