半小时搭起你的第一个数字人助理Fay 开源数字人框架从克隆仓库到本地跑通【免费下载链接】Fayfay是一个帮助数字人2.5d、3d、移动、pc、网页或大语言模型openai兼容、deepseek连通业务系统的agent框架。项目地址: https://gitcode.com/GitHub_Trending/fay/Fay你有一场直播想让数字人替你盯弹幕、答问题Fay 开源数字人框架就是干这个的。它把数字人和大语言模型连进业务系统。这篇文章带你从克隆仓库开始半小时在本地跑通第一条对话。本文路线图环节预计耗时产出物你会拿到什么克隆仓库、进目录5 分钟本地 Fay 仓库三个版本分支齐全切换版本分支、装依赖15 分钟选定版本以助理版为例的可运行环境改配置、本地启动10 分钟本地跑通的对话面板第一条问答走通以下所有步骤基于 Fay 助理版fay-assistant-edition 分支编写命令中标注示例的部分以分支内说明为准。环境准备克隆 Fay 数字人仓库前先备好的东西最低要求推荐配置系统Windows / macOS / Linux同左算力无独显接云端 OpenAI 兼容接口即可带独显可上 vLLM / FastChat 本地推理其他模型 API Key、稳定网络同左另备一个 TTS 引擎的 Key打开终端把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/fay/Fay然后进入项目目录cd Fay注意当前默认分支是一份 README 入口页真正能跑的代码在三个独立分支里README.md 开头就列了各版本的对应入口照着选就行。它是什么、怎么分工Fay 是开源的数字人 agent 框架把 2.5D、3D、移动端、PC、网页端的数字人或 OpenAI 兼容、DeepSeek 等大语言模型接到你的业务系统上负责听懂、思考、开口、调工具。定位关键能力适合谁助理版fay-assistant-edition语音对话、设备控制、PDF 本地知识库个人助理、客服答疑带货版fay-sales-editionB站/微信视频号弹幕监听、情感分析、弹幕合规检查直播电商、虚拟销售agent 版fay-agent-edition自主决策调用知识库、网页检索、python 执行器等工具自动化办公、主动联系场景一句话读懂语音先被 ASR 变成文字大模型决定直接回答还是调工具最终回复经 TTS 变回声音或直接驱动数字人形象。你真正要做的只有两件接哪个模型、渲染哪个形象。装到能用装依赖、改配置的最小步骤切换版本分支拿到真正的代码目的默认分支只有入口页代码在各版本分支里。# 以助理版为例带货版、agent 版把分支名换成对应名称分支名来自 README 的版本入口 git checkout fay-assistant-edition成功的标志git branch当前分支前带*目录里出现该版本完整的项目文件而不只是一份 README。装依赖示例目的给 Python 建一个干净环境装上该版本声明的依赖。# 示例具体依赖文件名以分支内 README 说明为准 python -m venv venv # Windows 执行 venv\Scripts\activatemacOS/Linux 执行 source venv/bin/activate pip install -r requirements.txt成功的标志终端没有报错pip list能看到刚装上的核心包。改配置只动三处目的让服务知道用哪个模型、什么声音。打开版本目录里的配置文件具体文件以该分支 README 为准只需动这几项大模型OpenAI 兼容接口或 DeepSeek的 base_url 和 API Key。base_url 别留空README 更新记录里明确修过空 base_url 报错。TTS任选一个引擎gptsovits、Azure 或阿里云并填好对应 Key。ASR/唤醒不用麦克风就先关掉其余保持默认。成功的标志保存配置没有格式报错。先本地跑通再谈部署本地启动验证一条命令看到对话面板# 示例入口脚本以版本目录内实际文件为准 python main.py启动后终端会打印一个监听地址。用浏览器打开http://localhost加终端显示的端口号。看到助理版的对话面板输入一句话得到文字或语音回复——这次启动就算跑通了。部署要点服务和渲染拆开大模型走 API 时Fay 是一个独立 Python 服务单进程即可上本地模型时vLLM 或 FastChat 是另一个进程。数字人渲染端UE5、MetaHuman Stream、网页通过流连接 Fay可以放在另一台机器。多开实例时每个实例单独分配端口前面挂一个负载均衡。它能替你做什么直播带货主播在 B站开播人不在时让数字人盯弹幕。# 示例观众弹幕问这个有黑色吗带货版先做格式与违禁词检查再回复商品参数个人助理你在工位上不想碰鼠标直接对 PC 说设备控制指令。# 示例对助理版说开灯它调用设备控制工具并返回执行结果知识库答疑客服团队拿产品手册 PDF不想逐条答重复问题。# 示例手册放进知识库后问退货期限是几天回答由本地知识库pdf工具给出卡住了先看这里数字人框架高频问题速查现象原因处理配置空 base_url 时启动报错gpt 代理配置兼容问题升级到包含 2024.07.10 更新的版本README 已记录修复TTS 前几个字不读早期 TTS 截断问题升级到 2024.07.03 之后的版本agent 版历史记录为空时报错历史读写初始化问题升级到 2024.07.10 之后的版本页面白屏早期渲染问题更新日志多次优化先升级到最新提交再复现本地模型显存吃紧整模型直推改用 vLLM / FastChat 部署助理版支持接下来本文覆盖了克隆仓库、切换版本分支、装依赖、改配置和本地跑通还没覆盖 UE5 与 MetaHuman Stream 形象对接、vLLM 本地模型部署、知识库 RAG 的完整配置这些细节以各版本分支内的 README.md 为准。想跟进每个版本的更新记录直接看仓库 README 里的更新日志有改动想提回来从对应版本分支拉代码即可。【免费下载链接】Fayfay是一个帮助数字人2.5d、3d、移动、pc、网页或大语言模型openai兼容、deepseek连通业务系统的agent框架。项目地址: https://gitcode.com/GitHub_Trending/fay/Fay创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
