Omi captures your screen and conversations, transcribes in real-time, generates summaries and action items, and gives you an AI chat that remembers everything you've seen and heard. Works on desktop, phone and wearables. Fully open source.
Trusted by 300,000+ professionals.
git clone https://github.com/BasedHardware/omi.git && cd omi/desktop/macos && ./run.sh --yoloBuilds the macOS app, connects to the cloud backend, and launches. No env files, no credentials, no local backend.
Requirements: macOS 14+, Xcode (includes Swift & code signing), Node.js
git clone https://github.com/BasedHardware/omi.git cd omi\desktop\windows npm install copy .env.example .env npm run devStarts the Windows desktop app from source using the public config in
.env.example.Requirements: Node.js
For development worktrees, run the baseline local setup once. It installs the Git hooks and syncs the pinned backend Python environment used by selected pre-push checks; mobile and desktop runtime environments remain opt-in.
make setupFull Installation
For local development with the full backend stack:
- Install prerequisites
xcode-select --install uv --version
- Clone and configure
git clone https://github.com/BasedHardware/omi.git cd omi/desktop/macos cp ../../backend/.env.example ../../backend/.env
- Build and run
./run.shSee desktop/macos/README.md for environment variables and credential setup.
cd app && bash setup.sh ios # or: bash setup.sh androidHow it works
┌─────────────────────────────────────────────────────────┐ │ Your Devices │ │ │ │ ┌──────────┐ ┌──────────────┐ ┌───────────────────┐ │ │ │ Omi │ │ macOS App │ │ Mobile App │ │ │ │ Wearable │ │ (Swift/Python) │ │ (Flutter) │ │ │ └────┬─────┘ └──────┬───────┘ └────────┬──────────┘ │ │ │ BLE │ HTTPS/WS │ │ └───────┼────────────────┼───────────────────┼─────────────┘ │ │ │ ▼ ▼ ▼ ┌─────────────────────────────────────────────────────────┐ │ Omi Backend (Python) │ │ │ │ ┌─────────┐ ┌──────────┐ ┌─────────┐ ┌──────────┐ │ │ │ Listen │ │ Pusher │ │ VAD │ │ Diarizer │ │ │ │ (REST) │ │ (WS) │ │ (GPU) │ │ (GPU) │ │ │ └─────────┘ └──────────┘ └─────────┘ └──────────┘ │ │ │ │ ┌─────────┐ ┌──────────┐ ┌─────────┐ ┌──────────┐ │ │ │ Deepgram│ │ Firestore│ │ Redis │ │ LLMs │ │ │ │ (STT) │ │ (DB) │ │ (Cache) │ │ (AI) │ │ │ └─────────┘ └──────────┘ └─────────┘ └──────────┘ │ └─────────────────────────────────────────────────────────┘
Component Path Stack macOS app desktop/macos/Swift, SwiftUI, Python desktop backend Mobile app app/Flutter (iOS & Android) Backend API backend/Python, FastAPI, Firebase Firmware omi/nRF, Zephyr, C Omi Glass omiGlass/ESP32-S3, C SDKs sdks/Device (Python/Swift/RN + multi-lang protocol) AI Personas web/personas-open-source/Next.js
- Introduction
- Quick Start Guide
- macOS App Development
- Mobile App Setup
- Backend Setup
- Contributing — also
CONTRIBUTING.mdandPRODUCT.md
- App Development Guide
- Example Apps — GitHub, Slack, OmiMentor
- Audio Streaming Apps
- Custom Chat Tools
- Submit to App Store
- API Reference — REST endpoints for memories, conversations, action items
- Device multi-lang protocol SDKs — shared BLE UUIDs/packet framing for TS/Go/Rust/C++/Dart
- Python device SDK — full BLE + Opus + Deepgram
- Swift device SDK
- React Native device SDK
- MCP Server — Model Context Protocol integration
Open-source AI wearables that pair with the mobile app for 24h+ continuous capture.
- Buy Omi
- Buy Omi Glass Dev Kit — ESP32-S3, camera + audio
- Open Source Hardware Designs
- Buying Guide
- Build the Device
- Flash Firmware
- Integrate Your Wearable
- Hardware Specs
MIT — see LICENSE