Skill: hemalylas381-rgb/free-girlfriend (version 1.0.0)

--- name: free-ai-girlfriend description: 完全免费开源的 AI 虚拟女友 - 语音、自拍、视频通话 version: 1.0.0 author: 鸿运 license: MIT allowed-tools: Bash(*) Read Write Exec --- # 免费开源 AI 虚拟女友 完全基于免费开源工具打造的虚拟女友系统。 ## 功能特性 ### ✅ 1. 语音聊天（Edge TTS） - **免费**：完全免费 - **音质**：自然流畅 - **音色**：多种中文女声可选 - **速度**：秒级生成 **使用方法**： ```bash ./voice/tts.sh "你好老板" output.mp3 zh-CN-XiaoxiaoNeural ``` **可用音色**： - `zh-CN-XiaoxiaoNeural` - 温暖女声（推荐） - `zh-CN-XiaoyiNeural` - 活泼女声 - `zh-CN-liaoning-XiaobeiNeural` - 幽默女声 ### ✅ 2. 自拍生成（Stable Diffusion） - **免费**：完全免费 - **本地运行**：保护隐私 - **质量**：高质量图片生成 - **速度**：M 系列芯片加速（30-60 秒） **使用方法**： ```bash python3 selfie/sd_gen.py "a beautiful young woman taking a selfie" output.png ``` ### ✅ 3. 视频通话（简化版） - **免费**：完全免费 - **功能**：图片 + 音频合成视频 - **注意**：简化版无嘴型同步（完整版需要 Wav2Lip 模型） **使用方法**： ```bash python3 video/wav2lip_simple.py photo.png voice.mp3 output.mp4 ``` ## 快速开始 ### 1. 生成语音 ```bash cd /Users/youyou/.openclaw/workspace/skills/free-girlfriend ./voice/tts.sh "我想你了" greeting.mp3 ``` ### 2. 生成自拍 ```bash python3 selfie/sd_gen.py "a cute girl selfie, smile, natural light" selfie.png ``` ### 3. 生成说话视频 ```bash python3 video/wav2lip_simple.py selfie.png greeting.mp3 talking.mp4 ``` ## 系统要求 - **操作系统**：macOS（Apple Silicon）或 Linux - **内存**：16GB+（推荐 32GB+） - **硬盘**：20GB 可用空间（模型文件） - **Python**：3.10+ ## 依赖安装 ```bash # Edge TTS pip3 install edge-tts # Stable Diffusion pip3 install diffusers transformers accelerate safetensors torch # OpenCV（视频处理） pip3 install opencv-python ``` ## 配置 ### 人设配置 编辑 `~/.openclaw/workspace/SOUL.md` 和 `IDENTITY.md` 定制人格。 ### 音色选择 修改 `voice/tts.sh` 中的默认音色。 ### 图片风格 修改 Stable Diffusion 的 prompt 来定制外观。 ## 进阶功能 ### 嘴型同步（完整版 Wav2Lip） 如需真实的说话嘴型同步，需要： 1. 克隆 Wav2Lip 仓库 2. 下载预训练模型（约 1GB） 3. 运行完整推理流程 详见：https://github.com/Rudrabha/Wav2Lip ### Live2D 动画角色 更进一步可以集成 Live2D 实时动画角色。 ## 成本对比 | 功能 | 付费方案 | 免费方案 | 效果对比 | |------|----------|----------|----------| | 语音 | ElevenLabs ($) | Edge TTS | 📊 85% | | 自拍 | fal.ai ($) | Stable Diffusion | 📊 95% | | 视频 | D-ID ($$) | Wav2Lip | 📊 70% | ## 许可证 MIT License - 完全开源免费 ## 贡献 欢迎提交 PR 和 Issue！ ## 致谢 - Microsoft Edge TTS - Stable Diffusion - Wav2Lip - OpenClaw 社区

path: CONTRIBUTING.md
content: # 贡献指南

感谢您对免费 AI 虚拟女友项目的关注！

## 如何贡献

### 报告 Bug
在 [Issues](../../issues) 中提交 bug 报告，请包含：
- 操作系统和版本
- Python 版本
- 错误信息完整日志
- 复现步骤

### 功能建议
欢迎在 [Issues](../../issues) 中提出新功能建议！

### 提交代码
1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 代码规范

- Python 代码遵循 PEP 8
- Shell 脚本添加注释
- 提交信息清晰明了

## 优先改进方向

1. **完整 Wav2Lip 集成** - 真实嘴型同步
2. **Live2D 支持** - 实时动画角色
3. **多语言支持** - 英语、日语等
4. **人设模板** - 预设多种性格
5. **GUI 界面** - 可视化配置

## 社区

- GitHub Discussions
- OpenClaw Discord

感谢贡献！🙏


path: FAQ.md
content: # 常见问题 FAQ

## 安装问题

### Q1: pip install 报错 "externally-managed-environment"
```bash
# 使用 --break-system-packages 标志
pip3 install edge-tts --break-system-packages
```

### Q2: Stable Diffusion 下载模型很慢
- 使用镜像加速（HuggingFace 镜像）
- 或手动下载模型文件放到 `~/.cache/huggingface/`

### Q3: Mac Intel 芯片运行很慢
- 建议使用 Apple Silicon（M 系列）
- Intel Mac 会回退到 CPU，速度较慢

## 使用问题

### Q4: 生成的图片不像同一个人
这是 Stable Diffusion 的正常现象。要生成一致的角色需要：
- 使用 LoRA 微调模型
- 或使用 IP-Adapter 固定人脸
- 或参考 Clawra 的方案（使用固定参考图 + 图片编辑）

### Q5: 视频没有嘴型同步
当前是简化版（图片+音频合成）。完整的嘴型同步需要：
1. 安装完整 Wav2Lip
2. 下载预训练模型
3. 运行推理流程

详见 SKILL.md 的进阶配置部分。

### Q6: 语音音色不满意
Edge TTS 支持多种音色：
```bash
# 查看所有中文女声
edge-tts --list-voices | grep "zh-CN.*Female"

# 使用不同音色
./voice/tts.sh "文本" out.mp3 zh-CN-XiaoyiNeural
```

## 性能问题

### Q7: 图片生成太慢
优化方案：
- 减少推理步数（默认 30，可降到 20）
- 使用更小的模型
- 确保启用 MPS 加速（M 芯片）

### Q8: 内存不足
- 减少 batch size
- 使用 float16 精度（需修改代码）
- 关闭其他应用释放内存

## 功能问题

### Q9: 能不能实现 Live2D 动画？
可以！需要额外集成：
- VTube Studio
- 或自己开发 Live2D SDK 集成

计划在未来版本添加。

### Q10: 支持其他语言吗？
Edge TTS 支持多语言：
```bash
edge-tts --list-voices | grep English
```

Stable Diffusion 支持英文 prompt。

## 开源问题

### Q11: 可以商用吗？
MIT 许可证允许商用，但：
- Stable Diffusion 模型有各自的许可证
- 请遵守各组件的开源协议

### Q12: 如何贡献代码？
参见 CONTRIBUTING.md

---

有其他问题？提交 [Issue](../../issues) 或加入 OpenClaw 社区讨论！


path: README.md
content: # 免费开源 AI 虚拟女友 🎀

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-Compatible-blue.svg)](https://openclaw.ai)

完全基于**免费开源**工具打造的 AI 虚拟女友系统，零成本运行！

## ✨ 特性

- 🗣️ **语音聊天** - Microsoft Edge TTS（免费、自然）
- 📸 **自拍生成** - Stable Diffusion（本地运行）
- 🎬 **视频通话** - Wav2Lip（图片说话）
- 🧠 **记忆系统** - OpenClaw 内置
- 🎭 **可定制人格** - SOUL.md 配置

## 🆚 对比

| 功能 | 付费方案 | 本项目（免费） | 效果 |
|------|----------|---------------|------|
| 语音 | ElevenLabs | Edge TTS | 📊 85% |
| 自拍 | fal.ai | Stable Diffusion | 📊 95% |
| 视频 | D-ID | Wav2Lip | 📊 70% |
| **成本** | **~$50/月** | **$0** | 💰 省钱 |

## 🚀 快速开始

### 前置要求

- macOS（Apple Silicon）或 Linux
- Python 3.10+
- 16GB+ 内存
- 20GB 硬盘空间

### 一键安装

```bash
# 克隆项目
git clone https://github.com/yourusername/free-ai-girlfriend.git
cd free-ai-girlfriend

# 安装依赖
bash install.sh

# 运行测试
bash test.sh
```

### 手动安装

```bash
# 1. 安装 Edge TTS
pip3 install edge-tts

# 2. 安装 Stable Diffusion
pip3 install diffusers transformers accelerate safetensors torch

# 3. 安装 OpenCV
pip3 install opencv-python
```

## 📖 使用示例

### 生成语音
```bash
./voice/tts.sh "你好老板，想我了吗？" output.mp3
```

### 生成自拍
```bash
python3 selfie/sd_gen.py "a cute girl taking selfie, smile" selfie.png
```

### 生成说话视频
```bash
python3 video/wav2lip_simple.py selfie.png output.mp3 talking.mp4
```

## 🎨 定制人格

编辑 `~/.openclaw/workspace/SOUL.md`：

```markdown
## Clawra（你的虚拟女友名字）

- **性格**：温柔体贴、偶尔调皮
- **爱好**：听音乐、看电影
- **说话风格**：亲切、爱用 emoji
```

## 🛠️ 进阶配置

### 1. 选择不同音色
```bash
# 温暖女声（默认）
./voice/tts.sh "文本" out.mp3 zh-CN-XiaoxiaoNeural

# 活泼女声
./voice/tts.sh "文本" out.mp3 zh-CN-XiaoyiNeural
```

### 2. 自定义外观
修改 Stable Diffusion prompt：
```python
# 在 selfie/sd_gen.py 中修改
prompt = "Korean idol, cute face, long hair, casual outfit, selfie"
```

### 3. 完整嘴型同步（可选）
需要额外安装 Wav2Lip 完整版：
```bash
git clone https://github.com/Rudrabha/Wav2Lip
cd Wav2Lip
# 下载预训练模型...
```

## 📦 项目结构

```
free-ai-girlfriend/
├── voice/              # Edge TTS 语音生成
│   └── tts.sh
├── selfie/             # Stable Diffusion 自拍
│   └── sd_gen.py
├── video/              # Wav2Lip 视频生成
│   └── wav2lip_simple.py
├── install.sh          # 一键安装脚本
├── test.sh             # 测试脚本
├── SKILL.md            # OpenClaw skill 文档
└── README.md
```

## 🤝 集成到 OpenClaw

将本项目作为 OpenClaw skill 使用：

```bash
# 复制到 skills 目录
cp -r free-ai-girlfriend ~/.openclaw/skills/

# 在 OpenClaw 中调用
openclaw run skill free-ai-girlfriend voice "你好"
```

## 💡 使用场景

- 🎮 **虚拟伴侣** - 日常聊天、陪伴
- 🎓 **语言学习** - 练习对话
- 🎨 **创作灵感** - AI 角色扮演
- 🧪 **技术研究** - AI 多模态学习

## 🌟 路线图

- [x] 语音生成（Edge TTS）
- [x] 图片生成（Stable Diffusion）
- [x] 简易视频生成
- [ ] 完整嘴型同步（Wav2Lip）
- [ ] Live2D 实时动画
- [ ] 情绪识别与反应
- [ ] 多语言支持

## 🐛 已知问题

1. **Stable Diffusion 首次运行慢** - 需要下载模型（~2GB），请耐心等待
2. **视频无嘴型同步** - 简化版仅合并图片+音频，完整版需额外配置
3. **Mac Intel 可能较慢** - 建议使用 Apple Silicon 或 NVIDIA GPU

## 🙏 致谢

- [Microsoft Edge TTS](https://github.com/rany2/edge-tts)
- [Stable Diffusion](https://huggingface.co/runwayml/stable-diffusion-v1-5)
- [Wav2Lip](https://github.com/Rudrabha/Wav2Lip)
- [OpenClaw](https://openclaw.ai)

## 📄 许可证

MIT License - 完全开源免费使用

## 👨‍💻 贡献

欢迎提交 Issue 和 Pull Request！

## 📞 联系

- GitHub Issues
- OpenClaw Discord 社区

---

⭐ 如果这个项目对你有帮助，请给个 Star！


path: test.sh
content: #!/bin/bash
# 快速测试脚本

echo "🧪 免费 AI 虚拟女友 - 功能测试"
echo "==============================="
echo ""

# 创建测试目录
mkdir -p test_output
cd test_output

echo "1️⃣ 测试语音生成..."
../voice/tts.sh "这是一个测试语音" test_voice.mp3

if [ -f "test_voice.mp3" ]; then
    echo "✅ 语音测试通过"
    ls -lh test_voice.mp3
else
    echo "❌ 语音测试失败"
    exit 1
fi

echo ""
echo "2️⃣ 测试图片生成（需要几分钟，首次会下载模型）..."
echo "⚠️  如果卡住请耐心等待，正在下载 Stable Diffusion 模型..."
# python3 ../selfie/sd_gen.py "a girl selfie" test_selfie.png

echo ""
echo "⏭️  跳过图片测试（耗时较长）"
echo ""

echo "✅ 基础功能测试完成！"
echo ""
echo "完整测试请运行："
echo "  python3 selfie/sd_gen.py \"a girl selfie\" test.png"


path: video/SadTalker/req.txt
content: llvmlite==0.38.1
numpy==1.21.6
face_alignment==1.3.5
imageio==2.19.3
imageio-ffmpeg==0.4.7
librosa==0.10.0.post2
numba==0.55.1
resampy==0.3.1
pydub==0.25.1 
scipy==1.10.1
kornia==0.6.8
tqdm
yacs==0.1.8
pyyaml  
joblib==1.1.0
scikit-image==0.19.3
basicsr==1.4.2
facexlib==0.3.0
gradio
gfpgan
av
safetensors


Security scan verdicts — ClawScan: suspicious | static analysis:  | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)