assistant-ui/assistant-ui

β–² 75 stars todayβ˜… 13,258β‘‚ 1,344

Typescript/React Library for AI Chat πŸ’¬πŸš€

About assistant-ui/assistant-ui

assistant-ui/assistant-ui is an open-source project on GitHub, mainly written in TypeScript. Typescript/React Library for AI Chat πŸ’¬πŸš€ It currently holds 13,258 stars and 1,344 forks with 70 open issues, and was last pushed on 2026-11-16 (repository created 2023-11-22).

Project Overview

Git Homed tracks it on the Today's Trending board, currently at rank #45 with 75 new stars today.

GitHub Repository Details

Repository assistant-ui/assistant-ui Β· default branch main Β· size 207638 KB Β· watchers 81 Β· source: GitHub REST API and repository README

README

https://github.com/assistant-ui/assistant-ui/blob/HEAD/assistant-ui: the frontend library for AI agents

Product Β· Documentation Β· Examples Β· Discord Β· Contact Sales

https://github.com/assistant-ui/assistant-ui/blob/HEAD/npm version https://github.com/assistant-ui/assistant-ui/blob/HEAD/npm downloads https://github.com/assistant-ui/assistant-ui/blob/HEAD/Ask DeepWiki https://github.com/assistant-ui/assistant-ui/blob/HEAD/Weave Badge https://github.com/assistant-ui/assistant-ui/blob/HEAD/GitHub License https://github.com/assistant-ui/assistant-ui/blob/HEAD/GitHub stars https://github.com/assistant-ui/assistant-ui/blob/HEAD/Backed by Y Combinator

The UX of ChatGPT in your React app πŸ’¬πŸš€

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

https://github.com/assistant-ui/assistant-ui/blob/HEAD/An assistant-ui chat: a hotel search tool call, a streamed reply, an approval card that the user allows, and follow-up suggestions

Installation

The fastest path is the CLI, which scaffolds a Next.js app or adds the styled components to an existing project:

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

Or install the packages directly:

npm install @assistant-ui/react @assistant-ui/ai-sdk ai

https://github.com/assistant-ui/assistant-ui/blob/HEAD/Running npx assistant-ui@latest init in a terminal

Usage

"use client";

import { AssistantRuntimeProvider } from "@assistant-ui/react"; import { useChatRuntime } from "@assistant-ui/ai-sdk"; import { Thread } from "@/components/assistant-ui/elements/thread.aui";

export function Chat() { const runtime = useChatRuntime(); return ( ); }

useChatRuntime connects to the Vercel AI SDK out of the box. Swap it for useLangGraphRuntime, useDataStreamRuntime, or any custom runtime to integrate with your own backend.

What you get

https://github.com/assistant-ui/assistant-ui/blob/HEAD/A get_weather tool call rendered as a weather card inside an assistant-ui chat

Backends

| Integration | Package | | -------------------------------------- | ---------------------------------------------------------------- | | Vercel AI SDK | @assistant-ui/ai-sdk | | LangGraph / LangChain | @assistant-ui/react-langgraph, @assistant-ui/react-langchain | | AG-UI / A2A protocols | @assistant-ui/react-ag-ui, @assistant-ui/react-a2a | | Google ADK / OpenCode | @assistant-ui/react-google-adk, @assistant-ui/react-opencode | | Custom data-stream backend | @assistant-ui/react-data-stream | | Managed thread history, telemetry, and file storage | assistant-cloud |

Broad model support out of the box (OpenAI, Anthropic, Google Gemini, Mistral, Perplexity, AWS Bedrock, Azure, Fireworks, Ollama) plus community providers via the AI SDK, and easy extension to any custom HTTP backend.

Customization

Instead of a single monolithic chat component, you compose primitives and bring your own styles. The CLI ships a great starter in your choice of Base UI (the default) or Radix UI flavor; you control everything else.

https://github.com/assistant-ui/assistant-ui/blob/HEAD/A chat UI annotated with the primitives that build it: ThreadPrimitive.Viewport, MessagePrimitive.Root and Parts, makeAssistantToolUI, ActionBarPrimitive, BranchPickerPrimitive, and ComposerPrimitive.Input, Send and AddAttachment

Used in production by

https://github.com/assistant-ui/assistant-ui/blob/HEAD/Mastra      https://github.com/assistant-ui/assistant-ui/blob/HEAD/LangChain      https://github.com/assistant-ui/assistant-ui/blob/HEAD/Athena Intelligence      https://github.com/assistant-ui/assistant-ui/blob/HEAD/Browser Use      https://github.com/assistant-ui/assistant-ui/blob/HEAD/Stack

https://github.com/assistant-ui/assistant-ui/blob/HEAD/Inconvo      https://github.com/assistant-ui/assistant-ui/blob/HEAD/Iterable      https://github.com/assistant-ui/assistant-ui/blob/HEAD/Helicone      https://github.com/assistant-ui/assistant-ui/blob/HEAD/Gram      https://github.com/assistant-ui/assistant-ui/blob/HEAD/Coreviz

…and many more.

https://github.com/assistant-ui/assistant-ui/blob/HEAD/Chart of assistant-ui's traction

Demos

https://github.com/assistant-ui/assistant-ui/blob/HEAD/Short Demo https://github.com/assistant-ui/assistant-ui/blob/HEAD/Long Demo

Community & Support

License

MIT, with optional Assistant Cloud for managed thread persistence and analytics.

Backed by Y Combinator.

GitHub Stars & Activity

13,258Stars
1,344Forks
70Open issues
TypeScriptLanguage

GitHub Popularity

GitHub stars13,258
Forks1,344
Open issues70
Primary languageTypeScript
LicenseMIT
Stars gained today75
Created2023-11-22
Last pushed2026-11-16

Trending History

Daily boardrank #45 Β· β–² 75 stars

Related GitHub Projects

1

ChromeDevTools / chrome-devtools-mcp

TypeScriptβ˜… 57,370β‘‚ 4,834β–² 717 stars
β†’
2

tashfeenahmed / freellmapi

TypeScriptβ˜… 53,114β‘‚ 7,448β–² 579 stars
β†’
3

motiondivision / motion

TypeScriptβ˜… 35,252β‘‚ 1,554β–² 76 stars
β†’
4

dream-num / univer

TypeScriptβ˜… 26,949β‘‚ 2,444β–² 988 stars
β†’
5

motion-canvas / motion-canvas

TypeScriptβ˜… 19,968β‘‚ 916β–² 111 stars
β†’
6

ag-ui-protocol / ag-ui

TypeScriptβ˜… 18,303β‘‚ 1,888β–² 355 stars
β†’
7

elder-plinius / G0DM0D3

TypeScriptβ˜… 12,488β‘‚ 2,905β–² 66 stars
β†’
8

backnotprop / plannotator

TypeScriptβ˜… 12,176β‘‚ 1,146β–² 866 stars
β†’

More Trending Repositories