diff --git a/README.md b/README.md index d86e825..af744d6 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,90 @@ -1.本项目需要下载 Audio2Face-3D-Samples -https://github.com/NVIDIA/Audio2Face-3D-Samples?tab=readme-ov-file 放到 根目录 external/ 目录下 -2.虚拟环境创建 a2f_venv -python -m venv a2f_venv -.\a2f_venv\Scripts\Activate.ps1 -3.导航到service\a2f_api目录安装依赖 -pip install -r requirements.txt -4.运行服务 -python app.py +# Audio2Face Python Service -5.打开案例目录 examples\3d\ 控制台输入live-server index.html 即可打开案例 \ No newline at end of file +这是一个基于NVIDIA Audio2Face的Python服务项目,提供音频到面部表情的转换功能,支持3D模型实时表情驱动。 + +## 项目结构 + +``` +pyservice/ +├── examples/ # 示例代码和资源 +├── scripts/ # 工具脚本 +├── services/ # 核心服务实现 +└── external/ # 外部依赖库(需手动下载) +``` + +## 快速开始 + +### 1. 下载外部依赖 + +请下载NVIDIA Audio2Face-3D-Samples并放置到项目根目录的`external/`文件夹中: + +```bash +git clone https://github.com/NVIDIA/Audio2Face-3D-Samples.git external/Audio2Face-3D-Samples +``` + +或直接下载并解压到`external/`目录: + + +### 2. 创建虚拟环境 + +```bash +# 创建虚拟环境 +python -m venv a2f_venv + +# 激活虚拟环境(Windows) +a2f_venv\Scripts\Activate.ps1 + +# 激活虚拟环境(Linux/Mac) +# source a2f_venv/bin/activate +``` + +### 3. 安装依赖 + +导航到服务目录并安装所需依赖: + +```bash +cd services/a2f_api +pip install -r requirements.txt +``` + +### 4. 运行服务 + +```bash +# 在services/a2f_api目录下运行 +python app.py +``` + +### 5. 查看示例 + +打开3D示例目录并启动本地服务器: + +```bash +cd examples/3d +live-server index.html +``` + +然后在浏览器中访问显示的URL即可查看3D表情驱动示例。 + +## 主要功能 + +- 音频到面部表情转换服务 +- 文本转语音集成 +- 3D模型实时表情驱动 +- 支持多种表情数据格式 + +## 技术栈 + +- Python +- Flask/FastAPI (API服务) +- Babylon.js (3D渲染示例) +- NVIDIA Audio2Face技术 + +## 注意事项 + +- 确保已安装最新版本的Python 3.7+ +- 部分功能可能需要NVIDIA GPU支持 +- 首次运行可能需要较长时间加载模型 + +## 联系方式 + +如有问题或建议,请联系项目维护人员。 \ No newline at end of file