Fay 是一款开放源代码的 MCP 框架，旨在实现“数字人”（包括 2.5D、3D、移动端、PC、网页等形式）与大语言模型（例如 OpenAI、DeepSeek 等）的有效连接、互动与部署。简而言之，若您希望虚拟角色能够理解您的指令、进行对话、发声，以及连接到企业系统或业务流程，Fay 将为您提供一整套的解决方案。

功能概览

• 核心交互 ：支持全时流式通信（文本 / 语音），具备多轮对话、唤醒 / 中断（正则 / 前缀）功能，意味着可以在输入未完成时立即响应，确保交互的流畅性。
• 模型匹配 ：可以灵活配置数字人（2.5D/3D）、LLM（OpenAI/Deepseek）、ASR/TTS（如 Volcano TTS、FunASR），支持本地与云端的切换。
• 终端适配 ：适用于单片机、应用程序、网站及大屏幕等多种集成方案，便于与成熟系统对接。
• 自动播报 ：可用作虚拟教师、主播或新闻播报，一键执行脚本，同时支持机器人表情的展示。
• 智能代理 ：内置的 React Agent 具备自主决策和主动对话能力，搭载 RAG 知识库（支持 docx/pptx/txt 格式），可自定义问答及个性信息。
• 管理控制 ：提供配置中心（system.conf）、静默后台启动、通过 Ctrl+ C 退出，内置 MCP 工具箱及调度管理功能。
• 接口整合 ：包括文本交互、语音交互、数字人驱动、管理控制、自动播报、意图识别、消息透传及中断接口，支持 GUI 与 OpenAI 及远程音频的双向全链路中断。
• 高级特性 ：优化认知模型、确保线程安全、流式开始与结束标记、独立 MCP 工具控制及自动关闭服务。
• 其他 ：提供全离线商用免责，完全无付费项目，兼容 UE5、Unity、Metahuman、Duix、Aibote 等数字人项目。

安装与部署

环境准备

• 需安装 Python 3.12+；Windows/macOS 原生支持；Ubuntu 系统可通过命令：sudo apt update && sudo apt install build-essential portaudio19-dev 进行安装。

源码安装

• 克隆项目：git clone https://github.com/xszyou/Fay.git；
• 安装依赖：pip install -r requirements.txt；
• 配置文件：编辑 ./system.conf（包括模型 API Key、端口及知识库路径，默认公服地址如未修改）；
• 启动项目：通过命令 python main.py 来运行控制器，支持静默后台模式。

镜像快速启动

• Docker/GPU 镜像地址：https://www.compshare.cn/images/compshareImage-1cft3sk9gvta?ytag=GPU_fay（支持一键部署，适用于云端）。

数字人集成（可选）

• 对于 UE5：请克隆 https://github.com/xszyou/fay-ue5，并配置唇型（DAS BS 离线），接口端口为 10002。
• 对于 Unity：参考 https://github.com/LKZMuZiLi/human，进行 LLM 配置的 Wiki 指导。
• 其他：Metahuman-stream（2D）、Duix/Aibote（根据飞书指南进行操作）。

更新 ：执行 git pull 后重新安装依赖；拉取镜像更新版本；关注更新日志（最新更新于 2025 年 9 月 17 日）。

项目信息概览

• 项目链接：https://github.com/xszyou/Fay
• 开发者：xszyou
• Stars / Forks：11.9k ⭐ / 2.2k Forks
• 许可证：GPL-3.0