📦BasedHardware / omi
← 返回首页
AI that sees your screen, listens to your conversations and tells you what to do
⚖️ MIT#ai#app#flutter#friend#mobile🌐 omi.me📅 创建于 2024-03-22🔄 更新于 2026-10-29
🔗 GitHub Python

📄 仓库 README

在 GitHub 查看 ↗
来自 GitHub 仓库自述文件 · 版权归原作者所有
# **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. [![Discord](https://img.shields.io/discord/1192313062041067520?label=Discord&logo=discord&logoColor=white&style=for-the-badge)](http://discord.omi.me)  [![GitHub Repo stars](https://img.shields.io/github/stars/BasedHardware/Omi?style=for-the-badge)](https://github.com/BasedHardware/Omi)  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](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

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

The pre-push hook first runs scripts/worktree_env_doctor.py, which fails in seconds when a phase the push selects needs local state this worktree lacks (app dependencies, backend/.venv, a stale SwiftPM .build) and prints the one command that fixes it. Run python3 scripts/worktree_env_doctor.py --all --fix to bring a new worktree's app, backend, and desktop state up front.

Full Installation For local development with the full backend stack: 1. Install prerequisites 
xcode-select --install
uv --version
2. Clone and configure 
git clone https://github.com/BasedHardware/omi.git
cd omi/desktop/macos
cp ../../backend/.env.example ../../backend/.env
3. Build and run 
./run.sh
See [desktop/macos/README.md](https://github.com/BasedHardware/omi/blob/HEAD/desktop/macos/README.md) for environment variables and credential setup. ### Mobile App 
cd app && bash setup.sh ios    # or: bash setup.sh android

Download for macOS Download on the App Store Get it on Google Play

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)    │  │
│  └─────────┘  └──────────┘  └─────────┘  └──────────┘  │
│                                                         │
│  ┌─────────┐  ┌──────────┐  ┌─────────┐  ┌──────────┐  │
│  │ Soniox  │  │ Firestore│  │ Redis   │  │ LLMs     │  │
│  │ (STT)   │  │ (DB)     │  │ (Cache) │  │ (AI)     │  │
│  └─────────┘  └──────────┘  └─────────┘  └──────────┘  │
└─────────────────────────────────────────────────────────┘
| Component | Path | Stack | |-----------|------|-------| | **macOS app** | [`desktop/macos/`](https://github.com/BasedHardware/omi/blob/HEAD/desktop/macos/) | Swift, SwiftUI, Python desktop backend | | Mobile app | [`app/`](https://github.com/BasedHardware/omi/blob/HEAD/app/) | Flutter (iOS & Android) | | Backend API | [`backend/`](https://github.com/BasedHardware/omi/blob/HEAD/backend/) | Python, FastAPI, Firebase | | Firmware | [`omi/`](https://github.com/BasedHardware/omi/blob/HEAD/omi/) | nRF, Zephyr, C | | Omi Glass | [`omiGlass/`](https://github.com/BasedHardware/omi/blob/HEAD/omiGlass/) | ESP32-S3, C | | SDKs | [`sdks/`](https://github.com/BasedHardware/omi/blob/HEAD/sdks/) | Device (Python/Swift/RN + multi-lang protocol) | | AI Personas | [`web/personas-open-source/`](https://github.com/BasedHardware/omi/blob/HEAD/web/personas-open-source/) | Next.js |

Documentation

Getting Started

Building Apps

API & SDKs

Architecture

Omi Hardware

Omi

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

Omi Wearable Omi Glass

License

MIT — see LICENSE

📈 近 7 天 Star 趋势

每日新增 Star（柱）与累计 Star（线）· 数据来自 GitHub

🏆 排名变化趋势

在各榜单中的排名历史（数字越小越靠前）

📋 历史上榜记录

每次快照的详细数据
日期 榜单 排名 周期新增 总 STAR