# 女娲

**Repository Path**: jiangboran/nuwa

## Basic Information

- **Project Name**: 女娲
- **Description**: 数字克隆
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 3
- **Created**: 2026-03-23
- **Last Updated**: 2026-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 数字克隆工具 | Digital Clone Tool
全本地离线运行的个人数字克隆工具，一键导入微信/QQ聊天记录，生成复刻你或指定联系人说话风格的AI替身，支持文字+语音双向交互，全程数据本地存储，绝对隐私安全。
## ✨ 核心特性
### 🔒 隐私第一
- 🚫 100% 全离线运行，所有数据（聊天记录、语音、模型）只存在本地，绝对不上传任何服务器
- 🔐 克隆包支持加密导出，只有知道密码才能导入
- 🧹 自动清理临时文件，不会残留任何隐私数据
### 📱 全平台支持
- 💻 Windows/Mac/Linux 全平台桌面端支持
- 📱 iOS/Android 移动端支持，扫码导入克隆包即可全离线使用
- ☁️ 支持部署到服务器作为在线服务使用
### 🎤 语音功能
- 🎙️ 支持一键导出微信/QQ语音消息，自动转码为训练格式
- 🧬 集成 GPT-SoVITS，一键训练专属声纹模型，复刻本人/联系人的声音
- 🗣️ AI回复自动语音合成，和真人说话一模一样
- 🎧 支持语音输入，离线转文字，不用打字也能聊
### 💬 聊天功能
- 🔍 基于 RAG 向量检索，回复完全符合历史聊天习惯和风格
- 🎨 支持两种聊天界面风格：微信/QQ，和原生聊天体验一致
- 📝 支持自定义人设、回复风格、聊天规则
- 🔄 支持同时管理多个AI克隆，自由切换
### 📦 多端同步
- 📦 一键导出加密 `.clone` 格式克隆包，包含所有数据（向量库、声纹模型、配置）
- 📲 电脑端生成二维码，手机端扫码直接导入，无需网络
- 💾 单个克隆包大小几百MB到3GB，可拷到U盘、硬盘任意传输
## 🚀 快速开始
### 环境要求
- Python 3.10 ~ 3.12
- ffmpeg（语音处理必须，[下载地址](https://ffmpeg.org/download.html)，安装后添加到环境变量）
- 推荐配置：16G内存 + NVIDIA GPU（声纹训练加速用，CPU也能运行只是速度慢）
### 安装步骤
```bash
# 1. 克隆仓库
git clone https://github.com/jiangboran/digital-clone-tool.git
cd digital-clone-tool
# 2. 安装Python依赖
# 推荐：国内用户用清华源+旧版解析器，速度快不卡顿
pip install -r requirements.txt --use-deprecated=legacy-resolver -i https://pypi.tuna.tsinghua.edu.cn/simple
# 国外用户可以直接用默认命令
# pip install -r requirements.txt
# 3. 启动程序
python main.py
```
启动后浏览器会自动打开界面，默认地址是 `http://127.0.0.1:7860`
## 📖 使用指南
### 1. 导出聊天记录
1. 打开微信/QQ PC版，登录你的账号
2. 选择要导出的会话（生成对方AI请只选1个1v1会话）
3. 勾选是否导出语音消息，点击「开始导出」
4. 等待导出完成，程序会自动清洗垃圾消息、拼接上下文对话片段
### 2. 构建AI克隆
1. 选择生成目标：「生成自己的AI」/「生成对方的AI」
2. 填写基本信息：昵称、个人简介、说话风格、自定义规则
3. 选择模型类型：本地模型（推荐，全离线）/ 云端API（需自行配置API Key）
4. 点击「开始构建AI」，等待向量库构建完成
### 3. 聊天
1. 切换到「聊天」页，选择聊天风格（微信/QQ）
2. 输入文字或点击麦克风语音输入，AI会按照复刻的风格回复
3. 开启「自动播放语音回复」即可听到复刻的声音
### 4. 导出克隆包（用于移动端导入）
1. 构建完AI后点击「导出克隆包」
2. 可设置加密密码（可选）
3. 生成后扫码下载克隆包，或本地拷贝`.clone`文件到手机
### 5. 移动端使用
1. 安装移动端APP
2. 扫码或本地选择克隆包导入
3. 全离线即可聊天，无需网络
## ⚠️ 重要说明
### 隐私声明
本工具仅允许个人自用，禁止使用他人聊天记录、语音生成AI用于任何非法用途，所有隐私数据由用户自行负责保管。
### 声纹训练要求
- 至少需要 300秒（5分钟） 以上清晰、无背景噪音的有效语音才能达到较好的效果
- 语音数量越多、质量越好，生成的声纹模型相似度越高
- 训练时间：CPU约30分钟~2小时，NVIDIA GPU约5~20分钟
### 法律提示
- 声纹克隆功能仅允许个人使用，禁止用于诈骗、冒充他人等非法用途
- 生成他人AI需获得对方同意，禁止未经授权使用他人聊天记录、语音生成AI
- 因使用本工具产生的法律纠纷由使用者自行承担
## 🛠️ 技术栈
| 模块 | 技术栈 |
| --- | --- |
| 后端 | Python 3.10+ |
| 前端界面 | Gradio |
| 聊天记录导出 | WeChatExporter / QQExporter |
| 向量数据库 | Chroma |
| LLM推理 | LangChain + 本地大模型 / 云端API |
| 语音转文字 | OpenAI Whisper |
| 声纹训练/合成 | GPT-SoVITS |
| 移动端 | Flutter + 移动端LLM推理框架 |
## 📝 更新日志
### v1.8（2026-03-20）
- ✅ 新增全本地离线语音输入功能，基于Whisper实现语音转文字
- ✅ 优化UI界面，支持微信/QQ两种聊天风格切换
- ✅ 新增克隆包导出导入功能，支持电脑手机跨端同步
- ✅ 新增Flutter移动端基础框架，支持全离线运行
- ✅ 完善异常处理，增加ffmpeg环境自动检测
- ✅ 新增QQ语音导出支持，自动转码为WAV格式
### v1.0（2026-03-19）
- ✅ 基础功能上线，支持微信/QQ聊天记录导出
- ✅ 支持数据清洗、RAG向量库构建
- ✅ 支持语音导出、声纹训练、语音合成
- ✅ 基础Gradio界面开发完成
## 🤝 贡献
欢迎提交Issue和PR，一起完善功能！
## 📄 开源协议
本项目仅供个人学习使用，禁止商用，禁止用于非法用途。