# assistant-ui/assistant-ui

Typescript/React Library for AI Chat💬🚀

Repository: https://github.com/assistant-ui/assistant-ui
Canonical: https://ross.abutalabs.com/products/assistant-ui
Homepage: https://www.assistant-ui.com
Language: TypeScript
License: MIT
License Family: permissive
Topics: conversational-ai, radix-ui, shadcn, ui-components, copilot, chatbot, vercel-ai-sdk, ai-chatbot, react-chatbot, base-ui
Last push: 2026-08-26T23:53:56+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 72
- inputs: {"age_days": 1015, "days_push": 7, "days_rel": 13, "gap_med": 0.0, "n_releases_24m": 1823}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 11869, forks 1155 (observed 2026-08-28T04:10:50.318529+00:00)

## What it is
assistant-ui is an open-source TypeScript/React library of primitives and runtimes for building production-grade AI chat interfaces, with adapters for Vercel AI SDK, LangGraph, LangChain, and custom backends. It supports web (React), React Native, and terminal (React Ink) surfaces, with features like streaming, tool UI, generative UI, attachments, branching, and voice.

## Use cases
- add a ChatGPT-style chat interface to my React app
- build a chat UI for my LangGraph agent
- connect Vercel AI SDK useChat to a customizable React chat component
- create a customer support chatbot frontend with tool calling and generative UI
- build a React Native AI chat app
- add streaming AI assistant with attachments and branching to Next.js
- render custom UI for agent tool calls in a chat thread
- build a terminal-based AI chat app

## When to choose
- You want a fully customizable, production-grade AI chat UI in React/React Native with composable primitives
- You need first-party adapters for Vercel AI SDK, LangGraph, LangChain, or protocol-based agents (A2A, AG-UI)
- You want shadcn/radix-style components whose source is copied into your repo for full control

## When to avoid
- You need a complete no-code chatbot product rather than a frontend library
- Your app is not React/TypeScript based
- You only need a minimal drop-in chat widget with no customization requirements

## Facets
- artifact type: library
- maturity: active
- function: ui-components, chatbot, chat-interface, frontend-framework, state-management, agent-framework
- domain: artificial-intelligence, chatbots, web-development, frontend, large-language-models
- platform: cross-platform, cli
- tags: react, typescript, ai-chat, chat-ui, vercel-ai-sdk, langgraph, langchain, shadcn, radix-ui, generative-ui, streaming, react-native, terminal-ui, mcp, ai-agents, nodejs, web-server

## Member repositories
- assistant-ui/assistant-ui (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:50.318529+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:15:14.897461+00:00, confidence not recorded.
  - readme: https://github.com/assistant-ui/assistant-ui (fetched 2026-08-28T04:10:50.318529+00:00, sha a0ca4332d6b1)
  - homepage: https://www.assistant-ui.com (fetched 2026-08-29T08:13:38.439323+00:00, sha 1507d85c1c65)
  - site_page: https://www.assistant-ui.com/docs (fetched 2026-08-29T08:13:38.448679+00:00, sha 265ecd338bd9)
  - site_page: https://www.assistant-ui.com/docs/runtimes/pick-a-runtime (fetched 2026-08-29T08:13:38.455458+00:00, sha 59f024d43156)
  - site_page: https://www.assistant-ui.com/docs/runtimes/ai-sdk/overview (fetched 2026-08-29T08:13:38.457157+00:00, sha 511d0acb7787)
  - site_page: https://www.assistant-ui.com/docs/runtimes/ai-sdk (fetched 2026-08-29T08:13:38.458835+00:00, sha c05c869d4b7c)
  - site_page: https://www.assistant-ui.com/docs/runtimes/langgraph (fetched 2026-08-29T08:13:38.460423+00:00, sha c13b8523d428)
  - site_page: https://www.assistant-ui.com/docs/runtimes/langchain (fetched 2026-08-29T08:13:38.462125+00:00, sha e1051dccdba9)
  - registry_npm: https://registry.npmjs.org/assistant-ui (fetched 2026-08-29T08:13:38.464391+00:00, sha 530873cea272)
  - site_page: https://www.assistant-ui.com/pricing (fetched 2026-08-29T08:13:38.450558+00:00, sha fac3b7e9237b)
- Data as of 2026-08-30T08:39:29.467469+00:00.