BasedHardware/omi

AI that sees your screen, listens to your conversations and tells you what to do

13,455

stars

33,109

commits

Swift

primary language

Sep 11, 2026

updated

omi.me

app

bci

flutter

friend

mobile

necklace

nextjs

omi

personas

python

smartglasses

summary

transcription

wearable

Browse cluster: Flutter & Dart Mobile Development →

README

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.

Website · Docs · Discord · Twitter · DeepWiki

Quick Start

macOS

git clone https://github.com/BasedHardware/omi.git && cd omi/desktop/macos && ./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

Windows

git clone https://github.com/BasedHardware/omi.git
cd omi\desktop\windows
npm install
copy .env.example .env
npm run dev

Starts 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 setup

Full 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.sh

See desktop/macos/README.md for environment variables and credential setup.

Mobile App

cd app && bash setup.sh ios    # or: bash setup.sh android

Try in Browser

How 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

Documentation

Getting Started

Introduction
Quick Start Guide
macOS App Development
Mobile App Setup
Backend Setup
Contributing — also CONTRIBUTING.md and PRODUCT.md

Building Apps

API & SDKs

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

Architecture

Omi Hardware

Omi

Open-source AI wearables that pair with the mobile app for 24h+ continuous capture.

Omi Wearable Omi Glass

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

Contributors

(top 30 of 245)

5,837 commits

5,639 commits

5,399 commits

3,035 commits

Similar repos

zetic-ai/awesome-on-device-ai-apps

Open-source production-ready mobile server-less AI apps. Clone, customize, and ship on Android &…

similar language mix

cogwheel0/conduit

Native iOS and Android client for Open WebUI, direct OpenAI-compatible, Ollama, and Hermes agents.

2,083

similar language mix

SimpleOpenSoftware/chronicle

A project to provide the simplest, self hosted route to get "I want AI to help me by passively…

shared contributors

bykof/conversationaly

Privacy-first AI meeting assistant. Captures mic + system audio, transcribes live, and writes the…

shared topics

gabrimatic/local-whisper

Offline-first voice dictation, transcription, cleanup, and text-to-speech for macOS, iOS, and…

shared topics

marchellodev/sharik

Sharik is an open-source, cross-platform solution for sharing files via Wi-Fi or Mobile Hotspot

1,277

shared topics

pichillilorenzo/flutter_inappwebview

A Flutter plugin that allows you to add an inline webview, to use a headless webview, and to open…

3,767

shared topics

seemoo-lab/openhaystack

Build your own 'AirTags' 🏷 today! Framework for tracking personal Bluetooth devices via Apple's…

13,524

similar language mix

Languages

Swift

24.1%

Python

23.1%

Dart

21.9%

TypeScript

17.0%

9.3%

Shell

1.1%

BasedHardware/omi

AI that sees your screen, listens to your conversations and tells you what to do

13,455

stars

33,109

commits

Swift

primary language

Sep 11, 2026

updated

omi.me

app

bci

flutter

friend

mobile

necklace

nextjs

omi

personas

python

smartglasses

summary

transcription

wearable

Browse cluster: Flutter & Dart Mobile Development →

README

omi

A 2nd brain you trust more than your 1st

Trusted by 300,000+ professionals.

Website · Docs · Discord · Twitter · DeepWiki

Quick Start

macOS

git clone https://github.com/BasedHardware/omi.git && cd omi/desktop/macos && ./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

Windows

git clone https://github.com/BasedHardware/omi.git
cd omi\desktop\windows
npm install
copy .env.example .env
npm run dev

Starts the Windows desktop app from source using the public config in .env.example.

Requirements: Node.js

make setup

Full 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.sh

See desktop/macos/README.md for environment variables and credential setup.

Mobile App

cd app && bash setup.sh ios    # or: bash setup.sh android

Try in Browser

How 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

Documentation

Getting Started

Introduction
Quick Start Guide
macOS App Development
Mobile App Setup
Backend Setup
Contributing — also CONTRIBUTING.md and PRODUCT.md

Building Apps

API & SDKs

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