How zeikar/charivo works
Charivo is a modular TypeScript framework for interactive AI characters. Its principal text workflow accepts a user message through core orchestration, obtains an LLM response (optionally invoking avatar tools), speaks the reply through TTS, and updates a renderer. A parallel realtime workflow streams microphone audio to a realtime provider and returns audio and events to the character. Provider packages offer browser-direct and server-mediated integrations; the README documents these modes, while sampled source confirms selected manager and client dependencies. Unsampled modules are represented at their exact package directories where their capabilities are evident from the README and tree.
Main entry points: index.ts Charivo Core · llm-manager.ts LLM Manager · realtime-manager.ts Realtime Manager · render-manager.ts Render Manager
Components 20
Character Orchestration
- Charivo Core
packages/core/src/index.ts - Events and State
packages/core/src/bus.ts
Conversation and Tools
- Avatar Tools
packages/avatar/src/index.ts - LLM Manager
packages/llm/src/llm-manager.ts - LLM Clients
packages/llm/src - Message History
packages/llm/src/message-history-manager.ts
Voice and Realtime
- STT Manager
packages/stt/src/stt-manager.ts - STT Providers
packages/stt/src - TTS Manager
packages/tts/src/tts-manager.ts - TTS Providers
packages/tts/src - Realtime Manager
packages/realtime/src/realtime-manager.ts - Session Instructions
packages/realtime/src/instructions.ts - Realtime Clients
packages/realtime/src
Avatar Rendering
- Render Manager
packages/render/src/render-manager.ts - Live2D Renderer
packages/render-live2d/src/live2d-renderer.ts - Iki Renderer
packages/render-iki/src/renderer.ts - Cubism Model
packages/render-live2d/CubismSdkForWeb-5-r.4/Framework/src/model/cubismmodel.ts
Provider Integrations
- Server Routes
packages/server/src - Provider Services
Other components
- Application
Connections 25
- Application → Charivo Core: configures
README.md - Application → Render Manager: initializes
README.md - Render Manager → Live2D Renderer: wraps
README.md - Render Manager → Iki Renderer
- Live2D Renderer → Cubism Model
- Application → LLM Manager: configures
README.md - LLM Manager → LLM Clients: calls
README.md - LLM Manager → Message History: manages
packages/llm/src/llm-manager.ts - Application → Avatar Tools: registers
README.md - LLM Manager → Avatar Tools: invokes
README.md - Application → Charivo Core: sends message
README.md - Charivo Core → LLM Manager: requests reply
README.md - Charivo Core → TTS Manager: speaks reply
README.md - TTS Manager → TTS Providers: plays audio
packages/tts/src/tts-manager.ts - Charivo Core → Render Manager: updates character
README.md - Charivo Core → Events and State
packages/core/src/index.ts - Application → Realtime Manager: configures
README.md - Application → Realtime Manager: starts session
README.md - Realtime Manager → Session Instructions: builds session
packages/realtime/src/realtime-manager.ts - Realtime Manager → Realtime Clients: dispatches session
packages/realtime/src/realtime-manager.ts - Realtime Manager → Provider Services: streams audio
- Application → STT Manager
- STT Manager → STT Providers
- Application → Server Routes: uses production routes
README.md - Server Routes → Provider Services: mediates requests
README.md