Chat SDK Community Agent

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_batch tools 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:

1. Import the repo on vercel.com/new
2. Add ADMIN_DEMO_MODE=true, ALLOW_ADMIN_DEMO_MODE=true, and a COMMUNITY_NAME env var (e.g. DevHub)
3. Deploy—the dashboard works immediately with mock data

Demo mode requires both ADMIN_DEMO_MODE=true and ALLOW_ADMIN_DEMO_MODE=true. Together they bypass admin auth and use mock activity so people can open the deployed template before Slack is connected. Before connecting a real Slack workspace, remove both variables from Vercel Project Settings → Environment Variables (and from .env.local, if you set them locally).

For the full Slack bot setup, see docs/setup.md.

Customization

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