xszyou/Fay
디지털 휴먼(2.5D, 3D, 모바일, PC, 웹)과 LLM(OpenAI 호환, DeepSeek)을 비즈니스 시스템에 연결하는 에이전트 프레임워크입니다.
- 스타
- 13,582
- 포크
- 2,367
- 열린 이슈
- 130
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
Fay는 디지털 휴먼(아바타)을 실제 제품에 적용하기 위한 프레임워크입니다. 프런트엔드에서는 다양한 디지털 휴먼 렌더링 기술에 대응하고, 백엔드에서는 OpenAI 호환 API와 DeepSeek를 비롯한 대규모 언어 모델에 연결합니다. 음성 인식(ASR)과 음성 합성(TTS) 모델을 교체할 수 있어, 개발자가 필요한 음성 및 아바타 파이프라인을 구성할 수 있습니다.
이 프레임워크는 텍스트 채팅, 음성 상호작용, 디지털 휴먼 구동, 관리 제어, 자동 방송, 인텐트 처리를 위한 인터페이스를 제공합니다. 완전한 오프라인 실행을 지원하며, 스트리밍, 웨이크 워드와 끼어들기 처리, 여러 사용자의 동시 접속도 지원합니다. 클라이언트로는 마이크로컨트롤러, 모바일 앱, 웹사이트, 대형 화면, 서드파티 비즈니스 시스템을 사용할 수 있습니다.
Fay에는 지식 베이스, 사용자 지정 Q&A 쌍, 페르소나 설정, 에이전트 기반 도구 호출, MCP 도구 관리 기능도 포함되어 있습니다. 설정을 위한 웹 관리 페이지도 제공됩니다.
핵심 기능
- 01디지털 휴먼(2.5D, 3D, 모바일, PC, 웹)을 LLM 및 음성 모델과 연결합니다.
- 02OpenAI 호환 LLM API와 DeepSeek 추론 모델을 지원합니다.
- 03ASR과 TTS 모델을 각각 독립적으로 교체할 수 있습니다.
- 04텍스트, 음성, 구동, 제어, 방송, 인텐트 API를 제공합니다.
- 05웨이크 워드, 끼어들기, 다중 사용자 동시 세션을 지원합니다.
- 06사용자 지정 지식 베이스, Q&A 쌍, 페르소나 설정, MCP 도구 관리를 제공합니다.
활용 사례
- 가상 교사, 가상 진행자 또는 자동 뉴스 방송 시스템을 구축합니다.
- 웹사이트나 앱에 음성으로 조작하는 디지털 휴먼 어시스턴트를 추가합니다.
- 통합 API를 통해 LLM을 기존 비즈니스 시스템에 연결합니다.
- 로컬 하드웨어에서 오프라인 음성 및 아바타 어시스턴트를 실행합니다.
빠른 시작
- 1
Python 3.12을 설치하고 Ubuntu에서는 build-essential과 portaudio19-dev도 설치합니다
- 2
requirements.txt에서 종속성을 설치합니다
pip install -r requirements.txt - 3
공개 설정 센터를 사용해 프로젝트를 시작합니다(느립니다. 본인의 키로 바꾸세요)
python main.py start -config_center d19f7b0a-2b8a-4503-8c0d-1a587b90eb69 - 4
브라우저에서 http://127.0.0.1:5000으로 이동해 관리 페이지를 엽니다
사용 전 알아둘 점
- Python 3.12가 필요합니다.
- 기본 공개 설정 센터는 매우 느리므로 본인의 API 키를 설정하는 것이 좋습니다.
- 문서와 커뮤니티 자료는 주로 Feishu에 중국어로 게시되어 있습니다.
토픽
자주 묻는 질문
- Fay은(는) 무엇인가요?
- 디지털 휴먼(2.5D, 3D, 모바일, PC, 웹)과 LLM(OpenAI 호환, DeepSeek)을 비즈니스 시스템에 연결하는 에이전트 프레임워크입니다. Fay는 디지털 휴먼(아바타)을 실제 제품에 적용하기 위한 프레임워크입니다. 프런트엔드에서는 다양한 디지털 휴먼 렌더링 기술에 대응하고, 백엔드에서는 OpenAI 호환 API와 DeepSeek를 비롯한 대규모 언어 모델에 연결합니다. 음성 인식(ASR)과 음성 합성(TTS) 모델을 교체할 수 있어, 개발자가 필요한 음성 및 아바타 파이프라인을 구성할 수 있습니다.
- Fay은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- Fay은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- Fay은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. Fay의 마지막 커밋은 2026년 9월 21일입니다.
- Fay은(는) 어디에 사용할 수 있나요?
- 가상 교사, 가상 진행자 또는 자동 뉴스 방송 시스템을 구축합니다. 웹사이트나 앱에 음성으로 조작하는 디지털 휴먼 어시스턴트를 추가합니다. 통합 API를 통해 LLM을 기존 비즈니스 시스템에 연결합니다. 로컬 하드웨어에서 오프라인 음성 및 아바타 어시스턴트를 실행합니다.
- 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
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
LangGraph에서 복잡한 다단계 작업을 바로 실행할 수 있는, 필요한 기능을 모두 갖춘 Python용 에이전트 하네스입니다.
질문을 계획하고 웹·로컬 자료를 수집해 인용이 포함된 보고서를 작성하는 오픈소스 자율 연구 에이전트
LLM 에이전트의 대화와 실행을 Python 및 TypeScript 앱에서 활용할 수 있는 영구적이고 구조화된 메모리로 바꾸는 에이전트 네이티브 메모리 인프라입니다.
MCP, Agent Skills, ACP, A2A를 지원하는 LLM 에이전트 구축·실행·평가용 Python 프레임워크 및 CLI입니다.