How xikhar/persona works
Persona is a desktop character companion for voice conversations. A user configures a model, animation library, and audio source; the Electron process manages the overlay and listens to the selected playback source, while the renderer animates the character in response. Settings, MCP controls, and optional VRoid Hub integration are distinct supporting workflows. Edges are limited to README statements and relationships visible in the supplied excerpts or SOURCE INDEX; several implementation details were not sampled.
Main entry points: main.cts Electron coordinator · App.tsx Renderer app state · Avatar.tsx Avatar rig and motion · animation-scheduler.ts Animation scheduler
Components 21
Desktop runtime
- Electron coordinator
electron/main.cts - Overlay window controls
electron/click-through.cts
Character renderer
- Renderer app state
src/App.tsx - 3D scene and camera
src/components/Scene.tsx - Avatar rig and motion
src/components/Avatar.tsx - Animation catalog
src/animation-catalog.ts - Animation scheduler
src/animation-scheduler.ts - Drag secondary motion
src/drag-inertia.ts
Settings and library
- Settings interface
src/components/SettingsPage.tsx - Settings persistence
electron/settings-store.cts - Packaged library catalog
electron/library-catalog.cts - Animation generation
electron/animation-generator.cts
Voice and integrations
- Voice output listener
electron/audio-listener.cts - Voice source discovery
electron/voice-source-discovery.cts - Playback process or stream
- MCP control server
electron/mcp-server.cts - MCP client
- VRoid Hub authentication
electron/vroid-hub-auth.cts - VRoid Hub client
electron/vroid-hub-client.cts - VRoid Hub service
Other components
- Desktop user
Connections 25
- Desktop user → Settings interface: configures
README.md - Settings interface → Settings persistence: saves settings
- Electron coordinator → Settings persistence: loads settings
electron/main.cts - Settings persistence → Packaged library catalog: uses catalog
electron/settings-store.cts - Electron coordinator → Voice output listener: starts listener
electron/main.cts - Electron coordinator → Voice source discovery: discovers sources
electron/main.cts - Playback process or stream → Voice output listener: provides playback
- Voice output listener → Renderer app state: sends voice state
- Electron coordinator → Renderer app state: launches window
README.md - Desktop user → Overlay window controls: toggles overlay
README.md - Renderer app state → 3D scene and camera: renders scene
src/App.tsx - 3D scene and camera → Avatar rig and motion: renders avatar
src/components/Scene.tsx - Avatar rig and motion → Animation scheduler: updates animation
src/components/Avatar.tsx - Animation scheduler → Animation catalog: selects clips
src/animation-scheduler.ts - Renderer app state → Drag secondary motion: queues drag motion
src/App.tsx - Avatar rig and motion → Drag secondary motion: applies body lag
src/components/Avatar.tsx - Desktop user → MCP client: requests controls
README.md - MCP client → MCP control server: sends MCP requests
README.md - Electron coordinator → MCP control server: starts server
electron/main.cts - Desktop user → VRoid Hub authentication: connects account
README.md - Electron coordinator → VRoid Hub authentication: configures auth
electron/main.cts - VRoid Hub authentication → VRoid Hub client: provides tokens
electron/vroid-hub-client.cts - VRoid Hub client → VRoid Hub service: fetches characters
electron/vroid-hub-client.cts - Animation generation → Packaged library catalog: uses catalog
electron/animation-generator.cts - Packaged library catalog → Animation scheduler: supplies animation media