Hugging Face 的标志

聊天 UI 文档

复制 HuggingChat

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

复制 HuggingChat

HuggingChat 的配置文件存储在 chart/env/prod.yaml 文件中。它是用于我们的 CI/CD 管道的环境变量的真实来源。对于 HuggingChat，由于我们需要自定义应用颜色以及基础路径，我们构建了一个自定义 Docker 镜像。你可以在这里找到工作流程。

如果你想更改 HuggingChat 生产环境中使用的模型配置，你应该在 chart/env/prod.yaml 中进行更改。

在本地运行 HuggingChat 副本

如果你想在本地运行 HuggingChat 的精确副本，你需要首先执行以下操作

  1. 在 hub 上创建一个 OAuth 应用，并具有 openid profile email 权限。确保将回调 URL 设置为类似 http://localhost:5173/chat/login/callback 的地址，该地址与你的本地实例的正确路径匹配。
  2. 使用你的 Hugging Face 账户创建一个 HF Token。你需要一个 Pro 账户才能访问 HuggingChat 提供的一些更大的模型。
  3. 在 serper.dev 创建一个免费账户（你将获得 2500 次免费搜索查询）
  4. 运行一个 MongoDB 实例，无论你想要如何运行。（本地或远程）

然后你可以创建一个新的 .env.SECRET_CONFIG 文件，其中包含以下内容

MONGODB_URL=<link to your mongo DB from step 4>
HF_TOKEN=<your HF token from step 2>
OPENID_CONFIG=`{
  PROVIDER_URL: "https://huggingface.co",
  CLIENT_ID: "<your client ID from step 1>",
  CLIENT_SECRET: "<your client secret from step 1>",
}`
SERPER_API_KEY=<your serper API key from step 3>
MESSAGES_BEFORE_LOGIN=<can be any numerical value, or set to 0 to require login>

然后你可以在 chat-ui 的根目录中运行 npm run updateLocalEnv。这将创建一个 .env.local 文件，该文件结合了 chart/env/prod.yaml 和 .env.SECRET_CONFIG 文件。然后你可以运行 npm run dev 来启动你的本地 HuggingChat 实例。

填充数据库

用于此脚本的 MONGODB_URL 将从 .env.local 中获取。确保它是正确的！该命令直接在数据库上运行。

你可以使用 populate 脚本使用虚假数据填充数据库

npm run populate <flags here>

必须至少指定一个标志，以下标志可用

  • reset - 重置数据库
  • all - 填充所有表
  • users - 填充用户表
  • settings - 填充现有用户的设置表
  • assistants - 填充现有用户的助手表
  • conversations - 填充现有用户的对话表

例如，你可以像这样使用它

npm run populate reset

来清除数据库。然后在应用中登录以创建你的用户，并运行以下命令

npm run populate users settings assistants conversations

以使用虚假数据填充数据库，包括你用户的虚假对话和助手。

< > 更新 在 GitHub 上

←架构