xszyou/Fay

这是什么？

核心功能

• 01连接 2.5D、3D、移动、PC、网页等数字人与大语言模型及语音模型。
• 02支持 OpenAI 兼容接口及 DeepSeek 等 thinking 模型。
• 03ASR、TTS 等语音模型可自由替换。
• 04提供文字、语音、数字人驱动、管理控制、自动播报和意图等接口。
• 05支持唤醒、打断对话以及多用户多路并发。
• 06支持自定义知识库、问答对、人设信息及 MCP 工具管理。

适用场景

• 搭建虚拟教师、虚拟主播或新闻自动播报。
• 在网站或 App 中加入语音驱动的数字人助手。
• 通过统一接口把大语言模型接入已有业务系统。
• 在本地设备上运行全离线的语音与形象助手。

快速上手

1. 1

   安装 Python 3.12，Ubuntu 还需安装 build-essential 和 portaudio19-dev

2. 2

   从 requirements.txt 安装依赖

   pip install -r requirements.txt
3. 3

   使用公共配置中心启动项目（速度很慢，建议替换为自己的密钥）

   python main.py start -config_center d19f7b0a-2b8a-4503-8c0d-1a587b90eb69
4. 4

   在浏览器中访问 http://127.0.0.1:5000 打开管理页面

使用前须知

• !需要指定使用 Python 3.12。
• !默认的公共配置中心速度非常慢，建议配置自己的 API 密钥。
• !文档和社区资料主要托管在飞书上，并以中文为主。

标签

常见问题

Fay 是什么？

一个把数字人与大语言模型接入业务系统的 agent 框架，支持多终端接入。 Fay 是一个用于把数字人（虚拟形象）落地到实际产品中的框架。它向上适配多种数字人渲染技术，向下接入 OpenAI 兼容接口、DeepSeek 等大语言模型，并且可以方便地更换 ASR、TTS 等语音模型，便于组合出所需的语音与形象链路。

Fay 可以免费使用吗？用的什么许可证？

Fay 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

Fay 还在维护吗？

活跃维护中。Fay 最近一次提交是在 2026年9月21日。

Fay 适合用来做什么？

搭建虚拟教师、虚拟主播或新闻自动播报。 在网站或 App 中加入语音驱动的数字人助手。 通过统一接口把大语言模型接入已有业务系统。 在本地设备上运行全离线的语音与形象助手。

Fay 怎么安装和运行？

安装 Python 3.12，Ubuntu 还需安装 build-essential 和 portaudio19-dev 从 requirements.txt 安装依赖: pip install -r requirements.txt 使用公共配置中心启动项目（速度很慢，建议替换为自己的密钥）: python main.py start -config_center d19f7b0a-2b8a-4503-8c0d-1a587b90eb69 在浏览器中访问 http://127.0.0.1:5000 打开管理页面

在哪里获取 Fay？

源代码和安装说明在 GitHub 上：https://github.com/xszyou/Fay