Repository files navigation

Product ·Documentation ·Examples ·Discord Community ·Contact Sales

• ⭐️ Star us on GitHub

assistant-ui is an open source TypeScript/React library to build production-grade AI chat experiences fast.

• Handles streaming, auto-scrolling, accessibility, and real-time updates for you
• Fully composable primitives inspired by shadcn/ui and cmdk — customize every pixel
• Works with your stack: AI SDK, LangGraph, Mastra, or any custom backend
• Broad model support out of the box (OpenAI, Anthropic, Mistral, Perplexity, AWS Bedrock, Azure, Google Gemini, Hugging Face, Fireworks, Cohere, Replicate, Ollama) with easy extension to custom APIs

• Fast to production: battle-tested primitives, built-in streaming and attachments
• Designed for customization: composable pieces instead of a monolithic widget
• Great DX: sensible defaults, keyboard shortcuts, a11y, and strong TypeScript
• Enterprise-ready: optional chat history and analytics via Assistant Cloud

Run one of the following in your terminal:

npx assistant-ui create# new projectnpx assistant-ui init# add to existing project

• Build: composable primitives to create any chat UX (message list, input, thread, toolbar) and a polished shadcn/ui theme you can fully customize.

• Ship: production-ready UX out of the box — streaming, auto-scroll, retries, attachments, markdown and code highlighting — plus keyboard shortcuts and accessibility by default.

• Generate: render tool calls and JSON as components, collect human approvals inline, and enable safe frontend actions.

• Integrate: works with AI SDK, LangGraph, Mastra, or custom backends; broad provider support; optional chat history and analytics via Assistant Cloud (single env var).

• Assistant Cloud: managed chat persistence and analytics. Deploy with the Cloud Starter template; bring any model/provider.

• AI SDK: integration with Vercel AI SDK; connect to any supported provider.

• LangGraph: integration with LangGraph and LangGraph Cloud; connect via LangChain providers.

• Mastra: integration with Mastra agents/workflows/RAG; model routing via Vercel AI SDK; optional Mastra Cloud.

• Custom: use assistant-ui on top of your own backend/streaming protocol.

assistant-ui takes a Radix-style approach: instead of a single monolithic chat component, you compose primitives and bring your own styles. We provide a great starter config; you control everything else.

Sample customization to make a Perplexity lookalike:

Hundreds of projects use assistant-ui to build in-app AI assistants, including companies like LangChain, AthenaIntelligence, Browser Use, and more.

With >200k monthly downloads, assistant-ui is one of the most popular UI libraries for building AI chat.

• Check out example demos
• Read the docs
• Join our Discord
• Book a sales call

Backed by Y Combinator. Building something with assistant-ui? We’d love to hear from you.