BasedHardware/omi

BasedHardware/omi has 13,916 GitHub stars and 2,695 forks. GitHot measured +7 stars in 24 hours, +52 in 7 days, and +108 in 15 days. Last checked 2026-11-07 21:43 UTC. Last push 2026-11-01.

How these counts are measured

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

13,916 stars 2,695 forks +7 in 24h

Measured star growth

in 24h: +7
in 7 days: +52
in 15 days: +108
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

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.

Website · Developer Docs · Help Center · Discord

What is Omi?

Omi is an open-source AI wearable platform: a necklace that captures conversations, apps for phone and desktop, and a backend that turns what you say into memory you can search and chat with. The mobile apps, desktop apps, backend, firmware, and hardware designs are all open source in this repository (MIT); the hosted Omi Cloud service and paid plans are described at omi.me.

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

In a development worktree, run make setup once. It installs the Git hooks and syncs the pinned backend Python environment that some pre-push checks use. Mobile and desktop environments stay 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.template ../../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)    │  │
│  └─────────┘  └──────────┘  └─────────┘  └──────────┘  │
│  ┌─────────┐  ┌──────────┐  ┌─────────┐  ┌──────────┐  │
│  │ STT     │  │ Firestore│  │ Redis   │  │ LLMs     │  │
│  │         │  │ (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

Everything for builders lives at docs.omi.me: apps and webhooks, the Developer API, the MCP server, the CLI, SDKs, hardware, and how Omi works. End-user guides live in the help center.

What is Omi · Choose your path
Developer API · API reference
Build apps · MCP server · CLI · SDKs
Hardware & firmware · Open hardware files
Developer changelog

Omi Hardware

Omi

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

Omi Wearable Omi Glass

Contributing

Contributions are welcome: bug reports with reproductions, apps and integrations built on the platform, community ports, and core PRs. Read the contribution guide and CONTRIBUTING.md first; PRODUCT.md describes the product direction and invariants. Paid, team-posted bounties appear on issues labeled "Paid Bounty 💰".

Community: Discord · Code of Conduct. User support: help.omi.me. Business and legal: [email protected].

License

MIT. See LICENSE.