huggingface/chat-ui

어떤 프로젝트인가요?

핵심 기능

• 01OPENAI_BASE_URL을 통해 모든 OpenAI 호환 API에 연결합니다.
• 02엔드포인트의 /models 경로에서 모델을 확인합니다.
• 03채팅 기록과 설정을 MongoDB에 저장하며, 로컬 개발 환경에서는 임베디드 저장소로 대체할 수 있습니다.
• 04OpenAI function calling을 사용하는 도구 호출을 위해 MCP 서버를 지원합니다.
• 05메시지별로 모델을 선택하는 선택형 Omni 라우터를 제공합니다.
• 06환경 변수로 앱 이름, 에셋, 설명을 사용자 지정할 수 있습니다.

활용 사례

• 자체 호스팅한 llama.cpp 또는 Ollama 서버 앞에 ChatGPT 스타일의 인터페이스를 실행하는 경우.
• OpenAI 호환 게이트웨이를 사용하는 팀을 위한 내부 채팅 프런트엔드를 구축하는 경우.
• MongoDB에 채팅 기록을 저장하는 맞춤형 SvelteKit 채팅 앱의 출발점으로 활용하는 경우.
• 하나의 채팅 인터페이스에서 여러 모델로 MCP 도구를 테스트하는 경우.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/huggingface/chat-ui
2. 2

   프로젝트 폴더로 이동합니다

   cd chat-ui
3. 3

   종속성을 설치합니다

   npm install
4. 4

   OPENAI_BASE_URL과 OPENAI_API_KEY를 설정한 .env.local을 만든 후 개발 서버를 시작하고 브라우저를 엽니다

   npm run dev -- --open

사용 전 알아둘 점

• !OpenAI 호환 API에서만 작동하며, 공급자별 통합 기능은 제거되었습니다.
• !Hugging Face 토큰이나 로컬 llama.cpp 또는 Ollama 서버와 같은 API 엔드포인트와 키가 필요합니다.
• !채팅 기록과 설정에는 MongoDB가 필요하지만, URL을 설정하지 않으면 임베디드 데이터베이스로 대체됩니다.

토픽

자주 묻는 질문

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

어떤 OpenAI 호환 API와도 연결할 수 있는 SvelteKit 기반 LLM 채팅 인터페이스이자 HuggingChat의 기반 코드베이스입니다. Chat UI는 SvelteKit과 TypeScript로 만든 대규모 언어 모델용 웹 채팅 인터페이스입니다. hf.co/chat의 HuggingChat 앱을 구동하는 코드베이스이며, 로컬에서 실행하거나 직접 호스팅해 자체 모델에 사용할 수 있습니다.

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

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

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

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

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

자체 호스팅한 llama.cpp 또는 Ollama 서버 앞에 ChatGPT 스타일의 인터페이스를 실행하는 경우. OpenAI 호환 게이트웨이를 사용하는 팀을 위한 내부 채팅 프런트엔드를 구축하는 경우. MongoDB에 채팅 기록을 저장하는 맞춤형 SvelteKit 채팅 앱의 출발점으로 활용하는 경우. 하나의 채팅 인터페이스에서 여러 모델로 MCP 도구를 테스트하는 경우.

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

저장소를 클론합니다: git clone https://github.com/huggingface/chat-ui 프로젝트 폴더로 이동합니다: cd chat-ui 종속성을 설치합니다: npm install OPENAI_BASE_URL과 OPENAI_API_KEY를 설정한 .env.local을 만든 후 개발 서버를 시작하고 브라우저를 엽니다: npm run dev -- --open

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

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