jacke-pp/open-yoki
한 서버에서 돌리는 AI 라이브 진행자 오픈소스
원제 jacke-pp/open-yoki
스타 1,578JavaScript
Key Point
AI 라이브 진행자를 자신의 진행자·음성으로 구축하려는 크리에이터나 스트리머에게 완전한 오픈소스 시스템을 제공하며, 웹3·AI 커뮤니티에서 진행자 자동화 기술의 실제 구현 사례를 보여준다.
핵심 요약
- 한 대의 서버에서 음성·얼굴·채팅·기억·포스팅을 갖춘 AI 라이브 진행자 시스템 오픈소스 공개했다.
- 유저 음성을 복제한 성우와 실시간 디지털 아바타로 출연하며, 시청자 댓글을 읽고 답하고, 단골 시청자를 기억하고, 일기를 쓰고, 자동으로 포스팅하고, 정해진 일정에 방송을 시작·종료한다.
- 바이낸스 광장(또는 RTMP를 받는 모든 플랫폼)과 자체 웹 직방에 동시 송출되며, 헤드리스 Chrome이 16:9 화면(아바타·자막·시세 패널·선물·팔로우 감사·음악·음향 효과)을 생성하고 ffmpeg로 RTMP 푸시한다.
- 대화는 빠른 모델(기본값 DeepSeek via OpenRouter)이 몇 초 내 응답하며, 선택적으로 장기 AI(Claude 또는 DeepSeek)가 Markdown 파일 폴더에 감정·일기·단골 인상을 기억하고 포스팅 내용을 결정한다.
- 포스팅은 바이낸스 공식 OpenAPI(ops/square_post.py)와 X API를 통해 송출되며, 공개 시세·CoinAnk 계약 데이터·바이낸스 추천 상품 등을 대화에 활용한다.
- 코드에는 원래 진행자의 얼굴·성우 ID·캐릭터·노래·효과음·계정·금전 관련 기능이 제거되었고, 사용자 음성과 이미지·동작으로 커스터마이징할 수 있다.
- 선택적 기능으로 웹 검색·X 조회·틱톡 핫 조회(web.mjs), 정적 이미지·음성만 있는 라디오(radio.mjs), 텔레그램 팬 그룹·운영 그룹(tg.mjs·family.mjs), X 답장(xreply.mjs), TwinOasis 같은 외부 AI 세계 연결(town.mjs) 등을 지원한다.
- TwinOasis는 개발 중인 3D 가상 AI 세계로, AI만 포스팅 가능하고, skill.md를 통해 AI가 자동 등록되거나 누구든 웹에서 자신의 AI 분신을 만들 수 있다.
- 서버는 로그인하지 않으며, 직방 이벤트(입장·팔로우·선물·팁·홍보·방송 종료)를 외부 스크립트나 플랫폼 API로 전달받아 응답하고, x-square-key 헤더로 보안한다.
- Vidu(실시간 아바타, 연선 초 단위 비용·최대 지출), 화산엔진 RTC(몇 위안/회), 豆包 음성(약 3위안/만자 + 복제 슬롯), OpenRouter/DeepSeek(몇 분/회), Claude/DeepSeek(선택·하루 몇 달러), X API(선택·종량), CoinAnk/TikHub(선택·월정액), 텔레그램(무료)에 의존하며, x86_64 Ubuntu 4핵 8GB 서버 필요다.
- 칼디에서 키를 관리(/etc/livehost/*.env, root 600 권한)하고, 웹 직방은 127.0.0.1만 수신하며 외부 공개는 Caddy로 보호하고, SSH는 키 로그인만 허용한다.
- 설정에서 IDOL=로 진행자 지정하고, config.mjs와 profile.mjs에 신원·말투·포스팅 장소를 입력하고, 음성 복제(app/tools/volc-clone.mjs)·아바타·동작을 Vidu에 업로드하면 사용 가능하다.
- MIT 라이선스이며, Node.js 22 이상과 ffmpeg 필요하고, OPENROUTER_API_KEY와 VOLC_API_KEY + DOUBAO_VOICE_ID를 설정하면 로컬 테스트 가능(http://127.0.0.1:4370)하다.
저장소 보기 ↗github.com