Repolode
vercel

vercel/chat

TypeScript SDK for writing one chat bot that runs across Slack, Teams, Google Chat, Discord, Telegram and more.

Stars
2,458
Forks
347
Open issues
39
Last commit
21 hours ago

What is it?

Chat SDK is a unified TypeScript library for building chat bots and AI agents that run on multiple messaging platforms. Bot logic is written once against a common API, and platform-specific adapters handle the differences between Slack, Microsoft Teams, Google Chat, Discord, Telegram, GitHub, Linear, WhatsApp and others.

Developers register handlers for events such as mentions, new messages in subscribed threads, reactions, button clicks, slash commands and modal submissions. The SDK also covers streaming LLM responses into a thread, cross-platform cards and emoji, file attachments, direct messages and ephemeral replies. State storage is pluggable, with a Redis state adapter among the options.

The project is installed with npm as the core `chat` package plus one `@chat-adapter/*` package per platform. A `create-chat-sdk` CLI scaffolds a Next.js bot app, and an adapter catalog package lists supported platforms and their required environment variables.

Key features

  • 01Single bot codebase with handlers for mentions, messages, reactions and button clicks.
  • 02Adapters for Slack, Teams, Google Chat, Discord, Telegram, GitHub, Linear and WhatsApp.
  • 03Streaming of LLM responses into chat threads, with post-and-edit fallback.
  • 04Cross-platform cards, modals, slash commands and emoji.
  • 05Pluggable state storage, including Redis.
  • 06Scaffolding CLI that generates a Next.js bot project.

Use cases

  • Building one support or internal bot that must work in both Slack and Microsoft Teams.
  • Adding an AI assistant to team chat that streams responses into threads.
  • Creating GitHub or Linear automation bots that respond to comments or issues in chat.
  • Prototyping a multi-platform chatbot with a Next.js starter template.

Quick start

  1. 1

    Install the SDK from npm

    npm i chat
  2. 2

    Install adapters for your platforms

    npm install @chat-adapter/slack @chat-adapter/teams @chat-adapter/gchat
  3. 3

    Scaffold a minimal Next.js bot app

    npx create-chat-sdk@latest my-bot

Things to know

  • Using Slack, Teams or other platforms requires setting up each platform's app and credentials.
  • Production use with the example setup also requires a Redis state store.

In collections

Topics

FAQ

What is chat?
TypeScript SDK for writing one chat bot that runs across Slack, Teams, Google Chat, Discord, Telegram and more. Chat SDK is a unified TypeScript library for building chat bots and AI agents that run on multiple messaging platforms. Bot logic is written once against a common API, and platform-specific adapters handle the differences between Slack, Microsoft Teams, Google Chat, Discord, Telegram, GitHub, Linear, WhatsApp and others.
Is chat free to use? What license does it have?
chat is open source under the MIT license. Check the license terms before using it in commercial products.
Is chat still maintained?
Actively maintained. The last commit to chat was on Nov 6, 2026.
What can I use chat for?
Building one support or internal bot that must work in both Slack and Microsoft Teams. Adding an AI assistant to team chat that streams responses into threads. Creating GitHub or Linear automation bots that respond to comments or issues in chat. Prototyping a multi-platform chatbot with a Next.js starter template.
How do I install chat?
Install the SDK from npm: npm i chat Install adapters for your platforms: npm install @chat-adapter/slack @chat-adapter/teams @chat-adapter/gchat Scaffold a minimal Next.js bot app: npx create-chat-sdk@latest my-bot
Where can I get chat?
The source code and installation instructions are on GitHub: https://github.com/vercel/chat

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects