OpenMinis/OpenMinis
GitHub: OpenMinis/OpenMinis
OpenMinis 是一款免费开源的跨平台端侧 AI Agent 应用，通过集成主流大语言模型并结合本地 Linux 沙盒和深度系统能力调用，让 AI 能够在移动设备上执行复杂的自动化任务。
Stars: 1579 | Forks: 161
# OpenMinis
[](LICENSE)
[](#beta-programme)
**您的专属、端侧 AI agent。**
OpenMinis 将主流模型 —— Claude、GPT、Gemini 等 —— 引入原生的移动体验中，并为它们配备了一台真正可以操作的计算机：一个在您的设备上运行的全功能 Linux shell、浏览器自动化、可扩展的技能、持久化记忆以及深度的系统集成。
它是免费的，并且完全开源。
**我们相信，在 AI 时代，技术设计和代码不再是产品优势所在。最好的 agent 诞生于与用户紧密的反馈循环中 —— 他们的期望与反馈正是让这款产品趋于完美的关键。**
官方网站：**[openminis.app](https://openminis.app)**
## 它能做什么
| | |
|---|---|
| **自带模型 (Bring your own model)** | 通过您自己的 API key 或账号登录，使用 Claude、GPT、Gemini 及其他提供商。 |
| **真正的 Linux shell** | 一个沙盒化的 Alpine Linux 环境在设备本地运行 —— agent 可以安装 package、运行脚本并处理真实文件。 |
| **设备集成** | Health、Calendar、Reminders、Contacts、HomeKit、Bluetooth、Clipboard、Media、Alarms 等系统功能，均作为工具暴露给 agent。 |
| **浏览器自动化** | agent 可以代表您浏览网页并进行交互。 |
| **技能与记忆** | 可扩展的技能，以及跨会话的持久化记忆。 |
| **工作空间** | 将工作组织到独立的上下文中，可通过 `minis://workspace/` 进行访问。 |
| **原生卸载 (Native offloads)** | 将繁重或特定于平台的工作交给原生代码处理，而不是在沙盒中运行。 |
## 您可以用 Minis 做什么
以下是一些用户的实际使用场景：
- **拍摄美食照片，记录营养信息** —— Minis 会识别菜品，估算卡路里和宏量营养素，并将其写入 Apple Health。
- **听着您的时间线摘要醒来** —— Shortcuts 触发 Minis 获取您的 X 时间线，对其进行总结，合成语音，并作为您的闹钟铃声播放。
- **将群聊转化为任务** —— 从 Telegram 群组中提取消息，找出 bug 和待办事项，对它们进行去重，并存入 Apple Reminders。
- **挂载您的 Obsidian vault** —— 将研究、清理并编写好的 Markdown 笔记作为一个普通工作空间写回到该 vault 中。
- **将任何内容分享为日历事件** —— 通过 iOS Share Sheet 将页面或消息发送给 Minis，它会自动创建包含时间和地点的事件。
**→ [OpenMinis/AwesomeMinis](https://github.com/OpenMinis/AwesomeMinis)** —— 一个由社区贡献的精选集合，涵盖了健康、生产力、研究、金融和开发者工具等领域的各种用例与工作流。
## 技能
**技能** 是一个包含 `SKILL.md` 文件的文件夹 —— 其中包含了指令，以及可选的脚本、参考资料和资源 —— 当请求与其匹配时，agent 会按需加载。元数据会保留在上下文中以便触发；而正文和打包的资源仅在技能被实际使用时才会加载。
Minis 拥有专属的工具系统，但它不要求必须为其专门编写技能：**为 Claude、Codex、OpenClaw 或 Hermes Agent 构建的技能通常可以直接在 Minis 中原生运行。** 经过适配以使用 Minis 工具的技能会运行得更好 —— 它们可以直接调用 Linux shell、设备集成和原生卸载（native offloads）。
**→ [OpenMinis/MinisSkills](https://github.com/OpenMinis/MinisSkills)** —— 包含为 Minis 适配以及从头为其量身定制的技能集合，涵盖了 TTS、搜索、媒体下载、健康分析、云 API 等更多领域。
## 媒体报道
## Beta 计划
App Store 的发布可能会存在滞后：每次更新都需要等待审核，且在稳定性需要考量时，我们会暂缓发布构建版本。TestFlight 构建版本是修复补丁和新功能最先落地的地方。
**→ [加入 TestFlight beta](https://testflight.apple.com/join/3BdkA5c3)**
在 Android 平台上，[发布页面](https://github.com/OpenMinis/OpenMinis/releases)
始终提供最新的 APK。
## 从源码构建
Minis 在应用内内置了一个 Linux 沙盒，因此其原生依赖项（iOS 上的 iSH、Android 上的 PRoot、FFmpeg、LAME）以及 Alpine rootfs 都是**从源码构建**的，而不是以二进制文件的形式提交。
**→ 完整的首次构建指南请参见 [BUILDING.md](BUILDING.md)。**
简短版本如下：
```
git clone --recurse-submodules https://github.com/OpenMinis/OpenMinis.git
cd OpenMinis
# iOS — 顺序很重要：FFmpeg 链接 LAME
./deps/build_lame.sh && ./deps/build_ffmpeg.sh
./deps/build_ish.sh && ./deps/prepare_alpine_rootfs.sh
open src/ios/Minis.xcodeproj
# Android — 需要 NDK r28+
./deps/build_proot.sh && ./scripts/prepare_android_sandbox.sh
cd src/android && ./gradlew :app:assembleDebug
```
`BUILDING.md` 包含了各平台的工具链要求、构建时的自定义模板，以及针对您最可能遇到的失败场景的故障排除章节。
## 仓库结构
```
src/ios/ iOS app (Swift / SwiftUI) + share, widget and file-provider extensions
src/android/ Android app (Kotlin / Compose) + JNI native code
src/shared/ Assets shared by both platforms
deps/ Native dependency build scripts and vendored sources
docs/specs/ Architecture and interface specifications
scripts/ Rootfs preparation and developer tooling
```
## 许可证
OpenMinis 采用 **[GNU General Public License v3.0](LICENSE)** 授权。
该应用链接了基于 GPL 许可的组件 —— [iSH](https://github.com/OpenMinis/ish-arm64)
(GPLv3) 和 [PRoot](https://github.com/OpenMinis/proot) (GPLv2) —— 因此组合后的作品根据 GPLv3 进行分发。内置的第三方许可证列表请参见
[THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md)。
## 社区
- **Telegram**：[加入群组](https://t.me/+2NzhOJuzRyI1YmM1)
- **Issues**：通过
[GitHub Issues](https://github.com/OpenMinis/OpenMinis/issues) 提交 Bug 报告、功能请求并进行讨论
本仓库是私有开发树的镜像，因此它**不接受 pull request** —— 因为它们没有可以合并的地方。Issues 是塑造这款产品的方式，并且 [AwesomeMinis](https://github.com/OpenMinis/AwesomeMinis)
和 [MinisSkills](https://github.com/OpenMinis/MinisSkills) 都接受社区贡献。详情请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 它能做什么
| | |
|---|---|
| **自带模型 (Bring your own model)** | 通过您自己的 API key 或账号登录，使用 Claude、GPT、Gemini 及其他提供商。 |
| **真正的 Linux shell** | 一个沙盒化的 Alpine Linux 环境在设备本地运行 —— agent 可以安装 package、运行脚本并处理真实文件。 |
| **设备集成** | Health、Calendar、Reminders、Contacts、HomeKit、Bluetooth、Clipboard、Media、Alarms 等系统功能，均作为工具暴露给 agent。 |
| **浏览器自动化** | agent 可以代表您浏览网页并进行交互。 |
| **技能与记忆** | 可扩展的技能，以及跨会话的持久化记忆。 |
| **工作空间** | 将工作组织到独立的上下文中，可通过 `minis://workspace/` 进行访问。 |
| **原生卸载 (Native offloads)** | 将繁重或特定于平台的工作交给原生代码处理，而不是在沙盒中运行。 |
## 您可以用 Minis 做什么
以下是一些用户的实际使用场景：
- **拍摄美食照片，记录营养信息** —— Minis 会识别菜品，估算卡路里和宏量营养素，并将其写入 Apple Health。
- **听着您的时间线摘要醒来** —— Shortcuts 触发 Minis 获取您的 X 时间线，对其进行总结，合成语音，并作为您的闹钟铃声播放。
- **将群聊转化为任务** —— 从 Telegram 群组中提取消息，找出 bug 和待办事项，对它们进行去重，并存入 Apple Reminders。
- **挂载您的 Obsidian vault** —— 将研究、清理并编写好的 Markdown 笔记作为一个普通工作空间写回到该 vault 中。
- **将任何内容分享为日历事件** —— 通过 iOS Share Sheet 将页面或消息发送给 Minis，它会自动创建包含时间和地点的事件。
**→ [OpenMinis/AwesomeMinis](https://github.com/OpenMinis/AwesomeMinis)** —— 一个由社区贡献的精选集合，涵盖了健康、生产力、研究、金融和开发者工具等领域的各种用例与工作流。
## 技能
**技能** 是一个包含 `SKILL.md` 文件的文件夹 —— 其中包含了指令，以及可选的脚本、参考资料和资源 —— 当请求与其匹配时，agent 会按需加载。元数据会保留在上下文中以便触发；而正文和打包的资源仅在技能被实际使用时才会加载。
Minis 拥有专属的工具系统，但它不要求必须为其专门编写技能：**为 Claude、Codex、OpenClaw 或 Hermes Agent 构建的技能通常可以直接在 Minis 中原生运行。** 经过适配以使用 Minis 工具的技能会运行得更好 —— 它们可以直接调用 Linux shell、设备集成和原生卸载（native offloads）。
**→ [OpenMinis/MinisSkills](https://github.com/OpenMinis/MinisSkills)** —— 包含为 Minis 适配以及从头为其量身定制的技能集合，涵盖了 TTS、搜索、媒体下载、健康分析、云 API 等更多领域。
## 媒体报道
## Beta 计划
App Store 的发布可能会存在滞后：每次更新都需要等待审核，且在稳定性需要考量时，我们会暂缓发布构建版本。TestFlight 构建版本是修复补丁和新功能最先落地的地方。
**→ [加入 TestFlight beta](https://testflight.apple.com/join/3BdkA5c3)**
在 Android 平台上，[发布页面](https://github.com/OpenMinis/OpenMinis/releases)
始终提供最新的 APK。
## 从源码构建
Minis 在应用内内置了一个 Linux 沙盒，因此其原生依赖项（iOS 上的 iSH、Android 上的 PRoot、FFmpeg、LAME）以及 Alpine rootfs 都是**从源码构建**的，而不是以二进制文件的形式提交。
**→ 完整的首次构建指南请参见 [BUILDING.md](BUILDING.md)。**
简短版本如下：
```
git clone --recurse-submodules https://github.com/OpenMinis/OpenMinis.git
cd OpenMinis
# iOS — 顺序很重要：FFmpeg 链接 LAME
./deps/build_lame.sh && ./deps/build_ffmpeg.sh
./deps/build_ish.sh && ./deps/prepare_alpine_rootfs.sh
open src/ios/Minis.xcodeproj
# Android — 需要 NDK r28+
./deps/build_proot.sh && ./scripts/prepare_android_sandbox.sh
cd src/android && ./gradlew :app:assembleDebug
```
`BUILDING.md` 包含了各平台的工具链要求、构建时的自定义模板，以及针对您最可能遇到的失败场景的故障排除章节。
## 仓库结构
```
src/ios/ iOS app (Swift / SwiftUI) + share, widget and file-provider extensions
src/android/ Android app (Kotlin / Compose) + JNI native code
src/shared/ Assets shared by both platforms
deps/ Native dependency build scripts and vendored sources
docs/specs/ Architecture and interface specifications
scripts/ Rootfs preparation and developer tooling
```
## 许可证
OpenMinis 采用 **[GNU General Public License v3.0](LICENSE)** 授权。
该应用链接了基于 GPL 许可的组件 —— [iSH](https://github.com/OpenMinis/ish-arm64)
(GPLv3) 和 [PRoot](https://github.com/OpenMinis/proot) (GPLv2) —— 因此组合后的作品根据 GPLv3 进行分发。内置的第三方许可证列表请参见
[THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md)。
## 社区
- **Telegram**：[加入群组](https://t.me/+2NzhOJuzRyI1YmM1)
- **Issues**：通过
[GitHub Issues](https://github.com/OpenMinis/OpenMinis/issues) 提交 Bug 报告、功能请求并进行讨论
本仓库是私有开发树的镜像，因此它**不接受 pull request** —— 因为它们没有可以合并的地方。Issues 是塑造这款产品的方式，并且 [AwesomeMinis](https://github.com/OpenMinis/AwesomeMinis)
和 [MinisSkills](https://github.com/OpenMinis/MinisSkills) 都接受社区贡献。详情请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。标签：Android, DLL 劫持, DSL, iOS, 大语言模型, 浏览器自动化, 移动应用