ClaraVerse

环境要求

• Linux 或 macOS（使用一键安装脚本）
• Docker 与 Docker Compose（使用 Docker Compose 部署）
• 可选：本机运行 Ollama 或 LM Studio 以使用本地模型
• 开发模式另需 Go 1.24+、Node.js 20+、Docker

安装与启动步骤

1. 1一键安装

   Linux/macOS 用户可执行官方脚本完成安装并初始化 ClaraVerse，脚本会自动下载 CLI 并运行 claraverse init。

   curl -fsSL https://raw.githubusercontent.com/claraverse-space/ClaraVerse/main/cli/install.sh | bash && claraverse init

   复制

2. 2克隆仓库

   使用 Docker Compose 方式部署时，先把 ClaraVerse 仓库克隆到本地并进入目录。

   git clone https://github.com/claraverse-space/ClaraVerse.git
   cd ClaraVerse

   复制

3. 3启动容器

   用生产用 compose 文件在后台启动全部服务，注意必须带 -f 指定 docker-compose.production.yml。

   docker compose -f docker-compose.production.yml up -d

   复制

4. 4访问并注册

   浏览器打开 http://localhost:3000，注册账号；第一个注册的用户会成为管理员，之后即可开始对话。

5. 5连接本地模型

   若本机已有 Ollama，ClaraVerse 会自动检测并导入全部模型，无需额外配置。

   OLLAMA_HOST=0.0.0.0

   复制

6. 6准备开发环境

   参与代码贡献时需先安装 Go 1.24+、Node.js 20+ 和 Docker，README 未给出更多开发命令。

关键配置

如何确认成功

浏览器能打开 http://localhost:3000 并出现注册/登录页面，注册后进入聊天界面即成功。

常见问题

注意事项

• 使用 Docker Compose 时必须带 -f docker-compose.production.yml，否则不会启动生产配置。
• 一键安装脚本仅适用于 Linux 和 macOS。
• 需要 Docker 与 Docker Compose 已安装并可用（开发模式还需 Go 1.24+ 与 Node.js 20+）。
• 聊天默认本地存储，开启加密同步前请确认自托管环境安全。