Chat UI 文档

在本地运行

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

在本地运行

对于非生产环境的用例,您可以在本地启动一个实例。对于生产环境的用例,请查看其他安装选项。

配置

Chat UI 的默认配置存储在 .env 文件中。您需要覆盖一些值才能在本地运行 Chat UI。首先,按照配置部分的说明,在仓库的根目录下创建一个 .env.local 文件。在本地运行 Chat UI 所需的最低配置如下

MONGODB_URL=<the URL to your MongoDB instance>
HF_TOKEN=<your access token> # find your token at hf.co/settings/token

数据库

聊天记录存储在 MongoDB 实例中,因此需要一个可用的数据库实例才能使 Chat UI 工作。

您可以使用本地的 MongoDB 实例。最简单的方法是使用 docker 启动一个带持久化存储的实例

docker run -d -p 27017:27017 -v mongo-chat-ui:/data --name mongo-chat-ui mongo:latest

在这种情况下,您的数据库 URL 将是 MONGODB_URL=mongodb://:27017

或者,您可以使用免费的 MongoDB Atlas 实例,Chat UI 应该可以轻松地在其免费套餐内运行。之后,您可以在 .env.local 中设置 MONGODB_URL 变量以匹配您的实例。

启动服务器

npm ci # install dependencies
npm run build # build the project
npm run preview -- --open # start the server with & open your instance at https://:4173
< > 在 GitHub 上更新