New Project
Back to Templates
Community Agent Template
Open source AI-powered Slack community management bot with a built-in Next.js admin panel. Uses Chat SDK, AI SDK, and Vercel Workflow.
Template. Fork it, customize it, and deploy your own AI community manager with Vercel.
Features
- Community manager AI—routes questions, welcomes members, surfaces unanswered threads, and flags issues to a lead. Powered by AI SDK
- Channel-aware routing—configurable channel map so the bot knows your workspace layout and where to send people
- Durable workflows—every LLM call and tool execution is a checkpoint with automatic retries via Vercel Workflow
- Web search—Anthropic's native web search tool, scoped to your community's domains via
SEARCH_DOMAINS. Runs through AI Gateway - Sandbox execution—optional
bash/bash_batchtools for running commands in a sandboxed environment via the Knowledge Agent Template API - Native Slack UI—typing indicators, threaded replies, and DMs. Powered by Chat SDK
- Admin panel—live dashboard with real-time streaming indicators, ViewTransition animations, activity feed, type filters, text search, inline conversation previews, activity trends, and settings page with channel overview
- Auth—Slack OAuth via Better Auth restricts the admin panel to workspace members
Quick start
Try the admin panel without setting up Slack:
- Import the repo on vercel.com/new
- Add a
COMMUNITY_NAMEenv var (e.g.DevHub) - Deploy—the dashboard works immediately with mock data
For the full Slack bot setup, see docs/setup.md.
Customization
| What to change | File | Details |
|---|---|---|
| Bot personality | lib/agent.ts | System prompt and instructions |
| Channel map | lib/channels.ts | Must match your Slack workspace |
| Welcome message | lib/welcome.ts | Sent when new members join |
| Agent tools | workflows/agent-workflow/tools.ts | Add, remove, or modify tools |
| Auth config | lib/auth.ts | Slack OAuth for the admin panel |
| Action type UI | config/type-config.ts | Icons, labels, and colors per action type |
Knowledge base
This template is designed to work alongside the Knowledge Agent Template. Set SAVOIR_API_URL to connect to a deployed Savoir backend, giving the bot bash and bash_batch tools to search and read your community docs remotely. Without it, the bot still works using web search, channel routing, and the system prompt.
Docs
- Full setup guide—Slack app, env vars, storage, OAuth, channels, deploy
- Architecture—how the bot works, key files, workflow constraints
- Admin panel—dashboard pages, live streaming, filters, Next.js patterns
- Testing—test without Slack, simulate actions, mock data
Built with
- Next.js 16—App Router with cacheComponents
- Chat SDK—Slack adapter and bot framework
- AI SDK 6—AI model integration with AI Gateway support
- Vercel Workflow—durable workflow execution
- Better Auth—Slack OAuth for the admin panel
- shadcn/ui—component library
- Upstash Redis—bot action logging, stats, and conversation storage
License
MIT
