- Remove stage-tamagotchi, stage-pocket, server, and engine workspaces with their workflows, addons, and docs
- Switch the toolchain from pnpm to bun, replace lockfiles with bun.lock
- Rewrite remaining product references to Moeka

2026-09-14 16:40:49 +07:00

26 KiB

Raw Blame History

Project AIRI

Neuro-sama를 재현하여, AI 와이프 / 가상 캐릭터의 영혼 그릇을 우리 세상으로 가져옵니다.

[Discord 서버 참여] [체험하기] [English] [简体中文] [日本語] [Русский] [Tiếng Việt] [Français]

Neuro-sama에서 큰 영감을 받았습니다

Tip

Windows에서는 winget으로 AIRI를 설치할 수 있습니다:
winget install MoeruAI.AIRI
또는 Scoop으로 AIRI를 설치할 수 있습니다:
scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airi
macOS에서는 별도의 커스텀 tap을 추가하지 않고 Homebrew Cask로 AIRI를 설치할 수 있습니다:
brew install --cask airi

Warning

주의: 본 프로젝트와 관련된 공식 암호화폐나 토큰은 일절 발행하지 않았습니다. 관련 정보에 주의하시고 신중하게 판단해 주세요.

Note

Project AIRI에서 탄생한 모든 하위 프로젝트를 위한 전용 조직 @proj-airi가 있습니다. 확인해 보세요!

RAG, 메모리 시스템, 임베디드 데이터베이스, 아이콘, Live2D 유틸리티 등 다양한 프로젝트가 있습니다!

Tip

Crowdin에 번역 프로젝트가 있습니다. 번역이 부정확하다고 느끼시면 자유롭게 기여해 주세요.

사이버 생명체(사이버 와이프, 디지털 펫)나 함께 놀고 대화할 수 있는 디지털 동반자를 꿈꿔 본 적이 있으신가요?

ChatGPT나 유명한 Claude 같은 최신 대규모 언어 모델의 힘을 빌려, 가상 존재에게 역할극과 대화를 요청하는 것은 이미 누구나 쉽게 할 수 있는 일이 되었습니다. Character.ai (c.ai)나 JanitorAI 같은 플랫폼, 그리고 SillyTavern 같은 로컬 환경은 채팅 기반이나 비주얼 어드벤처 게임과 같은 경험을 위한 충분한 솔루션이 되고 있습니다.

하지만, 게임을 플레이하는 능력은요? 당신이 코딩하는 것을 볼 수 있고, 게임을 하면서 채팅하고, 영상을 보고, 그 외에도 많은 것을 할 수 있는 능력은?

아마 Neuro-sama를 이미 알고 계실 겁니다. 그녀는 현재 게임을 플레이하고, 채팅하고, 여러분 및 참여자들과 상호작용할 수 있는 최고의 AI VTuber / 동반자입니다. 이런 존재를 "디지털 휴먼"이라고 부르기도 합니다. 안타깝게도 오픈 소스가 아니기 때문에, 라이브 스트리밍이 끝나면 그녀와 상호작용할 수 없습니다.

그래서 이 프로젝트 AIRI는 여기서 또 다른 가능성을 제시합니다: 언제 어디서나 쉽게, 당신만의 디지털 라이프, 사이버 생명을 가질 수 있도록.

최근 DevLog와 이야기

DevLog @ 2026.03.23: 모바일 성능과 게임 엔진 탐색 - 2026년 3월 23일
DevLog @ 2026.03.14: VRM 스테이지 수명주기, 캐시, 관측성 - 2026년 3월 14일
DevLog @ 2026.02.16: Dome Keeper 데이터 수집과 학습 파이프라인 - 2026년 2월 16일
DevLog @ 2026.01.01: AIRI Pocket과 FlowChat 메모리 실험 - 2026년 1월 1일
DevLog @ 2025.10.20: Electron 이전, 새 모델, Moeru AI 업데이트 - 2025년 10월 20일
DevLog @ 2025.08.26: airi-factorio의 순수 비전 방향 진척 - 2025년 8월 26일
DevLog @ 2025.08.05: AIRI v0.7 릴리스 하이라이트 - 2025년 8월 5일
DevLog @ 2025.08.01: 스트리밍 텍스트 애니메이션과 자소 클러스터 - 2025년 8월 1일
DevLog @ 2025.07.18: Factorio Learning Environment로 airi-factorio 다시 보기 - 2025년 7월 18일
DreamLog 0x1: Project AIRI의 시작 이야기 - 2025년 6월 16일
...더 많은 내용은 문서 사이트에서

이 프로젝트의 특별한 점은?

다른 AI 기반 VTuber 오픈 소스 프로젝트와 달리, アイリ VTuber는 개발 첫날부터 WebGPU, WebAudio, Web Workers, WebAssembly, WebSocket 등 다양한 웹 기술을 지원하도록 설계되었습니다.

Tip

웹 기술을 사용하면 성능이 떨어지지 않을까 걱정되시나요?

걱정하지 마세요. 브라우저 버전은 브라우저와 웹뷰에서 얼마나 많은 것을 할 수 있는지 보여주기 위한 것이지만, 이에 완전히 의존하지는 않습니다. AIRI의 데스크톱 버전은 기본적으로 NVIDIA CUDA와 Apple Metal을 사용할 수 있으며 (HuggingFace와 candle 프로젝트 덕분에), 복잡한 의존성 관리 없이 사용 가능합니다. 트레이드오프를 고려하여, 그래픽, 레이아웃, 애니메이션, 그리고 WIP 플러그인 시스템에는 부분적으로 웹 기술을 활용하고 있습니다.

이는 アイリ VTuber가 최신 브라우저와 기기에서 실행 가능하며, 모바일 기기에서도 작동한다는 것을 의미합니다 (PWA 지원 완료). 이를 통해 개발자들이 アイリ VTuber의 기능을 한 단계 더 끌어올리면서도, 사용자에게 TCP 연결이나 기타 비웹 기술이 필요한 기능을 활성화할 수 있는 유연성을 제공합니다. 예를 들어 Discord 음성 채널에 연결하거나, 친구들과 Minecraft나 Factorio를 함께 플레이할 수 있습니다.

Note

저희는 아직 개발 초기 단계에 있으며, アイリ VTuber를 현실로 만들기 위해 재능 있는 개발자분들을 찾고 있습니다.

Vue.js, TypeScript 또는 이 프로젝트에 필요한 개발 도구에 익숙하지 않아도 괜찮습니다. 아티스트, 디자이너로 참여하거나, 첫 번째 라이브 스트리밍을 시작하는 데 도움을 줄 수도 있습니다.

React, Svelte, 심지어 Solid를 주로 사용하시더라도 환영합니다. アイリ VTuber에서 보고 싶은 기능을 추가하거나 실험하고 싶은 기능을 위한 하위 디렉터리를 만들 수 있습니다.

저희가 찾고 있는 분야 (및 관련 프로젝트):

Live2D 모델러

VRM 모델러

VRChat 아바타 디자이너

컴퓨터 비전

강화 학습

음성 인식

음성 합성

ONNX Runtime

Transformers.js

vLLM

WebGPU

Three.js

WebXR (@moeru-ai 조직의 다른 프로젝트도 확인해 보세요)

관심이 있으시다면, 여기서 자기소개를 해보시는 건 어떨까요? Would like to join part of us to build AIRI?

현재 진행 상황과 로드맵

구현된 기능

두뇌
- Minecraft 플레이
- Factorio 플레이 (진행 중, PoC 및 데모 제공)
- Kerbal Space Program 플레이 (공지 예정)
- Helldivers 2 함께 플레이 (진행 중)
- Telegram에서 채팅
- Discord에서 채팅
- 메모리
  - 순수 브라우저 내 데이터베이스 지원 (DuckDB WASM | pglite)
  - Memory Alaya (진행 중)
- 순수 브라우저 내 로컬 (WebGPU) 추론
귀
- 브라우저에서 음성 입력
- Discord에서 음성 입력
- 클라이언트 측 음성 인식
- 클라이언트 측 말하기 감지
입
- ElevenLabs, Microsoft/Azure Speech, OpenAI 호환 TTS, Alibaba Cloud Model Studio, 로컬 Kokoro TTS를 포함한 다중 제공자 음성 합성
몸
- VRM 지원
  - VRM 모델 제어
- VRM 모델 애니메이션
  - 자동 눈 깜빡임
  - 자동 시선 추적
  - 대기 상태 시선 이동
- Live2D 지원
  - Live2D 모델 제어
- Live2D 모델 애니메이션
  - 자동 눈 깜빡임
  - 자동 시선 추적
  - 대기 상태 시선 이동

개발

이 프로젝트의 상세한 개발 가이드는 CONTRIBUTING.md를 참조하세요

Note

기본적으로 bun run dev는 Stage Web(브라우저 버전)의 개발 서버를 시작합니다. 환경 설정은 CONTRIBUTING.md를 참고하세요.

bun install
bun run dev

Stage Web (브라우저 버전, airi.moeru.ai)

bun run dev

문서 사이트

bun run dev:docs

배포

bumpp를 실행해 모노레포 버전을 업데이트하세요:

npx bumpp --no-commit --no-tag

LLM API 프로바이더 지원 (xsai 기반)

이 프로젝트에서 탄생한 하위 프로젝트

Awesome AI VTuber: AI VTuber 및 관련 프로젝트의 큐레이션 목록
unspeech: /audio/transcriptions 및 /audio/speech를 위한 범용 엔드포인트 프록시 서버, LiteLLM과 유사하지만 모든 ASR 및 TTS에 대응
hfup: HuggingFace Spaces로의 배포 및 번들링을 지원하는 도구
xsai-transformers: xsAI용 실험적 Transformers.js 프로바이더
WebAI: Realtime Voice Chat: VAD + STT + LLM + TTS로 ChatGPT 실시간 음성을 처음부터 구현한 완전한 예제
@proj-airi/drizzle-duckdb-wasm: DuckDB WASM용 Drizzle ORM 드라이버
@proj-airi/duckdb-wasm: 사용하기 쉬운 @duckdb/duckdb-wasm 래퍼
AIRI Factorio: AIRI가 Factorio를 플레이할 수 있게 하는 프로젝트
Factorio RCON API: Factorio 헤드리스 서버 콘솔용 RESTful API 래퍼
autorio: Factorio 자동화 라이브러리
tstl-plugin-reload-factorio-mod: 개발 중 Factorio 모드 리로드 지원
Velin: Vue SFC와 Markdown으로 관리하기 쉬운 상태 기반 LLM 프롬프트 작성
demodel: 다양한 추론 런타임에서 모델과 데이터셋 다운로드를 간편하게 가속
inventory: 중앙 집중식 모델 카탈로그 및 기본 프로바이더 설정 백엔드 서비스
MCP Launcher: 모든 MCP 서버를 쉽게 빌드하고 실행하는 런처, 모델 세계의 Ollama 같은 존재!
SAD: 셀프 호스팅 및 브라우저에서 LLM을 실행하기 위한 문서 및 노트

flowchart LR
  subgraph Apps[Stage applications]
    Web[stage-web]
  end

  subgraph Shared[Shared product packages]
    StageUI[stage-ui]
    Domain[core-agent\ncore-character]
    Audio[pipelines-audio]
    Renderers[stage-ui-live2d\nstage-ui-three and renderers]
    SDK[server-sdk\nserver-shared]
  end

  subgraph Channel[Server channel]
    Runtime[server-runtime]
  end

  subgraph Integrations[Source-configured integrations]
    Discord[discord-bot]
    Minecraft[minecraft-bot]
    Other[Telegram, Factorio, MCP, and others]
  end

  subgraph Hosted[Hosted backend]
    Edge[Caddy]
    API[api-server]
    Auth[auth-server]
    Database[(PostgreSQL)]
    Cache[(Redis)]
  end

  Web --> StageUI
  StageUI --> Domain
  StageUI --> Audio
  StageUI --> Renderers
  StageUI --> SDK
  SDK <-->|server channel| Runtime
  Discord --> SDK
  Minecraft --> SDK
  Other -. optional .-> SDK
  Edge --> API
  Edge --> Auth
  API --> Database
  API --> Cache
  Auth --> Database
  Auth --> Cache

유사 프로젝트

오픈 소스

kimjammer/Neuro: A recreation of Neuro-Sama originally created in 7 days.: 매우 완성도 높은 구현
SugarcaneDefender/z-waif: 게임, 자율 에이전트, 프롬프트 엔지니어링에 뛰어남
semperai/amica: VRM, WebXR에 뛰어남
elizaOS/eliza: 에이전트를 다양한 시스템 및 API에 통합하는 훌륭한 예시
ardha27/AI-Waifu-Vtuber: Twitch API 통합에 뛰어남
InsanityLabs/AIVTuber: 훌륭한 UI/UX
IRedDragonICY/vixevia
t41372/Open-LLM-VTuber
PeterH0323/Streamer-Sales

비오픈 소스

프로젝트 현황

감사의 말

Reka UI: 문서 사이트 디자인에 활용, 새로운 랜딩 페이지도 이를 기반으로 하며, 수많은 UI 컴포넌트 구현에 감사합니다. (shadcn-vue가 Reka UI를 헤드리스로 사용하고 있으니 확인해 보세요!)
pixiv/ChatVRM
josephrocca/ChatVRM-js: A JS conversion/adaptation of parts of the ChatVRM (TypeScript) code for standalone use in OpenCharacters and elsewhere
UI 및 스타일 디자인은 Cookard, UNBEATABLE, Sensei! I like you so much!, 그리고 Ayame by Mercedes Bazan 및 Wish by Mercedes Bazan의 작품에서 영감을 받았습니다
mallorbc/whisper_mic
xsai: LLM 및 모델과 상호작용하기 위한 다양한 패키지를 구현, Vercel AI SDK와 비슷하지만 훨씬 작습니다

후원자

OpenCollective, Patreon, Ko-fi를 통해 Project AIRI를 후원해 주셔서 감사합니다.

특별한 감사

Project AIRI에 기여해 주신 모든 기여자분들께 특별한 감사를 드립니다 ❤️

26 KiB Raw Blame History