---

系列教程

▌ 【 教程一】Fay数字人 <带货版> 超详细教程在这里☟
Fay数字人＜带货版＞具体编译步骤，手把手带你避坑 | 多图预警 ( python 3.11 编译环境 超详细教程 )

▌ 【 教程二】Fay数字人 <助理版> 超详细教程在这里☟
Fay数字人＜助理版＞具体编译步骤，手把手带你避坑 | 多图预警 ( python 3.11 编译环境 超详细教程 )

环境描述

Python版本 ：3.11.7
pip 版本 ：23.3.1
Fay 版本 ：助理版

▶ 查看当前环境版本方式：
（看不懂的话，请移步该教程【Windows下anaconda下载安装教程，多图预警<步骤详细版>】的 <第三步：验证是否安装成功>）

---

一、搭建编译环境

1、下载anaconda

具体下载方式，请移步我的这篇教程:【Windows下anaconda下载安装教程，多图预警(步骤详细版)】

2、下载Fay(带货版)源码

Fay ：https://github.com/xszyou/Fay?tab=readme-ov-file

Fay 带货版：https://github.com/xszyou/Fay/tree/fay-sales-edition

Fay 助理版（该教程以助理版为例）：https://github.com/xszyou/Fay/tree/fay-assistant-edition

---

二、Fay编译+参数配置（手把手教学）

(一)Fay具体编译步骤

下载好git源码后，进行初步的编译，编译指令如下：(此处若有报错，请浏览下方的<报错情况一>，进行解决)

pip install -r requirements.txt

(二)配置 aliyun key

1、访问阿里云官网 https://www.aliyun.com 注册登录。

2、点击右上角<我的头像>，展出的菜单中有个<AccessKey管理>，点击它。

3、在 AccessKey 管理页面中，点击<创建AccessKey>

4、创建好后，会自动跳出以下界面，请复制并保存好自己的 AccessKey 和 Secret

(三)配置 aliyun 智能语音交互app

在搜索框中输入：智能语音交互，即可看到对应的app访问入口。
申请开通智能语音交互2.0功能（注意：免费试用期3个月，各位珍惜 (T ^ T ) ）

创建项目，输入信息后，点击<确定>完成创建
创建后，即可在该项目列表中看到app key，请保存，稍后配置需要使用到。

(四)修改并配置自己的FAY数字人参数

把刚才步骤三、四中保存的id和key 填写到项目目录文件 system.conf 里并保存
如图所示，填写时请注意一一对应。

(五)cmd运行Fay数字人

打开cmd命令终端，输入命令：(此处若有报错，请浏览下方的<报错情况二>，进行解决)

python main.py

最终，终于成功运行，运行界面如下：
【不知道为啥我的<面板娘>没有出现...带货版是正常的。后续排查一下，再给大家分享】

---

三、避坑手册（手把手教学）

报错情况一：编译安装requirements.txt文件时报错

▶ 报错内容①

ERROR: Could not find a version that satisfies the requirement azure-cognitiveservices-speech~=1.21.0 (from versions: 1.24.0, 1.24.1, 1.24.2, 1.25.0, 1.25.1b1, 1.26.0, 1.27.0, 1.28.0, 1.29.0, 1.30.0, 1.31.0, 1.32.1, 1.33.0, 1.34.0, 1.34.1, 1.35.0, 1.36.0)
ERROR: No matching distribution found for azure-cognitiveservices-speech~=1.21.0

▋ 原因分析：
azure-cognitiveservices-speech版本，在requirements.txt文件中，指定为了1.21.0版本。版本与当前环境下的python不匹配

▋ 解决方式：

搜索可知，与python3.11对应的版本应该为1.36.0。
所以，直接将requirements.txt文件中指定的azure-cognitiveservices-speech版本修改为1.36.0。

具体修改情况如图

---

▶ 报错内容②

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
conda-repo-cli 1.0.75 requires requests_mock, which is not installed.
gensim 4.3.0 requires FuzzyTM>=0.4.0, which is not installed.
conda 24.1.2 requires requests<3,>=2.28.0, but you have requests 2.26.0 which is incompatible.
conda-repo-cli 1.0.75 requires clyent==1.2.1, but you have clyent 1.2.2 which is incompatible.
conda-repo-cli 1.0.75 requires requests==2.31.0, but you have requests 2.26.0 which is incompatible.
jupyterlab-server 2.25.1 requires requests>=2.31, but you have requests 2.26.0 which is incompatible.
streamlit 1.30.0 requires requests<3,>=2.27, but you have requests 2.26.0 which is incompatible.

▋ 原因分析：
这个错误是由于pip的依赖解析器没有考虑到所有已安装的包，导致了依赖冲突。解决这个问题的方法有几种：

• 更新pip：可以尝试更新pip到最新版本，使用以下命令：pip install --upgrade pip。
• 清理缓存：有时候缓存可能会导致依赖冲突，可以尝试清理缓存，使用以下命令：pip cache purge。
• 使用虚拟环境：创建一个独立的虚拟环境，并在其中安装所需的包，以避免与全局环境中的包发生冲突。
• 手动解决依赖冲突：根据错误信息中提供的依赖冲突信息，手动安装或卸载相应的包，以解决依赖冲突。

▋ 解决方式：
我这里使用的是第二种：清理缓存的方式。

pip cache purge

清除缓存后，继续执行编译指令。

pip install -r requirements.txt

表示错误已消除，编译正常完成。具体操作和反馈如图：

报错情况二：运行程序，报错找不到’pydub’

▶ 报错内容：

ModuleNotFoundError: No module named 'pydub'

▋ 原因分析：
这是Python中的一个错误提示，表示找不到名为’pydub’的模块。'pydub’是一个用于处理音频文件的Python库，可以进行音频的剪切、合并、转换等操作。

要解决这个问题，可以按照以下步骤进行操作：

• 确保已经安装了’pydub’库。可以使用以下命令来安装：pip install pydub
• 如果已经安装了’pydub’库，但仍然出现这个错误，可能是因为你使用的Python环境与安装的库不匹配。你可以尝试在正确的Python环境中安装’pydub’库，或者检查是否有其他版本的’pydub’库与之冲突。

▋ 解决方式：
根据判断，我的报错是因为没有安装’pydub’库

输入命令进行安装

pip install pydub

具体操作和反馈如图：