English · 中文

Minis Ultra

Android arm64 上的私人 AI Agent。把兼容接口接到手机里的一台 Ubuntu 24.04：能装包、跑脚本、用浏览器、技能和记忆，也能派出子代理。

包名 com.openminis.linux，启动器名称 Minis Ultra。可与上游 OpenMinis（GPL-3.0）并排安装。检查更新只指向本仓库。

本仓库以 GNU GPL v3.0 发布。它包含并修改了 GPLv3 程序，因此衍生作品也必须按 GPLv3 提供对应源码。沙箱链接的 PRoot 为 GPLv2，合并分发时按 GPLv3 处理。第三方组件的名称、版本和许可见 THIRD_PARTY_LICENSES.md。

下载

当前版本见 Releases。安装包名为 minis-ultra-com.openminis.linux.apk。

• 正式版：带版本号的 tag（例如 1.36.36-linux）
• 滚动构建：android-latest（main 每次成功构建覆盖）

侧载前允许「安装未知应用」。debug 签名不能覆盖另一张证书装上的版本，见 docs/SIGNING.md。

能做什么

• 沙箱：Ubuntu 24.04 arm64，跑在 PRoot 里。客户机命令、主机 su、共享存储见 LINUX.md。
• 会话：未分组时一会话一工作区；归入项目后共享工作区、附件和浏览器缓存，日记仍按会话隔离。
• 模型：接兼容接口；缺参数的模型 id 会按目录补全上下文、输出长度和思考档位。
• 多智能体：主会话调度子代理。设置 → 多智能体。
• 技能与记忆：全局技能；本会话日记在 /var/minis/memory，GLOBAL.md 在设置里单独维护。

从源码构建

PRoot 和 Ubuntu rootfs 在构建时生成，不进仓库。需要 NDK r29（29.0.14206865）。完整步骤见 BUILDING.md。

git clone --recurse-submodules https://github.com/tall-1997/OpenMinis-Linux.git
cd OpenMinis-Linux
./deps/build_proot.sh && ./scripts/prepare_android_sandbox.sh
cd src/android && ./gradlew :app:assembleDebug

国内镜像见 docs/android-sdk-mirrors.md。不要用 sdkmanager 的 x86_64 包覆盖客户机里的 aarch64 aapt2。

目录

src/android/    Android 应用（Kotlin / Compose）与 JNI
src/shared/     共享资源
deps/           原生依赖构建脚本
docs/           说明与发行注记
scripts/        rootfs 与开发脚本

引用

• 应用源码与本仓库修改：© 各贡献者，GPL-3.0
• PRoot（GPL-2.0），本仓库子模块 deps/proot 基于 OpenMinis/proot
• talloc（LGPL-3.0-or-later）
• Ubuntu 24.04 arm64 根文件系统：构建时下载，许可随 Canonical / Ubuntu 软件包
• Android SDK / AndroidX、OkHttp、Kotlin 协程等：见 THIRD_PARTY_LICENSES.md

问题与功能请求请提到 Issues。

---

English · 中文

Minis Ultra

A private AI agent for Android arm64. It connects compatible model APIs to an Ubuntu 24.04 guest on the phone: packages, scripts, a browser, skills, memory, and sub-agents.

Package id com.openminis.linux. Launcher name Minis Ultra. It can be installed beside upstream OpenMinis (GPL-3.0). Update checks point only at this repository.

This repository is published under the GNU GPL v3.0. It contains and modifies GPL-3 programs, so derivative works must ship corresponding source under GPL-3. The sandbox links PRoot (GPL-2.0); the combined work is distributed under GPL-3. Names, versions, and licenses of other components are in THIRD_PARTY_LICENSES.md.

Download

Current builds are on Releases. The APK is minis-ultra-com.openminis.linux.apk.

• Versioned tags (for example 1.36.36-linux)
• Rolling build: android-latest (replaced on each successful main build)

Allow unknown-app installs before sideloading. A debug signature cannot replace an install signed with a different certificate. See docs/SIGNING.md.

What it does

• Sandbox: Ubuntu 24.04 arm64 under PRoot. Guest commands, host su, and shared storage are described in LINUX.md.
• Sessions: an ungrouped session has its own workspace; sessions in a project share the workspace, attachments, and browser cache. The diary stays per session.
• Models: compatible endpoints. A model id missing limits is filled from the catalog (context, output, thinking).
• Agents: the main session can dispatch sub-agents. Settings → Agents.
• Skills and memory: global skills; the session diary lives at /var/minis/memory. GLOBAL.md is edited separately in Settings.

Build from source

PRoot and the Ubuntu rootfs are produced at build time and are not stored in git. NDK r29 (29.0.14206865) is required. Full steps are in BUILDING.md.

git clone --recurse-submodules https://github.com/tall-1997/OpenMinis-Linux.git
cd OpenMinis-Linux
./deps/build_proot.sh && ./scripts/prepare_android_sandbox.sh
cd src/android && ./gradlew :app:assembleDebug

Do not replace the guest's aarch64 aapt2 with the sdkmanager x86_64 package. Mirrors: docs/android-sdk-mirrors.md.

Layout

src/android/    Android app (Kotlin / Compose) and JNI
src/shared/     Shared resources
deps/           Native dependency build scripts
docs/           Notes and release notes
scripts/        Rootfs and development scripts

Citations

• Application source and modifications in this repository: © contributors, GPL-3.0
• PRoot (GPL-2.0). The deps/proot submodule tracks OpenMinis/proot
• talloc (LGPL-3.0-or-later)
• Ubuntu 24.04 arm64 rootfs: downloaded at build time; licenses follow Canonical / Ubuntu packages
• Android SDK / AndroidX, OkHttp, Kotlin coroutines, and the rest: THIRD_PARTY_LICENSES.md

File issues and feature requests at Issues.