How beeegee/fuwa works
Fuwa is a terminal companion whose main workflow is to observe configured folders, turn file activity into LLM-generated reactions, and present those reactions and text-RPG choices in a TUI with an animated axolotl. Users can also chat through choices, evolve the companion’s personality, and configure providers and watched folders. The graph follows the app orchestration and sampled module references; unsampled UI and event wiring is shown only where the README or source index supports it.
Main entry points: fuwa.py Fuwa TUI app · brain/__init__.py Fuwa brain · config/__init__.py Configuration · file_observer/__init__.py File observer
Components 16
Terminal experience
- Fuwa TUI app
fuwa.py - Chat UI
features/chat_ui/__init__.py - Dashboard UI
features/dashboard_ui/__init__.py - Settings UI
features/settings_ui/__init__.py - Axolotl animation
features/axolotl/__init__.py - ANSI image conversion
infrastructure/ansi/__init__.py
Observation and companion
- File observer
features/file_observer/__init__.py - Fuwa brain
features/brain/__init__.py
Runtime services
- LLM requests
infrastructure/llm/__init__.py - LLM provider
- File memories
infrastructure/memory/__init__.py - Configuration
infrastructure/config/__init__.py - Event bus
infrastructure/events/__init__.py
Setup and settings
- First-run setup
features/setup/__init__.py
Other components
- User
- Watched folders
Connections 20
- User → Fuwa TUI app: uses
README.md - Fuwa TUI app → Configuration: loads settings
fuwa.py - Fuwa TUI app → File observer: starts observing
fuwa.py - Watched folders → File observer: supplies changes
README.md - File observer → Fuwa brain: provides activity
- Fuwa TUI app → Fuwa brain: creates
fuwa.py - Fuwa brain → LLM requests: requests reactions
features/brain/__init__.py - LLM requests → LLM provider: sends requests
infrastructure/llm/__init__.py - Fuwa brain → File memories: reads and updates
features/brain/__init__.py - Fuwa brain → Configuration: reads and updates
features/brain/__init__.py - Fuwa TUI app → Event bus: creates bus
fuwa.py - Fuwa brain → Event bus: publishes updates
features/brain/__init__.py - Fuwa TUI app → Chat UI: uses interface
fuwa.py - Fuwa TUI app → Dashboard UI: uses interface
fuwa.py - Fuwa TUI app → Settings UI: uses interface
fuwa.py - Settings UI → Configuration: loads and saves
features/settings_ui/__init__.py - Fuwa TUI app → Axolotl animation: renders buddy
fuwa.py - Axolotl animation → ANSI image conversion: converts sprites
features/axolotl/__init__.py - User → First-run setup: configures
README.md - First-run setup → Configuration: writes settings
features/setup/__init__.py