Repository navigation
FUMI v0.1.0 — Initial Public Preview
FUMI v0.1.0 — Initial Public Preview
Meet FUMI, an open-source AI companion designed to live on your desk.
Built around the ESP32-S3, FUMI combines an animated round display, virtual pet mechanics, voice interaction, and configurable AI models in a compact physical device.
What's Included
- ESP32-S3 firmware with an LVGL-based interface
- Animated companion interface and pet-state system
- Backend endpoints for AI interaction and voice processing
- Configurable text-model and speech-to-text providers
- Optional device-token authentication
- Browser-based demo
- Hardware setup scripts and documentation
- API reference and troubleshooting guides
- Backend smoke tests and GitHub Actions workflow
Hardware
The reference implementation targets the Waveshare ESP32-S3 Touch LCD 1.46 development board.
Important Notes
This is an initial public preview. Firmware compilation, provider compatibility, and complete hardware validation should be verified against the documented configuration before treating this release as production-ready.
Some features require external AI providers, API credentials, and a running backend.
Getting Started
- Read the README.
- Follow the firmware setup instructions.
- Configure the backend using
backend/.env.example. - Review the hardware and testing documentation.
- Never commit API keys, Wi-Fi passwords, or device tokens.
What's Next
FUMI aims to make physical AI companions easier to build, customize, and extend.
Contributions, bug reports, and feature requests are welcome.