BasedHardware/omi: +66 stars this week

Rank of BasedHardware/omi in each topic for today, this week and this month
Topic	Today	This week	This month
Flutter & cross-platform topic	–	#68of 85	#82of 138
Speech & voice topic	–	#90of 100	#98of 131
Web frameworks topic	–	#205of 267	#261of 435
Python topic	–	#968of 1142	#1091of 1527

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