# Nomily AI

> **录音设备 → Nomily AI → 你的 API Key → 你的 AI**

<p align="center">
  <img src="media/nomily-workflow-banner.png" width="100%" alt="Nomily AI BYOK 语音录制工作流：从录音设备到转录、摘要与 AI 服务商">
</p>

<p align="center">
  <a href="https://github.com/Nomily-Ai/nomily-ios"><img src="https://img.shields.io/badge/iOS%20%2B%20Apple%20Watch-SwiftUI-111318?style=for-the-badge&logo=swift&logoColor=white" alt="iOS 与 Apple Watch 客户端"></a>
  <a href="https://github.com/Nomily-Ai/nomily-android"><img src="https://img.shields.io/badge/Android-Jetpack%20Compose-3DDC84?style=for-the-badge&logo=android&logoColor=white" alt="Android 客户端"></a>
  <a href="https://geekis.com"><img src="https://img.shields.io/badge/BYOK-Your%20Key%20Your%20AI-E4002B?style=for-the-badge" alt="自带密钥"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Source--available-4B5563?style=for-the-badge" alt="源码可用许可"></a>
</p>

<p align="center">
  <a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-TW.md">繁體中文</a>
</p>

**面向 V05E、Apple Watch 与 iPhone 导入音频的 BYOK 录音伴侣：支持 ASR 转录、说话人分离、AI 摘要与本地 ASR 端点。**

Nomily AI 将录音带入原生客户端，使用你配置的服务商转录，并通过你选择的 AI 服务商生成摘要。

这是项目入口仓库；可运行的原生客户端位于
[`nomily-ios`](https://github.com/Nomily-Ai/nomily-ios) 与
[`nomily-android`](https://github.com/Nomily-Ai/nomily-android)。

## 快速链接

| 🌐 在线演示 | 🎥 演示视频 | 𝕏 动态 | 📚 文档 |
|---|---|---|---|
| [体验固定示例预览](https://geekis.com/demo/) | [Nomily AI YouTube Shorts](https://www.youtube.com/@Nomily-Ai/shorts) | [@nomilyai](https://x.com/nomilyai) | [Geekis.com](https://geekis.com) |

## 选择你的路径

| 目标 | 从这里开始 |
| --- | --- |
| 构建 iPhone 或 Apple Watch 客户端 | [nomily-ios](https://github.com/Nomily-Ai/nomily-ios) |
| 构建 Android 客户端 | [nomily-android](https://github.com/Nomily-Ai/nomily-android) |
| 不使用设备、Key 或上传文件，先体验流程 | [体验固定示例 Demo](https://geekis.com/demo/) |
| 获取支持、反馈文档或咨询许可 | [SUPPORT.md](SUPPORT.md) · [nomily@geekis.com](mailto:nomily@geekis.com) |

本仓库不是可直接安装的客户端，也不是 Docker 部署项目。开始本地构建前，请阅读对应客户端仓库的构建说明。

## Nomily AI 是什么？

Nomily AI 不是托管的转录账户或共享录音云，而是面向录音与用户自选 AI 服务的原生配套工作流。转录与摘要服务商由用户选择。

公开仓库提供源码审阅与本地构建。源码提交并不代表应用商店可用、设备/固件兼容，或生产服务已经发布。

## 当前可以做什么

- 连接 V05E BLE 录音器工作流、下载录音并管理本地录音库。
- 在 iPhone 导入录音，包括 Apple Watch 伴侣传回的录音。
- 通过 Azure Speech 或由用户运营的 local faster-whisper-compatible ASR 端点转录实时或已录制音频；Azure 转录支持最多 10 位说话人分离。
- 通过已配置的 LLM 服务商生成摘要、标题和翻译：OpenAI、Anthropic、Gemini、OpenRouter、Ollama 或自定义 OpenAI-compatible endpoint。
- 提供原生 iOS / Apple Watch 与 Android 实现，而非跨平台套壳。

## 隐私与服务商边界

Nomily AI 不是托管转录账户或共享录音云。API Key 由用户提供，绝不可提交到仓库。请勿在 Issue 或 Pull Request 中提交录音、转录文本、设备标识、日志、生成配置或访问凭据。

| 服务层 | 已配置工作流中发送的数据 | 由谁提供 |
|---|---|---|
| Nomily AI 客户端 | 客户端上的录音库、传输状态与生成文件 | 由你安装和运行客户端。 |
| Azure Speech | 选择 Azure 时用于转录的音频 | 你的 Azure 账户与 Key。 |
| 本地 ASR 端点 | 选择本地端点时用于转录的音频 | 由你运行该端点。 |
| LLM 服务商 | 用于摘要、标题或翻译所需的转录文本 | 你选择的服务商、模型、端点与 Key。 |

公开仓库不包含共享 Nomily AI 云、内置服务商账户或完整自托管同步栈。本地 ASR 与 Ollama 是服务商集成，不代表整个产品均可自托管。

## 工作流程

```text
V05E 录音器 / Apple Watch / iPhone 导入音频
                  │
                  ▼
          Nomily AI 原生客户端
   本地录音库 · 传输 · 播放
                  │
        ┌─────────┴──────────┐
        ▼                    ▼
Azure Speech 或         你的 LLM 服务商
本地 ASR 端点            摘要 · 标题 · 翻译
选择 Azure 时支持         OpenAI · Anthropic · Gemini
说话人分离                OpenRouter · Ollama · 兼容端点
        │                    │
        └─────────┬──────────┘
                  ▼
             转录文本与摘要
```

<p align="center">
  <img src="media/diagrams/nomily-byok-data-flow.svg" width="900" alt="Nomily AI BYOK 数据流，展示用户配置的 ASR 与 AI 服务商">
</p>

## 录音输入支持

| 输入来源 | 当前源码状态 | 说明 |
|---|---|---|
| V05E 录音器 | 两个客户端均已实现 | 主要 BLE 录音输入；兼容性仍取决于实际测试设备和固件。 |
| iPhone 导入音频 | `nomily-ios` 已实现 | iPhone 是导入、管理、转录与摘要客户端。 |
| Apple Watch 麦克风 | `nomily-ios` 已实现 | 已配对的 Watch 伴侣将录音传回 iPhone。 |
| 其他录音器型号 | 未承诺 | 可以录音不等于已被支持。 |
| Android Watch 伴侣 | 未发布 | 不应从 Android App 源码推断 Wear OS 客户端。 |

<p align="center">
  <img src="media/diagrams/recording-input-support.svg" width="900" alt="Nomily AI 录音输入支持与未来设备边界">
</p>

在假定某个录音器已被支持前，请先查看可扩展的[设备兼容矩阵](media/devices/README.md)。

## Apple Watch 伴侣

在配对 iPhone 安装 Nomily AI 后，按以下方式安装 Watch 伴侣：

1. 打开 iPhone 的 **Watch** App，并滚动到 **可用 App**。
2. 找到 **Nomily AI**，点击 **安装**。
3. 在 iPhone 的 Nomily AI 内打开 **Settings → Apple Watch**，确认显示 **Installed**。
4. 未携带 V05E 时，在 Apple Watch 打开 Nomily AI 录音；录音会同步回 iPhone 的 Nomily AI，用于转录、整理和摘要。

| 从 Watch App 安装 | 在 Nomily AI 设置中确认 | 在 Apple Watch 录音 |
|---|---|---|
| <img src="media/apple-watch-install-nomily-ai.png" alt="iPhone Watch App 中 Nomily AI 的安装按钮" width="250"> | <img src="media/apple-watch-settings.png" alt="Nomily AI 设置显示 Apple Watch 已安装" width="250"> | <img src="media/apple-watch-recording.png" alt="Nomily AI 在 Apple Watch 上准备录音" width="250"> |

### 计划中或未发布

| 项目 | 状态 |
|---|---|
| 其他录音器型号与协议 | 仅在相关固件完成测试后才会确认兼容性。 |
| Android Watch 伴侣 | 未发布。 |
| RAG、MCP、共享自托管同步 | 当前公开客户端源码未体现，尚非已宣布能力。 |
| 无需 Key 的在线演示 | 固定数据预览已在 [Geekis.com/demo](https://geekis.com/demo/) 上线；不会上传音频、调用 ASR 或 LLM 服务，也不会存储 Key。 |

## 仓库关系

| 仓库 | 角色 | 关系 |
|---|---|---|
| **nomily-app** | 项目入口、跨项目文档、许可与预览素材 | 从这里开始；本仓库本身不包含可安装客户端。 |
| [`nomily-ios`](https://github.com/Nomily-Ai/nomily-ios) | iPhone 与 Apple Watch 的 SwiftUI 客户端 | 有独立原生工程、构建说明与 Issue 追踪。 |
| [`nomily-android`](https://github.com/Nomily-Ai/nomily-android) | Android Kotlin / Jetpack Compose 客户端 | 有独立原生工程、构建说明与 Issue 追踪。 |
| `nomily-site` | 私有静态站点部署源码 | 承载设置和演示材料；不是移动客户端源码仓库。 |

## 构建与项目结构

客户端共享产品概念与协议预期，但属于独立的原生实现。选择构建路径前，请先阅读对应仓库：

```text
nomily-app/       项目说明、许可、公开预览素材
nomily-ios/       iOS App、Watch 伴侣、BLE / ASR / 本地录音库模块
nomily-android/   Android App，以及协议、加密、音频、ASR、LLM 核心模块
nomily-site/      私有静态部署源码，用于指南与演示
```

| 目标 | 从这里开始 |
|---|---|
| 构建 iPhone 或 Apple Watch | [`nomily-ios`](https://github.com/Nomily-Ai/nomily-ios)：macOS、Xcode 15+ 与实体 iPhone；Apple Watch 可选。 |
| 构建 Android | [`nomily-android`](https://github.com/Nomily-Ai/nomily-android)：JDK 21、Android Studio 或 Gradle 与实体 Android 手机。 |
| 报告缺陷 | 在受影响的原生客户端仓库创建 Issue，并提供脱敏后的复现步骤。 |
| 获取支持或反馈入口仓问题 | 查看 [SUPPORT.md](SUPPORT.md)，或发送邮件至 [nomily@geekis.com](mailto:nomily@geekis.com)。 |
| 查看条款 | 阅读 [Nomily Small Team License](LICENSE)。 |

## App 预览

| 录音库 | 转录服务商 | 用于摘要的 LLM 服务商 |
|---|---|---|
| <img src="media/app-recordings.png" alt="Nomily AI 录音库" width="200"> | <img src="media/app-asr-providers.png" alt="Nomily AI 转录服务商设置" width="200"> | <img src="media/app-llm-providers.png" alt="Nomily AI LLM 服务商和模型选择" width="200"> |

截图使用合成或非敏感预览数据。复用产品图片或品牌素材前请查看 [`media/README.md`](media/README.md)。

### Android 工作流截图

| 录音详情 | ASR 配置 | LLM 配置 | 摘要模板 |
|---|---|---|---|
| <img src="media/screenshots/android/recording-detail.png" alt="Android 录音详情，包含转录和导出操作" width="180"> | <img src="media/screenshots/android/asr-providers.png" alt="Android ASR 服务商设置，Key 字段已遮蔽" width="180"> | <img src="media/screenshots/android/llm-providers.png" alt="Android LLM 服务商配置，使用占位值" width="180"> | <img src="media/screenshots/android/summary-templates.png" alt="Android 摘要模板" width="180"> |

这些截图使用非敏感预览数据，展示 Android 客户端工作流；不代表服务商可用性、设备兼容性或应用商店已发布。

## 许可

源码使用 [Nomily Small Team License 1.0.0](LICENSE)。个人使用以及 10 人及以下团队可使用；更大团队需要单独的付费许可。商业许可请联系 <nomily@geekis.com>。这是一份源码可用许可，并非 OSI 批准的开源许可证。

[`media/`](media/) 中的品牌素材不包含在该许可内，详见 [`media/README.md`](media/README.md)。

## 社区与安全

提交改动前请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。一般支持请查看 [SUPPORT.md](SUPPORT.md)。
安全漏洞请按照 [SECURITY.md](SECURITY.md) 私密报告，不要公开提交 Issue。

## Star 历史

[![Star History Chart](https://api.star-history.com/svg?repos=Nomily-Ai/nomily-app&type=date&legend=top-left)](https://www.star-history.com/#Nomily-Ai/nomily-app&type=date&legend=top-left)