Omi：开源 AI 可穿戴记忆平台

项目简介

Omi 是一个开源的 AI 可穿戴平台：项链形态的硬件负责采集对话，配套的手机与桌面应用负责记录和交互，后端把你说过的话变成可以搜索、可以对话的记忆。

按项目自己的说法，它是一个「你比自己的大脑更信任的第二大脑」：捕获你的屏幕与对话，实时转写，生成摘要与待办事项，并提供一个记得你所见所闻的 AI 聊天。桌面端、手机端与可穿戴设备都可以使用。

仓库内的移动应用、桌面应用、后端、固件与硬件设计全部以 MIT 协议开源；托管的 Omi Cloud 服务与付费方案则在 omi.me 上提供。

主要功能

• 捕获与转写：录制屏幕与对话内容，实时转写为文字。
• 摘要与待办：自动生成摘要和 action items（待办事项）。
• 有记忆的 AI 聊天：对话中可引用你此前看到、听到的内容。
• 多端覆盖：macOS 桌面应用（Swift / SwiftUI + Python 桌面后端）、Windows 桌面应用、Flutter 移动应用（iOS 与 Android），以及浏览器版 app.omi.me。
• 开源硬件：Omi 项链与 Omi Glass（ESP32-S3），固件基于 nRF / Zephyr / C，硬件文件同样开放。
• 开发者生态：Developer API、Apps 与 Webhooks、MCP server、CLI、多语言 SDK（Python / Swift / React Native 等协议实现），以及基于 Next.js 的 AI Personas。

后端为 Python + FastAPI + Firebase，包含 Listen（REST）、Pusher（WebSocket）、VAD、Diarizer、STT、Firestore、Redis、LLM 等模块。

安装与使用

macOS 快速开始（需要 macOS 14+、Xcode、Node.js）：

git clone https://github.com/BasedHardware/omi.git && cd omi/desktop/macos && ./run.sh --yolo

该命令会构建 macOS 应用、连接云端后端并启动，不需要 env 文件或凭证，也不需要本地后端。

Windows 快速开始（需要 Node.js）：克隆仓库后进入 desktop/windows 目录，复制 .env.example 为 .env，然后执行 npm install 与 npm run dev，即可用公开配置从源码启动桌面应用。

在开发 worktree 中，先运行一次 make setup，它会安装 Git hooks 并同步固定的后端 Python 环境。

移动端：cd app && bash setup.sh ios（或 bash setup.sh android）。

完整本地后端：安装 Xcode 命令行工具与 uv，克隆仓库，把 backend/.env.template 复制为 backend/.env，在 desktop/macos 下执行 ./run.sh。

也可以直接下载安装包：macOS 版见 macos.omi.me，iOS 见 App Store（friend-ai-wearable），Android 见 Google Play（com.friend.ios），或在浏览器打开 app.omi.me 试用。

注意事项

• 项目使用 MIT 许可证；托管的 Omi Cloud 与付费方案由 omi.me 提供，不属于本仓库的开源部分。
• ./run.sh --yolo 走的是云端后端，适合快速体验；需要完整本地后端时才有必要配置 env 与凭证。
• 构建文档、环境变量与凭证说明见 desktop/macos/README.md 与 docs.omi.me。
• 硬件需要单独购买或自行制作，固件烧录与硬件文档在 docs.omi.me 上。

本作品整理自 GitHub 开源项目 BasedHardware/omi，原作者 @BasedHardware，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。