N°487 REPOSITORY DETAIL · 仓库详情

Open Source · GITHUB

omi – BasedHardware

BasedHardware/omi

前端 Web 框架 / UI 库

13,073 Stars 2,139 Forks Dart MIT

Views · 浏览

项目简介

能查看你的屏幕、聆听你的对话，并告诉你该做什么的AI

一键直达 GitHub Gitee 搜索访问主页

SECTION · 01

关键指标一览

Stars 数

13,073

Forks 数

2,139

Watchers 数

13,073

Issue 数

654

主要语言

Dart

许可证

MIT

仓库所有者

BasedHardware

创建时间

2024.03.22

更新时间

2026.07.27

主题标签

人工智能应用脑机接口 C Flutter 朋友移动项链 Next.js omi 角色 Python 智能眼镜摘要转录可穿戴设备

SECTION · 03

README 详细介绍

README 原文为英文,如需阅读完整中文内容,建议使用 浏览器翻译插件(如 Edge 浏览器自带翻译、Google 翻译扩展)进行整页翻译。

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](http://discord.omi.me)
![GitHub Repo stars](https://github.com/BasedHardware/Omi)
![License: MIT](https://opensource.org/licenses/MIT)

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 omidesktopwindows
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
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Clone and configure

git clone https://github.com/BasedHardware/omi.git
cd omi/desktop/macos
cp Backend-Rust/.env.example Backend-Rust/.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/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 | <code class="ra0-md-code">desktop/macos/</code> | Swift, SwiftUI, Rust backend |
| Mobile app | <code class="ra0-md-code">app/</code> | Flutter (iOS & Android) |
| Backend API | <code class="ra0-md-code">backend/</code> | Python, FastAPI, Firebase |
| Firmware | <code class="ra0-md-code">omi/</code> | nRF, Zephyr, C |
| Omi Glass | <code class="ra0-md-code">omiGlass/</code> | ESP32-S3, C |
| SDKs | <code class="ra0-md-code">sdks/</code> | React Native, Swift, Python |
| AI Personas | <code class="ra0-md-code">web/personas-open-source/</code> | Next.js |