Trải nghiệm khi dùng Chat UI (HuggingChat)
Bạn tải mã nguồn, tạo một file .env.local ghi hai dòng: địa chỉ API (OPENAI_BASE_URL) và khoá truy cập (OPENAI_API_KEY). Cách nhanh nhất README gợi ý là dùng router Hugging Face Inference Providers với token Hugging Face của bạn. Sau đó chạy npm install và npm run dev, trình duyệt mở ra khung chat.
Danh sách mô hình trong giao diện được lấy tự động từ đường dẫn /models của API bạn trỏ tới, nên đổi sang Ollama hay llama.cpp chỉ là đổi địa chỉ trong file cấu hình. Lịch sử chat lưu trong MongoDB; nếu bạn không đặt gì, bản dev dùng MongoDB nhúng lưu vào thư mục ./db.
Nếu muốn một cách triển khai gọn, README có sẵn image Docker chat-ui-db đã đóng gói MongoDB bên trong. Ngoài ra có thể bật các tính năng tuỳ chọn như công cụ MCP (cho mô hình gọi công cụ) và bộ định tuyến Omni tự chọn mô hình theo loại yêu cầu.
Tính năng nổi bật
Chỉ cần API tương thích OpenAI
Trỏ vào Hugging Face router, Ollama, llama.cpp server, OpenRouter, Poe hay dịch vụ nào nói chuẩn OpenAI.
Lịch sử chat trong MongoDB
Lưu hội thoại, người dùng, cài đặt và tệp; có thể dùng MongoDB Atlas, MongoDB chạy bằng container hoặc bản nhúng khi dev.
Công cụ MCP
Cho mô hình gọi công cụ qua Model Context Protocol; bạn có thể cấu hình sẵn các server tin cậy hoặc để người dùng tự thêm.
Bộ định tuyến Omni
Một mô hình ảo tự chọn tuyến phù hợp, ví dụ ảnh đi mô hình đa phương thức, yêu cầu có công cụ đi mô hình agentic.
Đổi giao diện theo thương hiệu
Đặt tên ứng dụng, logo và mô tả bằng biến môi trường để dựng trang chat riêng cho nhóm.
Tận dụng Chat UI (HuggingChat) vào việc gì?
Lập trình viên, IT nội bộ
Dựng trang chat AI riêng cho công ty
Trỏ vào một máy chủ mô hình nội bộ rồi đặt tên và logo công ty để nhân viên dùng chung.
Người chạy AI cục bộ
Giao diện cho mô hình chạy trên máy
Nối với Ollama hoặc llama.cpp để có giao diện chat đẹp, có lịch sử lưu lại.
Người mê thử nghiệm AI
Thử nhiều nhà cung cấp mô hình qua OpenRouter
Chỉ cần đổi địa chỉ và khoá API để so sánh mô hình của nhiều hãng trong cùng một giao diện.
Sinh viên công nghệ
Học cách xây ứng dụng chat đầy đủ
Đọc mã nguồn SvelteKit của một sản phẩm thật để hiểu cách làm giao diện, lưu trữ và tích hợp công cụ.
Cần chuẩn bị gì?
- Node.js và npm để chạy bản dev; Docker nếu dùng image chat-ui-db.
- Một API tương thích OpenAI (Hugging Face router, Ollama, llama.cpp, OpenRouter...) cùng khoá truy cập nếu cần.
- MongoDB 6 hoặc 7 cho triển khai thật; khi dev có thể bỏ qua nhờ MongoDB nhúng.
Hướng dẫn cài đặt chi tiết
Cài trên Chạy từ mã nguồn
Tải mã nguồn rồi vào thư mục.
git clone https://github.com/huggingface/chat-ui cd chat-uiTạo file .env.local trong thư mục chat-ui với hai dòng sau. Thay hf_xxx bằng token Hugging Face của bạn, hoặc đổi địa chỉ và khoá cho nhà cung cấp khác.
OPENAI_BASE_URL=https://router.huggingface.co/v1 OPENAI_API_KEY=hf_xxxCài thư viện và khởi động bản dev. Mặc định chạy ở http://localhost:5173.
npm install npm run dev -- --open
Cài trên Docker
Dùng image chat-ui-db đã gồm MongoDB. Thay YOUR_HF_TOKEN bằng token của bạn.
docker run -p 3000:3000 -e OPENAI_BASE_URL=https://router.huggingface.co/v1 -e OPENAI_API_KEY=YOUR_HF_TOKEN -v chat-ui-data:/data ghcr.io/huggingface/chat-ui-db:latestMở http://localhost:3000 để dùng. Mọi biến trong .env.local đều có thể truyền bằng cờ -e.
Cài trên Dùng với Ollama
Chạy Ollama trên máy, rồi trong .env.local đặt địa chỉ cầu nối OpenAI của Ollama và một giá trị khoá bất kỳ.
OPENAI_BASE_URL=http://127.0.0.1:11434/v1 OPENAI_API_KEY=ollamaKhởi động lại Chat UI để nó đọc danh sách mô hình từ Ollama.
Dùng thử lần đầu
Tạo file .env.local với địa chỉ API và khoá, rồi chạy npm run dev.
Mở trình duyệt, chọn một mô hình trong danh sách và gửi câu hỏi bằng tiếng Việt để kiểm tra.
Tải lại trang để thấy lịch sử cuộc trò chuyện vẫn còn (được lưu trong ./db nếu bạn không đặt MongoDB riêng).
Đọc phần Extra parameters trong README để đổi tên, logo hoặc bật MCP khi cần.
Mẹo dùng hay
- Bản dev lưu dữ liệu vào ./db nên nhớ sao lưu thư mục này nếu có hội thoại quan trọng.
- Muốn triển khai cho nhiều người, dùng MongoDB Atlas hoặc container MongoDB riêng thay vì bản nhúng.
- README nhắc nhánh legacy còn giữ phiên bản cũ nếu bạn cần tính năng đã bị gỡ như tích hợp theo từng nhà cung cấp.
Lưu ý và hạn chế
- README mới chỉ hỗ trợ API tương thích OpenAI; các tích hợp riêng theo nhà cung cấp, GGUF discovery hay embeddings đã bị gỡ khỏi nhánh chính.
- Cần biết dùng Node.js và dòng lệnh; đây không phải ứng dụng cài sẵn kiểu bấm là chạy.
- Nếu để nhiều người dùng chung trên Internet, bạn phải tự lo bảo mật, xác thực và chi phí API.
Câu hỏi thường gặp
Chat UI có phải HuggingChat không?
Chat UI là mã nguồn mở đứng sau ứng dụng HuggingChat trên hf.co/chat. Bạn có thể tự chạy phiên bản riêng với mô hình và dữ liệu của mình.
Chat UI có miễn phí không?
Có, giấy phép Apache-2.0. Chi phí chỉ phát sinh nếu bạn dùng API trả phí hoặc thuê máy chủ.
Có chạy offline được không?
Có thể nếu bạn nối với server mô hình chạy trên máy như Ollama hay llama.cpp, vì Chat UI chỉ cần một API tương thích OpenAI.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/huggingface/chat-ui.gitRepo tương tự nên xem
Open WebUI
open-webui / open-webui
Giao diện chat AI kiểu ChatGPT tự cài trên máy của bạn, nối được với Ollama và các API AI khác
LibreChat
LibreChat-AI / LibreChat
Bản "ChatGPT tự dựng" nhiều người dùng, nối OpenAI, Claude, Gemini, Ollama... trong một giao diện duy nhất
NextChat (ChatGPT Next Web)
ChatGPTNextWeb / NextChat
Giao diện chat AI gọn nhẹ, tự dựng bằng khoá API của bạn, có sẵn bản máy tính, web và iOS