Fay 数字人框架：从克隆到跑通只需 3 步，把大模型接进数字人

Fay 数字人框架：从克隆到跑通只需 3 步，把大模型接进数字人

【免费下载链接】Fayfay是一个帮助数字人（2.5d、3d、移动、pc、网页）或大语言模型（openai兼容、deepseek）连通业务系统的agent框架。项目地址: https://gitcode.com/GitHub_Trending/fay/Fay

Fay 数字人框架是一个让数字人和大语言模型连通业务系统的开源 Agent 框架，提供带货、助理、Agent 三个版本。适合想让数字人、大模型接入自己业务系统，做虚拟导购、交互助手或自主执行助手的开发者和产品人。

Fay 数字人框架是什么：定位与三个版本

Fay 把「数字人形象」和「大模型能力」解耦成一套可插拔的 Agent 框架，你不需要重造轮子，就能让数字人或纯大模型对接自己的业务。它同时覆盖 2.5D、3D、移动端、PC 端、网页端的数字人，也兼容 OpenAI 协议和 DeepSeek 等大语言模型。整个项目用三个独立分支来区分形态，你按需求选一个分支跑即可：

• 带货完整版（fay-sales-edition）：面向直播、商品问答等销售场景
• 助理完整版（fay-assistant-edition）：面向人机交互、可下发设备指令的助手
• Agent 版（fay-agent-edition）：面向能自主决策、调用工具的主动型智能体

Fay 怎么部署：三步快速上手

三步走通一个数字人服务：拿代码、改配置、起服务。注意 main 分支只是导航页，真正可运行的代码在上面三个版本分支里，所以第一步就要切到你需要的分支。

第一步 获取代码并切到对应版本

git clone https://gitcode.com/GitHub_Trending/fay/Fay

克隆后git checkout到目标版本分支（比如助理完整版fay-assistant-edition），再按requirements.txt装好 Python 依赖即可。

第二步 配置参数

打开项目里的 config.json，按需填入大模型名称与 API 密钥、语音合成（TTS）声音、以及要接入的识别/分析服务。改完保存，这一步决定数字人「说什么、怎么说话」。

第三步 启动服务

python main.py

运行 main.py 启动服务，系统会按配置加载形象与交互模型，随后你就能通过网页面板或语音、文字与数字人对话了。

Fay 数字人应用场景：上线后能做什么

同一个框架，三个版本对应三类典型落地场景，你可以按业务需要挑一个先跑通。

虚拟导购 / 直播带货（带货完整版）— 场景是直播带货与商品在线问答；你只需接上语音识别与弹幕、视频号监听，数字人就能自动回评、答疑并做违禁词检查；上线后可以实现 7×24 在线卖货，把重复的售前咨询交给系统处理。

人机交互数字人助理（助理完整版）— 场景是前台接待、课堂答疑或客服助手；你用语音或文字下指令，助理基于大模型应答，还能调用「开关设备」等工具；上线后得到一位既能答疑、又能执行简单操作、可按学习者反馈调整节奏的智能助手。

自主决策 Agent（Agent 版）— 场景是希望智能体主动干活，而不只是被动应答；它可以在 Python 执行器、网页检索器、本地知识库等工具之间自主决策并串联调用，还可以主动发消息联系；上线后数字人从「一问一答」升级为能规划并执行任务的智能体。

Fay 核心模块解析：config、core、ai_module

以下路径位于各版本分支（如助理完整版fay-assistant-edition），main 分支为导航页。看懂这三处，你就掌握了 Fay 的骨架：

• config.json— 全局配置中心，集中管理模型、语音、第三方服务的参数。
• core/— 核心运行逻辑，负责交互调度、内容数据库与问答服务等。
• ai_module/— AI 能力插件目录，语音识别、多种 TTS、各类大模型 NLP 都在这里按需接入。

Fay 数字人新手避坑提醒

三条最常见的坑，先记住能少走弯路：

• 先选版本再动手：main 分支不含运行代码，务必先checkout到带货 / 助理 / Agent 版本分支。
• 填好大模型配置：config.json里模型名、API 密钥、TTS 声音填错，容易出现白屏或无声音输出，改完记得重启服务。
• 依赖用 requirements.txt：用 Python 按requirements.txt安装依赖，避免 LangChain 等包版本不匹配报错。

收尾

Fay 数字人框架把「数字人 + 大模型 + 业务系统」这条链路做成了可插拔的三版本方案，从克隆到跑通只要三步，适合想快速落地数字人交互或自主 Agent 的你。现在选一个版本分支克隆下来，填入配置，让第一位数字人上岗吧。

【免费下载链接】Fayfay是一个帮助数字人（2.5d、3d、移动、pc、网页）或大语言模型（openai兼容、deepseek）连通业务系统的agent框架。项目地址: https://gitcode.com/GitHub_Trending/fay/Fay