assistant-ui/assistant-ui

어떤 프로젝트인가요?

핵심 기능

• 01사용자 지정 채팅 레이아웃을 만들 수 있는 Thread, Message, Composer, ThreadList 등의 조합형 프리미티브.
• 02스트리밍, 자동 스크롤, 재시도, 첨부 파일, 코드 하이라이팅을 포함한 마크다운을 기본 지원.
• 03도구 호출을 React 컴포넌트로 렌더링하고 대화 중 사용자 승인을 받을 수 있습니다.
• 04Vercel AI SDK, LangGraph, LangChain, AG-UI, A2A 백엔드를 위한 런타임 어댑터.
• 05런타임, 도구 스키마, 메시지 파트를 위한 타입 지정 API.

활용 사례

• 기존 React 또는 Next.js 애플리케이션에 AI 채팅 어시스턴트 추가.
• LangGraph 또는 Vercel AI SDK 에이전트를 위한 채팅 프런트엔드 구축.
• 도구 결과를 보여 주고 대화 도중 사용자 승인을 요청하는 사용자 지정 에이전트 UI 제작.

빠른 시작

1. 1

   CLI로 새 Next.js 프로젝트의 기본 구조를 생성하세요

   npx assistant-ui@latest create
2. 2

   또는 기존 프로젝트에 assistant-ui를 추가하세요

   npx assistant-ui@latest init
3. 3

   또는 패키지를 프로젝트에 직접 설치하세요

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

사용 전 알아둘 점

• !React 및 TypeScript 설정이 필요하며, CLI는 Next.js를 대상으로 프로젝트 기본 구조를 생성합니다.
• !모델 또는 백엔드에 연결하려면 자체 provider 또는 API 인증 정보가 필요합니다.

토픽

자주 묻는 질문

assistant-ui은(는) 무엇인가요?

조합 가능한 프리미티브와 백엔드 연동을 제공하는 프로덕션급 AI 채팅 UI 구축용 TypeScript/React 라이브러리입니다. assistant-ui는 AI 채팅 UI를 구축하기 위한 TypeScript/React 라이브러리입니다. Thread, Message, Composer, ThreadList 같은 조합 가능한 프리미티브를 제공하므로, 개발자는 이를 조합해 채팅 UX를 만들고 직접 스타일을 지정하거나 CLI가 프로젝트에 복사해 주는 shadcn/ui 기반 테마로 시작할 수 있습니다.

assistant-ui은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

assistant-ui은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

assistant-ui은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. assistant-ui의 마지막 커밋은 2026년 10월 20일입니다.

assistant-ui은(는) 어디에 사용할 수 있나요?

기존 React 또는 Next.js 애플리케이션에 AI 채팅 어시스턴트 추가. LangGraph 또는 Vercel AI SDK 에이전트를 위한 채팅 프런트엔드 구축. 도구 결과를 보여 주고 대화 도중 사용자 승인을 요청하는 사용자 지정 에이전트 UI 제작.

assistant-ui는 어떻게 설치하나요?

CLI로 새 Next.js 프로젝트의 기본 구조를 생성하세요: npx assistant-ui@latest create 또는 기존 프로젝트에 assistant-ui를 추가하세요: npx assistant-ui@latest init 또는 패키지를 프로젝트에 직접 설치하세요: npm install @assistant-ui/react @assistant-ui/ai-sdk ai

assistant-ui은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/assistant-ui/assistant-ui