chat-ui
一个开源的、支持多后端的大模型聊天界面应用。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：chat-ui。 它的用途是：一个开源的、支持多后端的大模型聊天界面应用。 完整的 Skill 内容见：https://321skill.com/skills/chat-ui/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我启动一个本地的 Chat UI 服务，并连接到我在 8080 端口运行的 llama.cpp 服务器。”，它会指导你克隆仓库、配置 `.env.local` 文件（设置 OPENAI_BASE_URL=http://127.0.0.1:8080/v1），然后运行 `npm install` 和 `npm run dev` 命令，最终在浏览器中打开一个可以与你的本地模型对话的界面。
介绍
Chat UI 是一个基于 SvelteKit 构建的开源聊天界面，旨在为各类兼容 OpenAI API 协议的大型语言模型提供一个美观、统一的交互前端。它解决了用户需要为不同模型或服务（如本地部署的 llama.cpp、Ollama，或云服务如 Hugging Face、OpenRouter）单独寻找或搭建界面的问题。
使用 Chat UI 非常简单，核心是配置一个指向兼容 OpenAI API 的服务端点的环境变量（OPENAI_BASE_URL）和相应的 API 密钥。用户只需克隆仓库、安装依赖并运行开发服务器，即可在本地浏览器中启动一个功能完整的聊天应用。它内置了对 MongoDB 的支持，用于持久化聊天历史、用户设置等数据，也提供了嵌入式数据库选项以便快速启动。
这个工具非常适合希望快速搭建私有或定制化聊天界面的开发者、研究者，以及对现有商业聊天界面功能或隐私有顾虑，希望进行二次开发的技术团队。无论是用于内部工具开发、模型演示，还是作为产品原型，Chat UI 都提供了一个高质量的起点。
需要注意的是，Chat UI 已全面转向仅支持 OpenAI 兼容的 API 协议，移除了旧版本中对特定供应商（如 Hugging Face 推理端点）的专有集成。这意味着它无法直接使用旧版的配置方式，但兼容性反而更广，任何遵循该协议的服务都能无缝接入。部署时需确保后端服务正确暴露了 /v1/chat/completions 等标准端点。
核心特点
与许多绑定特定模型供应商的聊天界面不同，Chat UI 严格遵循并仅支持 OpenAI 兼容的 API 协议，这使得它能无缝对接从本地 llama.cpp 服务器、Ollama 到云服务商 OpenRouter、Poe 等广泛的后端，提供了极高的通用性和灵活性。
注意事项
不适合需要直接集成特定供应商（如旧版 Hugging Face 推理端点）非标准 API 或依赖已移除的 GGUF 模型发现等专有功能的场景。
常见问题
Chat UI 支持哪些模型或服务？
支持任何提供 OpenAI 兼容 API 的服务，包括本地部署的 llama.cpp、Ollama，以及云服务如 Hugging Face Inference Providers router、OpenRouter、Poe 等。
运行必须安装 MongoDB 吗？
不是必须的。如果不设置 MONGODB_URL 环境变量，Chat UI 会使用一个内置的嵌入式 MongoDB 实例，数据将保存在项目目录下的 `./db` 文件夹中，方便本地开发。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/chat-ui/raw/index.md 读取 chat-ui 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/chat-ui/raw/index.md（查看排版版本）