Architecture Overview

"I'm working on **AIRI** — an open-source AI companion that lives as a desktop pet and joins Discord, Telegram, and Minecraft.
 
ARCHITECTURE
- apps/stage-tamagotchi  : Tauri desktop pet (Vue 3 + Rust plugins)
- apps/stage-web         : Browser version of the companion
- services/discord-bot   : Voice & text bot for Discord (Node.js)
- services/telegram-bot  : Tick-based chat agent for Telegram
- services/minecraft     : Autonomous player via mineflayer
- packages/stage-ui      : Shared UI components + Pinia stores
- packages/ccc           : Character Card Creator (persona data model)
- crates/                : Rust plugins (VAD, STT, window pass-through)
 
KEY CONCEPTS
- Character Card  → builds system prompt for the LLM
- Marker Parser   → transforms <|EMOTE_*|> etc. into animations/actions
- Voice Pipeline  → Silero-VAD → Whisper → LLM → TTS
- Click-Through   → Rust plugin toggles window ignoreCursorEvents
 
COMMON TASKS
- Change persona  : edit packages/ccc/src/define/card.ts or use Settings UI
- New marker      : update constants/emotions.ts + add handler
- Discord tweaks  : edit services/discord-bot/src/commands/
- Compile plugins : pnpm run build:native (uses Cargo)
 
Please help me with [YOUR TASK HERE]."

apps/
  stage-tamagotchi/     # desktop pet (Tauri + Vue)
  stage-web/            # web pet (Vite + Vue)
services/
  discord-bot/          # joins voice channels
  telegram-bot/         # autonomous ticking agent
  minecraft/            # in-game AI player
packages/
  stage-ui/             # UI library + Pinia stores + composables
  ccc/                  # Character Card schema helper
crates/
  tauri-plugin-*        # Rust: VAD, STT, mouse, window