Architecture Overview
YUNA is built on a modular architecture designed for performance and extensibility.
Live2D / 3D Rendering
WebGL-based rendering pipeline with PIXI.js for Live2D and Three.js integration planned for 3D models. 60+ FPS performance with physics simulation.
Adapter Pattern
Unified adapter interface for model control. Switch between Live2D and 3D backends without changing application logic.
Profile System
JSON-based configuration storage for expressions, parameters, parts, and voice settings. Full export/import support.
Local-First Storage
All data stored in browser localStorage. Zero server dependency for core features. Optional cloud sync planned.
// YUKI Core Architecture
interface YukiConfig {
model: ModelAdapter; // Live2D or 3D adapter
personality: Persona; // LLM personality config
voice: VoiceConfig; // TTS settings
storage: StorageAdapter; // Local or cloud
}
// Adapter Pattern for model backends
interface ModelAdapter {
load(path: string): Promise<void>;
setParam(id: string, value: number): void;
applyExpression(name: string): void;
getParams(): Param[];
getParts(): Part[];
exportConfig(): ProjectConfig;
}
// Coming: Plugin system
interface YukiPlugin {
name: string;
version: string;
init(yuki: YukiInstance): void;
hooks: PluginHooks;
}LLM & AI Roadmap
YUNA will support multiple LLM backends for intelligent conversations. Each character can have persistent memory, unique personality traits, and context-aware responses.
Intelligent Companions
Characters that remember your conversations, adapt to your preferences, and feel genuinely alive. Powered by the best LLMs available.
Full 3D Pipeline
Create in Blender, export to YUNA. Full support for VRM avatars, custom rigs, and expression authoring tools.
3D & Blender Pipeline
Beyond Live2D: YUNA will support full 3D models with VRM, GLB, and custom formats. Create your avatar in Blender and bring it to life.
VTuber & Streaming
Built with streamers in mind. OBS integration, webcam tracking, and streamer-friendly preset packs for quick avatar setup.
OBS overlay mode
plannedWebcam tracking
futureAudio reactive
plannedStreamer presets
plannedCo-streaming
futureDevelopment Roadmap
Track our progress from alpha to the full platform vision.