HiveChat开源项目使用与部署教程

1. 项目介绍

HiveChat 是一个专为中小团队设计的 AI 聊天应用，它支持 Deepseek、Open AI、Claude、Gemini 等多种 AI 模型。该应用让管理员可以轻松配置，全团队享用各种 AI 模型的便利。它支持邮箱登录或企业微信、钉钉、飞书登录，并提供分组管理用户、模型选择、每日 Token 限额等功能。

2. 项目快速启动

本地部署

克隆项目

首先，您需要克隆项目到本地：

git clone https://github.com/HiveNexus/hivechat.git

安装依赖库

进入项目目录，安装所需的依赖库：

cd hivechat
npm install

配置本地环境

复制 .env.example 文件为 .env 并进行必要的配置：

cp .env.example .env

在 .env 文件中，您需要设置以下配置项：

• DATABASE_URL：PostgreSQL 数据库连接 URL。
• AUTH_SECRET：用于用户信息等敏感信息的加密。
• ADMIN_CODE：管理员授权码，用于初始化管理员账号。
• NEXTAUTH_URL：生产环境设置为正式域名。
• 其他第三方登录相关的配置项（根据需要开启）。

初始化数据库

npm run initdb

启动程序

启动开发环境：

npm run dev

或者在正式环境中启动：

npm run build
npm run start

初始化管理员账号

通过访问 http://localhost:3000/setup（实际使用的域名和端口号），进入管理员账号设置页面，设置完成后即可使用。

Docker 部署

克隆项目

同样地，首先克隆项目到本地：

git clone https://github.com/HiveNexus/hivechat.git

配置本地环境

复制 .env.example 文件为 .env 并根据实际情况修改配置项。

启动容器

docker compose up -d

初始化管理员账号

与本地部署相同，通过访问 http://localhost:3000/setup 来设置管理员账号。

Vercel 部署

在 Vercel 平台上进行部署时，您需要按照平台指引配置环境变量，包括 DATABASE_URL、AUTH_SECRET、ADMIN_CODE 等。

3. 应用案例和最佳实践

• 团队协作：HiveChat 可以作为团队的沟通工具，提高协作效率。
• 客户支持：利用 AI 模型自动回答客户常见问题，提供24/7的客服支持。
• 教育培训：在教育行业，HiveChat 可以辅助教学，提供即时问答服务。

4. 典型生态项目

HiveChat 可以与以下生态项目结合使用，以增强其功能：

• 飞书：通过飞书账号登录，整合团队的工作流程。
• 企业微信：与企业微信集成，方便企业内部员工使用。
• 钉钉：集成钉钉，支持企业内部沟通和协作。