# **omi**
### A 2nd brain you trust more than your 1st
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.
[](http://discord.omi.me)
[](https://github.com/BasedHardware/Omi)
[](https://opensource.org/licenses/MIT)
[Website](https://omi.me/) · [Docs](https://docs.omi.me/) · [Discord](http://discord.omi.me) · [Twitter](https://x.com/kodjima33) · [DeepWiki](https://deepwiki.com/BasedHardware/omi)
Quick Start
bash
git clone https://github.com/BasedHardware/omi.git && cd omi/desktop && ./run.sh --yolo
Builds 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
Full Installation
For local development with the full backend stack: 1. Install prerequisites ```bash xcode-select --install curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh ``` 2. Clone and configure ```bash git clone https://github.com/BasedHardware/omi.git cd omi/desktop cp Backend-Rust/.env.example Backend-Rust/.env ``` 3. Build and run ```bash ./run.sh ``` See [desktop/README.md](desktop/README.md) for environment variables and credential setup. ### Mobile App ```bash cd app && bash setup.sh ios # or: bash setup.sh android ```How it works
``` ┌─────────────────────────────────────────────────────────┐ │ Your Devices │ │ │ │ ┌──────────┐ ┌──────────────┐ ┌───────────────────┐ │ │ │ Omi │ │ macOS App │ │ Mobile App │ │ │ │ Wearable │ │ (Swift/Rust) │ │ (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/`](desktop/) | Swift, SwiftUI, Rust backend | | Mobile app | [`app/`](app/) | Flutter (iOS & Android) | | Backend API | [`backend/`](backend/) | Python, FastAPI, Firebase | | Firmware | [`omi/`](omi/) | nRF, Zephyr, C | | Omi Glass | [`omiGlass/`](omiGlass/) | ESP32-S3, C | | SDKs | [`sdks/`](sdks/) | React Native, Swift, Python | | AI Personas | [`web/personas-open-source/`](web/personas-open-source/) | Next.js |Documentation
Getting Started
Building Apps
- App Development Guide
- Example Apps — GitHub, Slack, OmiMentor
- Audio Streaming Apps
- Custom Chat Tools
- Submit to App Store
API & SDKs
- API Reference — REST endpoints for memories, conversations, action items
- Python SDK
- Swift SDK
- React Native SDK
- MCP Server — Model Context Protocol integration
Architecture
Omi Hardware
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
License
MIT — see LICENSE