How moeru-ai/airi works
AIRI is a multi-platform, LLM-powered virtual-character project. Users interact with a character through desktop, browser, or mobile experiences; the broader product includes conversational AI, speech, animated avatars, and integrations. The graph highlights the sampled agent and speech internals, plus major product branches visible in the README and tree. Source evidence is uneven: several platform and integration branches are represented by their exact directories, but their internal call paths were not sampled, so no speculative connections are drawn for them.
Main entry points: llm-service.ts LLM service · stage-tamagotchi Desktop character · pipeline.ts Perception pipeline · streaming-pipeline.ts Streaming TTS client
Components 23
User experiences
- Desktop character
apps/stage-tamagotchi - Mobile companion
apps/stage-pocket - Web stage
apps/stage-web/src - Desktop renderer
apps/stage-tamagotchi-kirie/src-web/src/renderer
Conversation runtime
- LLM service
packages/core-agent/src/runtime/llm-service.ts - Chat completion stream
packages/core-agent/src/runtime/chat-completions.ts - Responses stream
packages/core-agent/src/runtime/responses.ts - Request context
packages/core-agent/src/runtime/request-context.ts
Speech and inference
- Speech pipeline
packages/pipelines-audio/src/speech-pipeline.ts - Streaming TTS client
packages/stage-ui/src/libs/speech/streaming-pipeline.ts - VOICEVOX engine
packages/provider-inference/src/providers/local/voicevox/engine.ts - Volcengine TTS adapter
server/apps/api/src/services/adapters/tts/volcengine.ts
Character rendering
- Motion capture engine
packages/model-driver-mediapipe/src/engine.ts - Live2D motion manager
packages/stage-ui-live2d/src/composables/live2d/motion-manager.ts - MMD animation manager
packages/stage-ui-mmd/src/composables/mmd/animation-manager.ts
Integrations
- Minecraft integration
integrations/minecraft/src - Perception pipeline
integrations/minecraft/src/cognitive/perception/pipeline.ts - Perception rule engine
integrations/minecraft/src/cognitive/perception/rules/engine.ts - Satori bot planner
integrations/satori-bot/src/core/planner/llm-client.ts - Computer-use workflows
services/computer-use-mcp/src/workflows/engine.ts - Telegram bot
integrations/telegram-bot/src - Twitter services
integrations/twitter-services/src
Other components
- User
Connections 16
- User → Desktop character: uses
README.md - User → Mobile companion: uses
README.md - User → Web stage: uses
README.md - User → Desktop renderer: interacts
- LLM service → Chat completion stream: dispatches
packages/core-agent/src/runtime/llm-service.ts - LLM service → Responses stream: dispatches
packages/core-agent/src/runtime/llm-service.ts - LLM service → Request context: checks compatibility
packages/core-agent/src/runtime/llm-service.ts - Streaming TTS client → Speech pipeline: uses audio stream
packages/stage-ui/src/libs/speech/streaming-pipeline.ts - Volcengine TTS adapter → VOICEVOX engine: optional provider
- Perception pipeline → Perception rule engine: feeds events
- Minecraft integration → Perception pipeline: uses
integrations/minecraft/src/cognitive/perception/pipeline.ts - Satori bot planner → LLM service: requests generation
- Computer-use workflows → LLM service: optional agent use
- Desktop character → Live2D motion manager: renders character
- Desktop character → MMD animation manager: renders character
- Desktop character → Motion capture engine: optional motion input