Get Started with Omi DevKit 2

Step 1: Power On Your DevKit
The DevKit 2 has multiple power options:- Switch method: Use the physical switch if available on your version
- Button method: Press and hold the center button for 3 seconds
- USB-C: Can be powered directly via USB-C connection
Step 2: Development Environment Setup
Before using your DevKit, set up your development environment:For App Development
- Download the Omi app: iOS App Store | Google Play
- Follow our App Development Guide
For Firmware Development
- Install the firmware compilation tools
- Set up the development environment

Step 3: Flash Firmware (If Needed)
DevKits may not come with firmware pre-installed:- Check if your device shows any LED activity when powered
- If no activity, flash the firmware here
- Follow the DevKit 2 testing guide
Step 4: Pair with App
- Open the Omi app
- Follow pairing instructions
- The DevKit should appear as a discoverable device
- Test transcription by speaking near the device
Button Controls
Single Press
- Turn On/Off: Single press to power the device on or off
Long Press (Voice Questions)
- Press and hold the button until you feel a vibration
- Keep pressed down and ask your question
- Release the button when you’re done speaking
- Get your answer in the Omi chat or as a notification on your phone
Light Indicators
Understanding your DevKit’s status through LED colors:- 🔴 Red: Device is turned on but disconnected from your phone
- 🔵 Blue: Device is turned on and connected to your phone
- 🟠 Orange: Device is charging and disconnected from your phone
- 🟢 Teal: Device is charging and connected to your phone
Developer Features
- 🔧 Firmware Customization
- 📊 Development Testing Tools
- 🎙️ Audio Streaming API
- 💾 Local Storage Access
- 🔌 GPIO Access (advanced users)
- 📡 Protocol Testing
Development Resources
Building Custom Apps
Building Custom Apps
Learn how to build your own omi apps with our comprehensive guide. You can create apps in just 2 minutes!
Backend Integration
Backend Integration
Understand how to integrate with the omi backend: Backend Setup Guide
Audio Streaming
Audio Streaming
Access real-time audio data: Audio Streaming Documentation
Firmware Development
Firmware Development
Customize the device firmware: Firmware Compilation Guide
Testing Your DevKit
- LED Test: Device should show LED activity when powered
- Bluetooth Test: Should appear in Bluetooth discoverable devices
- Audio Test: Speak near the device and check for transcription
- App Connection: Should maintain stable connection with the app
Troubleshooting
No LED activity
No LED activity
- Check power connection (USB-C or battery)
- Try different power methods (switch vs button)
- Flash firmware if device is completely unresponsive
Firmware flashing issues
Firmware flashing issues
- Ensure device is in DFU mode
- Check USB-C cable and connection
- Follow the detailed flashing guide
Development environment issues
Development environment issues
- Review development setup guide
- Check contribution guidelines
- Ask for help in our Discord
Community & Support
- Developer Discord: Join discord.omi.me for development discussions
- GitHub: Contribute to BasedHardware/omi
- Documentation: Full docs at docs.omi.me
- Email Support: help@omi.me
← Back to device selection