Lia is an intelligent, offline desktop companion built for Linux (Arch/Hyprland). Unlike standard desktop pets, Lia uses a local Large Language Model (Llama 3.2 via Ollama) to converse, react to emotions, and roam the screen freely while maintaining transparency and click-through capabilities.
- Engine: Godot 4.3 (Compatibility Mode / OpenGL)
- Language: GDScript
- AI Backend: Ollama (Llama 3.2:1b)
- Format: VRM (Anime Character) & Mixamo Animations
- OS Target: Linux (Arch + Hyprland), compatible with X11/Wayland.
The project is built on four distinct layers:
- The Stage: Transparent window management & OS integration.
- The Body: VRM rendering & Smart Hitboxes.
- The Brain: HTTP Bridge to local AI & Emotion Parsing.
- The Behavior: Finite State Machine (Idle, Roaming, Hiding).
Development Documentation is available here