huggingface/chat-ui 源码下载_部署教程

项目概述

The open source codebase powering HuggingChat

项目地址

https://github.com/huggingface/chat-ui

项目页面预览

huggingface/chat-ui preview

关键指标

Stars：10418
主要语言：TypeScript
License：Apache License 2.0
最近更新：2026-01-14T13:12:48Z
默认分支：main

本站高速下载（国内可用）

源码压缩包下载：点击下载（本站镜像）
SHA256：be287d831068e189669f445c2d409a1bfeb695fa081cf31ff0e6662ad09afc36

安装部署要点（README 精选）

Quickstart

Chat UI speaks to OpenAI-compatible APIs only. The fastest way to get running is with the Hugging Face Inference Providers router plus your personal Hugging Face access token.

Step 1 – Create .env.local:

OPENAI_BASE_URL=https://router.huggingface.co/v1
OPENAI_API_KEY=hf_************************

OPENAI_API_KEY can come from any OpenAI-compatible endpoint you plan to call. Pick the combo that matches your setup and drop the values into .env.local:

Provider	Example `OPENAI_BASE_URL`	Example key env
Hugging Face Inference Providers router	`https://router.huggingface.co/v1`	`OPENAI_API_KEY=hf_xxx` (or `HF_TOKEN` legacy alias)
llama.cpp server (`llama.cpp --server --api`)	`http://127.0.0.1:8080/v1`	`OPENAI_API_KEY=sk-local-demo` (any string works; llama.cpp ignores it)
Ollama (with OpenAI-compatible bridge)	`http://127.0.0.1:11434/v1`	`OPENAI_API_KEY=ollama`
OpenRouter	`https://openrouter.ai/api/v1`	`OPENAI_API_KEY=sk-or-v1-...`
Poe	`https://api.poe.com/v1`	`OPENAI_API_KEY=pk_...`

Check the root .env template for the full list of optional variables you can override.

Step 2 – Install and launch the dev server:

git clone https://github.com/huggingface/chat-ui
cd chat-ui
npm install
npm run dev -- --open

You now have Chat UI running locally. Open the browser and start chatting.

Optional Docker Image

The chat-ui-db image bundles MongoDB inside the container:

docker run \
  -p 3000:3000 \
  -e OPENAI_BASE_URL=https://router.huggingface.co/v1 \
  -e OPENAI_API_KEY=hf_*** \
  -v chat-ui-data:/data \
  ghcr.io/huggingface/chat-ui-db:latest

All environment variables accepted in .env.local can be provided as -e flags.

常用命令（从 README 提取）

git clone https://github.com/huggingface/chat-ui
cd chat-ui
npm install
npm run dev -- --open

docker run -d -p 27017:27017 --name mongo-chatui mongo:latest

npm install
npm run dev