【亲测免费】 ZcChat开源项目安装与配置指南

ZcChat开源项目安装与配置指南

1. 项目基础介绍

ZcChat 是一个模仿Galgame效果的AI桌宠项目，它具有长期记忆、表情动作立绘显示、操控电脑和语音功能，非常适合作为Galgame角色的AI伴侣。该项目的主要编程语言是 C++，同时也使用了 CMake 进行构建管理。

2. 项目使用的关键技术和框架

• AI模型：使用 Letta 框架来实现 AI 长期记忆和个性拓展。
• 图形界面：采用 Qt 框架进行图形界面的设计和实现。
• 语音合成：通过 vits-simple-api 或其他语音合成工具来生成语音。
• 语音识别：使用 whisper-asr-webservice 或百度语音识别来实现语音输入。
• JSON处理：使用 nlohmann/json 库来解析和处理 JSON 数据。

3. 项目安装和配置的准备工作及详细步骤

准备工作

• 确保你的系统中安装了 CMake、Qt 和相应的开发环境。
• 准备好 Git 用于克隆项目代码。
• 确保你的系统支持 C++ 和所需的第三方库。

安装步骤

步骤1：克隆项目

首先，需要从 GitHub 克隆项目代码到本地：

git clone https://github.com/Zao-chen/ZcChat.git
cd ZcChat

步骤2：安装依赖

项目可能需要一些第三方依赖，你可以根据项目文档或 README.md 中的说明来安装这些依赖。

步骤3：构建项目

使用 CMake 来构建项目：

mkdir build
cd build
cmake ..
make

步骤4：运行项目

编译完成后，进入 build 目录，找到生成的可执行文件并运行：

./ZcChat

配置步骤

• 配置角色：根据项目 README.md 中的“Step 2 - 配置角色”部分，将角色数据中的立绘放入对应的文件夹，并在 ZcChat 中进行配置。
• 安装配置LLM模型：按照“Step 3- 安装配置LLM模型”的说明，安装 Letta 或其他 LLM 模型，并在 ZcChat 中进行相应的配置。
• 安装配置语音合成：根据“（可选）安装配置语音合成”部分的说明，选择合适的方法安装并配置语音合成工具。
• 配置语音输入：按照“（可选）配置语音输入”部分的步骤，设置语音输入。
• 配置语音唤醒和打断：根据“（可选）配置语音唤醒和打断”的说明进行配置。

完成以上步骤后，ZcChat 应该能够正常运行，并且可以根据你的需要进行个性化的配置和扩展。