back to home

xszyou / Fay

fay是一个帮助数字人（2.5d、3d、移动、pc、网页）或大语言模型（openai兼容、deepseek）连通业务系统的agent框架。

12,434 stars
2,241 forks
122 issues
PythonJavaScriptJupyter Notebook
Chat with CodebaseArchitecture ScanSecurity AuditExplain Codebase

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing xszyou/Fay in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Click here to launch the interactive analysis workspace

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/xszyou/Fay)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview
<div align="center"> <br> <img src="readme/icon.png" alt="Fay"> <h1>FAY</h1> <h3>Fay数字人框架</h3> </div>

！！重要通知：我们已经把Fay的三个版本合并成1个，并致力提供更稳定更全面的功能。

我们致力于思考面向终端的数字人落地应用，并通过完整代码把思考结果呈现给大家。Fay数字人框架，向上适配各种数字人模型技术，向下接入各式大语言模型，并且便于更换诸如TTS、ASR等模型，为单片机、app、网站提供全面的数字人应用接口。
更新日志：https://qqk9ntwbcit.feishu.cn/wiki/UlbZwfAXgiKSquk52AkcibhHngg 文档：https://qqk9ntwbcit.feishu.cn/wiki/JzMJw7AghiO8eHktMwlcxznenIg

功能特点

  • 完全开源，商用免责
  • 支持全离线使用
  • 全时流式的支持
  • 自由匹配数字人模型、大语言模型（openai 兼容接口）、ASR、TTS模型
  • 支持数字人自动播报模式（虚拟教师、虚拟主播、新闻播报）
  • 支持任意终端使用：单片机、app、网站、大屏、三方业务系统接入等
  • 支持多用户多路并发
  • 提供文字交互接口、语音交互接口、数字人驱动接口、管理控制接口、自动播报接口、意图接口
  • 支持语音指令灵活配置执行（qa.csv）
  • 支持自定义知识库、自定义问答对、自定义人设信息
  • 支持唤醒及打断对话
  • 支持服务器及单机模式
  • 支持机器人表情输出
  • 支持agent自主决策工具调用
  • 基于日程式数字人主动对话
  • 支持后台静默启动
  • 支持deepseek等thinking llm
  • 自我认知提高
  • 仿生记忆
  • 支持MCP工具管理（sse、studio）
  • 提供配置管理中心
  • 全链路交互互通

Fay数字人框架

源码启动

环境

  • Python 3.12

  • Windows、macos、ubuntu

  • 注：ubuntu需要先安装gcc及portaudio

  • sudo apt update
sudo apt install build-essential
sudo apt install portaudio19-dev

安装依赖

pip install -r requirements.txt

快速启动

本地

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

镜像

https://www.compshare.cn/images/compshareImage-1cft3sk9gvta?ytag=GPU_fay

个性化配置

  • 根目录system.conf.bak 重命名为system.conf，并配置里面的内容

管理页面

高级玩法

使用数字人（非必须）

ue: https://github.com/xszyou/fay-ue5

unity：https://qqk9ntwbcit.feishu.cn/wiki/Se9xw04hUiss00kb2Lmci1BVnM9

metahuman-stream（2d）：https://qqk9ntwbcit.feishu.cn/wiki/Ik1kwO9X5iilnGkFwRhcnmtvn3e

duix（android)：https://qqk9ntwbcit.feishu.cn/wiki/Ik1kwO9X5iilnGkFwRhcnmtvn3e()

aibote(windows cpu克隆人)：https://qqk9ntwbcit.feishu.cn/wiki/ULaywzVRti0HXWkhCzacoSPAnIg

集成到自家产品（非必须）

接口：https://qqk9ntwbcit.feishu.cn/wiki/Mcw3wbA3RiNZzwkexz6cnKCsnhh

联系

交流群及资料教程关注公众号 fay数字人（请先star本仓库）

致谢

感谢以下开源项目为 Fay 提供的技术支持：