A streamlined implementation of the Omi wearable AI device, focusing on core audio capture and BLE connectivity features.
This is a minimal fork of the Omi project that provides:
- 🎙️ Real-time audio streaming from Omi hardware to mobile app
- 📱 Cross-platform Flutter application (iOS, Android, Desktop)
- 🔊 Offline audio recording with device storage
- 🔄 Over-the-air (OTA) firmware updates
- 🎯 Simplified, focused feature set for audio capture
- BLE Device Discovery: Automatic scanning and connection to Omi devices
- Audio Streaming: Real-time audio capture with Opus codec support
- Recording Management: Save, play, share, and delete audio recordings
- Firmware Updates: Built-in OTA/DFU support for keeping device up-to-date
- Cross-Platform: Runs on iOS, Android, macOS, Windows, and Linux
- Zephyr RTOS: Built on robust real-time operating system
- Audio Codecs: PCM8/16, Opus, and μLaw support
- Offline Recording: Continue recording when disconnected from app
- Button Controls: Configurable button gestures for device control
- Low Power: Optimized for extended battery life
- Flutter SDK (latest stable)
- For firmware development: Docker or nRF Connect SDK v2.7.0
- Omi hardware device or compatible nRF52840 development board
# Clone the repository
git clone https://github.com/yourusername/my-omi.git
cd my-omi
# Install dependencies
flutter pub get
# Run the app
flutter run# Using Docker (recommended)
cd firmware
./scripts/build-docker.sh
# The firmware package will be at:
# firmware/build/docker_build/zephyr.zipComprehensive documentation is available in the docs/ directory:
- Documentation Index - Start here for navigation
- Getting Started Guide - First-time setup
- Architecture Overview - Technical deep-dives
- Build Instructions - Detailed build guides
This minimal fork implements core functionality while removing complex features from the original Omi project. See progress tracking for implementation status.
- ✅ BLE connection and device discovery
- ✅ Audio streaming and recording
- ✅ File management (save/play/share/delete)
- ✅ Firmware OTA updates
- ✅ Basic UI for all core features
- ✅ Button controls implemented (single tap = record toggle)
- ✅ Visual button event indicators in app
- ✅ Automatic firmware updates (v2.0.10 bundled)
- ✅ Improved firmware version detection
We welcome contributions! Please see our contributing guidelines for details on:
- Code style and standards
- Testing requirements
- Pull request process
- Issue reporting
This project is designed for Omi hardware devices based on the nRF52840 chip. Compatible boards include:
- Omi v1/v2 devices
- Seeed XIAO nRF52840 Sense (for development)
- Custom boards following Omi specifications
This project inherits the license from the original Omi project. See LICENSE for details.
This minimal fork is based on the excellent work of the Based Hardware team and the Omi community. We've focused on simplifying the codebase while maintaining core functionality for audio capture use cases.