Chuyển đến nội dung

huggingface / chat-ui

Chat UI (HuggingChat)

Mã nguồn giao diện chat của HuggingChat, tự dựng được trên máy và nối với mọi API tương thích OpenAI

Chat UI là ứng dụng SvelteKit chạy giao diện chat AI, chính là mã nguồn đứng sau HuggingChat trên hf.co/chat. Bạn tự chạy nó và trỏ vào bất kỳ dịch vụ nói chuẩn OpenAI như router của Hugging Face, Ollama, llama.cpp server hay OpenRouter. Phù hợp với người muốn dựng trang chat riêng, có lịch sử, công cụ MCP và định tuyến mô hình.

  • 11.036 sao
  • 1.716 fork
  • TypeScript
  • Cập nhật hôm qua
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Khó Dành cho người biết lập trình
Dạng
Web tự cài (self-host)
Chạy trên
Node.js, Docker, Windows, macOS, Linux, Web
Chi phí
Miễn phí (trả phí API AI nếu dùng)

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

  1. Tải mã nguồn rồi vào thư mục.

    Terminal
    git clone https://github.com/huggingface/chat-ui
    cd chat-ui
  2. Tạ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.

    Văn bản
    OPENAI_BASE_URL=https://router.huggingface.co/v1
    OPENAI_API_KEY=hf_xxx
  3. Cài thư viện và khởi động bản dev. Mặc định chạy ở http://localhost:5173.

    Terminal
    npm install
    npm run dev -- --open

Cài trên Docker

  1. Dùng image chat-ui-db đã gồm MongoDB. Thay YOUR_HF_TOKEN bằng token của bạn.

    Terminal
    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:latest
  2. Mở 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

  1. 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ỳ.

    Văn bản
    OPENAI_BASE_URL=http://127.0.0.1:11434/v1
    OPENAI_API_KEY=ollama
  2. Khởi động lại Chat UI để nó đọc danh sách mô hình từ Ollama.

Dùng thử lần đầu

  1. Tạo file .env.local với địa chỉ API và khoá, rồi chạy npm run dev.

  2. 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.

  3. 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).

  4. Đọ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.

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

Repo tương tự nên xem

Trợ lý & chat AI159K

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

VừaDockerPythonWindowsmacOS+1
Trợ lý & chat AI47,2K

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

VừaWebDockerWindowsmacOS+1
Trợ lý & chat AI89K

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

VừaWindowsmacOSLinuxiOS+2

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Trợ lý & chat AI

Trợ lý & chat AI85,6K

LobeHub

lobehub / lobehub

Không gian làm việc với nhiều tác tử AI (agent) làm cùng nhóm bạn, dùng đám mây hoặc tự cài bằng Docker

VừaWebDockerWindowsmacOS+1
Trợ lý & chat AI68,3K

AnythingLLM

Mintplex-Labs / anything-llm

Ứng dụng AI tất-cả-trong-một: chat với tài liệu của bạn, dùng agent, chạy cục bộ hoặc nối mô hình đám mây

DễWindowsmacOSLinuxDocker+1
Trợ lý & chat AI53,6K

Cherry Studio

CherryHQ / cherry-studio

Ứng dụng máy tính gom nhiều mô hình AI, agent, kho tri thức và dịch thuật vào một chỗ

DễWindowsmacOSLinuxAndroid+1
Trợ lý & chat AI47,7K

TextGen (text-generation-webui)

oobabooga / textgen

Ứng dụng chạy mô hình ngôn ngữ trên máy, giải nén là dùng, riêng tư tuyệt đối và không thu thập dữ liệu

VừaWindowsmacOSLinuxPython
Trợ lý & chat AI45,7K

Jan

janhq / jan

Ứng dụng thay thế ChatGPT mã nguồn mở, chạy mô hình AI ngay trên máy tính của bạn

DễWindowsmacOSLinux
Trợ lý & chat AI42,3K

Chatbox (Community Edition)

chatboxai / chatbox

Ứng dụng chat AI trên máy tính và điện thoại, nối ChatGPT, Claude, Gemini hay mô hình Ollama chạy trên máy

DễWindowsmacOSLinuxAndroid+2

Xem cả 18 repo Trợ lý & chat AI Về Kho Repo