登录

floe-agent

JiangNanGeniusMPL-2.0活跃维护

面向 iPad 和 iPhone 的开源端侧 AI 智能体工作台，在设备本地跑 Linux、终端、Python/Node.js、Git 和 3D/CAD 编辑，支持自带密钥接入大模型。

iPad-first, open-source iOS AI Agent with native on-device 3D/CAD editing, iPhone support and Android alpha. On-device Linux, terminal, Python/Node.js, Git and web previews; BYOK AI, Notes, Office, Canvas, voice, Skill Hub and supported local models on iOS. 开源设备端 AI 智能体工作台。

v1.8.6发布于 2026-11-09 06:48 UTC452star +4 / 7 天61fork同步于 2026-11-10 18:00 UTC
端侧智能体iOS 工作台本地推理自带密钥3D/CAD 编辑
对比 GitHub 官网ai-agentai-assistantandroidbyokios

怎么上手

由 README 提炼，执行前请确认
原文 
git clone https://github.com/JiangNanGenius/floe-agent.git
cd floe-agent/FloeAgent
bash scripts/gen_project.sh
open FloeAgent.xcodeproj
硬件要求按 README 说明

iOS/iPadOS 26+ 设备，iPad 优先并原生支持 iPhone；Android 端为 Android 9+ ARM64 alpha。README 未说明具体显存或内存要求，本地模型推理需设备支持。

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

开源的设备端 AI 智能体工作台，在 iPad 和 iPhone 上运行 Linux、代码与本地模型

面向 iPad 和 iPhone 的开源端侧 AI 智能体工作台，在设备本地跑 Linux、终端、Python/Node.js、Git 和 3D/CAD 编辑，支持自带密钥接入大模型。

核心能力

  • 在设备上运行持久化 Linux 环境，支持 shell、Python、Node 和 apt 包
  • 用自带 API Key 接入云端模型，也支持设备端本地模型推理
  • 把任务、工具调用和产出文件放在同一个工作区里继续推进
  • 内置 Notes、Office、Canvas、语音对话和 Skill Hub 等创作与办公能力
  • 提供原生 3D/CAD 编辑，另有 Android 9+ ARM64 alpha 版本

容易踩的坑

从源码构建需要 macOS、完整 Xcode 和 XcodeGen，当前 iOS 27 路径要求 Xcode 27；GitHub/Feather 安装包为未签名 IPA，需自行签名；设备端 Linux 需先下载经过验证的镜像，且安装的包必须匹配该环境架构。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v1.8.6
全部 release
  1. android/v0.1.0-alpha.76Android 0.1.0-alpha.76pre-release2026-11-09 · 2026-11-09 23:46 UTC
    查看更新说明

    Android 0.1.0-alpha.76 (code102)

    Changes / 更新

    • Linux已安装但执行未就绪时，“重新检查”会重新关联现有运行通道并测量状态；保留当前代际的真实启动原因，区分组件不符、连接超时和握手拒绝。不重装环境或删除用户文件。
    • 自动解锁在实际默认屏幕点亮、系统窗口就绪后才执行一次揭示手势；等待超时不再视为就绪。保留单次凭据输入、取消／接管和真实锁屏结果。
    • Rebind and remeasure existing Linux execution lanes on an installed-state recheck; preserve current-generation startup causes and distinguish component mismatch, timeout and refused handshake without reinstalling Linux or deleting user files.
    • Require observed default-display and trusted native-window readiness before the single keyguard reveal. A timeout never qualifies readiness; credential attempts and lifecycle fences remain bounded.

    Known issues / 已知问题

    • 中间版本。三星本版自动解锁到达凭据界面后未完成系统确认，计算和自动重锁未通过；部分后台接续及图形组合仍需验收，原失败保留。
    • 索尼XZ／Android9下载解压后的启动原因尚未确认；本版已补重检和诊断，不宣称索尼恢复，也不要求先刷机。
    • 全新环境下载计量、其余N03／N05及全局UI精修继续，N01–N08未完成。
    • Intermediate build: the fresh Samsung76 unlock reached the credential surface but did not complete native confirmation; calculator and automatic relock did not pass. Some background/graphical combinations remain unverified, with original failures retained.
    • Sony XZ/Android9 startup after extraction is not yet confirmed fixed. This version adds recheck and diagnostics; an OS flash is not the prescribed first step.
    • Fresh environment-download metering and remaining N03/N05/UI acceptance stay open; N01–N08 is active.

    Assets / 附件

    One ARM64 Full APK, matching optional Office/CAD components, verified75→76 delta, checksums and corresponding source. iOS Latest is preserved.

    Validation: 93 fresh wake/display and graphics cases plus 59 source-identical recovery cases; actual Full/Play compilation, native34 identity reuse, 58 package bindings, API28/29 signatures and exact75→76 host reconstruction passed. Device acceptance is separate.

    Source: 806ef4a1f3aa83363503eb2cb4afd6f87be29a8e

    Samsung post-publication result / 发布后三星结果

    The real public75→76 delta update passed through normal app/runtime system confirmations and Play Protect. Installed main/runtime102 bytes match this release and original UIDs are retained. The original five visible tasks and two projects remain. A fresh manual terminal executed a command, returned actual ARM64 output and retained the same buffer when reopened; its temporary tab/task was removed afterward. No cloud model was called for this regression.

    三星已完成公开75→76真实增量更新，主程序／运行组件字节和原UID核对通过；原5条任务、2个项目可见。新建任务的实际终端命令与重开通过，自有标签和任务已清。此结果不替代索尼、全新下载或自动解锁的实机验收。

    This appendix changes release text only. The original qualification record, immutable source tag and all seven assets are retained.

    Fresh76 lock-screen result / 新版锁屏实测

    A new Ark Plan/ark-code-latest task completed its Linux command. The native driver observed late display readiness and the credential surface, accepted one text-entry request, then returned manual handling because native confirmation was unavailable. Accepted input is not proof of credential delivery or unlock. No calculator result or automatic relock passed; no credential retry occurred. All47 original records and the pre-cleanup native trace are retained. Later capability cancellation during teardown is separate from the original native failure.

    新的三星76用例已执行Linux命令；自动解锁到达凭据界面，系统接受一次填写请求，但未完成确认，计算和自动重锁未通过。没有重复输入。47条原始记录和清理前故障保留，自己的任务、导出、临时凭据与授权已清。后续代码修复与本版不可变安装包分别记录。

  2. android/v0.1.0-alpha.75Android 0.1.0-alpha.75pre-release2026-11-09 · 2026-11-09 22:20 UTC
    查看更新说明

    Android 0.1.0-alpha.75 (code101)

    Changes / 更新

    • 自动解锁补充受信任系统窗口查找和输入前复核，记录不含凭据的就绪阶段；保留单次输入、真实锁屏结果与人工处理。
    • 图形查看器断开后确认原项目图形进程是否存活；明确重开时复用原连接，不创建新环境或失败重连循环。模型继续优先命令行。
    • Resolve a fresh trusted native credential surface before the single input attempt, with credential-free readiness diagnostics and preserved manual fallback.
    • Keep a project graphical context only while its real launcher/display children survive, and reattach on an explicit reopen without environment duplication or reconnect loops. Agent execution remains CLI-first.

    Known issues / 已知问题

    • 三星真实74→75增量重建、主程序／运行组件确认及PlayProtect安装通过；实际main/runtime101字节和原UID匹配，5条原任务与2个原项目保持可见。上一轮73→74完整包在线升级已实测。
    • 自动解锁仍未通过：可信系统窗口已被观察，唤醒和滑动完成后未出现可输入凭据界面，转入人工处理；未输入密码，未完成计算或自动重锁。原故障保留，实际醒屏就绪判断继续修复。
    • 索尼XZ／Android9具体启动原因未确认；已安装重检空操作和拒绝原因覆盖的后续源码修复已通过59项相关检查及Full／Play编译，尚未包含在本版。新下载计量、其余N03／N05组合与全局UI精修继续。
    • Samsung passed real74→75 delta reconstruction and normal main/runtime101 installation with Play Protect, exact installed bytes, original UIDs and visible baseline tasks/projects. Full73→74 OTA was tested separately.
    • Automatic unlock is still not passed: trusted SystemUI was observed, but no usable credential surface appeared after wake/reveal. No credential input, calculator or automatic relock completed; the original failure is retained.
    • Sony startup and remaining N01–N08 work stay open. Subsequent installed-state recovery/diagnostic source fixes pass59 focused cases and Full/Play compilation but are not in this build.

    Assets / 附件

    One ARM64 Full APK, matching optional Office/CAD components, verified74→75 delta, checksums and corresponding source. iOS Latest is preserved.

    Validation: 67 fresh focused phone cases plus 10 unchanged graphics/protocol cases reused by exact input identity, actual Full/Play compilation, native34 reuse by exact input identity, 58 package bindings, API28/29 APK signature checks and exact74→75 host reconstruction passed. These are distinct from device acceptance.

    Source: 54435f1744e8c61766e6c7d5d2b7062863556cc0

  3. android/v0.1.0-alpha.74Android 0.1.0-alpha.74pre-release2026-11-09 · 2026-11-09 20:27 UTC
    查看更新说明

    Android 0.1.0-alpha.74 (code100)

    Changes / 更新

    • 自动解锁等待真实手势与锁屏状态，补任务所属亮屏锁的持有、续期与释放；仅记录固定诊断阶段，不记录凭据。
    • 回答或恢复任务后自动刷新等待状态，避免已完成仍显示“等待你处理”。
    • Observe real keyguard/gesture completion and retain a bounded task-owned wake lease with lifecycle cleanup and credential-free stage diagnostics.
    • Refresh canonical waiting state after question and run transitions.

    Known issues / 已知问题

    • 三星已完成公开73→74完整包在线升级，原任务／项目保留；同一任务回答后等待提示自动清除，Linux命令有真实退出回执。
    • 自动解锁仍未通过：独立锁屏任务能唤醒并完成揭示手势，但没有观察到可输入的系统凭据界面，转入人工解锁；没有完成计算或自动重锁。原故障保留，后续修复继续验证。
    • 索尼XZ／Android9解压后启动原因未定位；全新下载计量、其余N03／N05组合和全局UI精修仍在推进。后续图形会话修复尚未包含在本版。
    • Samsung passed public73→74 full-package OTA with original tasks/projects retained, automatic wait-banner clearing after an answer, and a real Linux command exit receipt.
    • Automatic unlock is not passed: a fresh locked task woke the device and completed the reveal gesture, but did not observe a usable native credential surface and required manual unlock. Calculator and automatic relock were not reached; the original failure is retained.
    • Sony XZ/Android9 post-extraction startup, fresh-download metering, remaining N03/N05 combinations and global UI polish remain open. Subsequent graphics-session source fixes are not included in this build.

    Assets / 附件

    One ARM64 Full APK, matching optional Office/CAD components, verified73→74 delta, checksums and corresponding source. iOS Latest is preserved.

    Validation: 44 focused phone lifecycle/ancestor/wake cases, actual Full/Play compilation, native34 reuse by exact input identity, 58 package bindings, API28/29 APK signature checks and exact73→74 host reconstruction passed. These are distinct from device acceptance.

    Source: 322f6e3cefb3039922f821acd58ade79edfe96b1

  4. android/v0.1.0-alpha.73Android 0.1.0-alpha.73pre-release2026-11-09 · 2026-11-09 18:33 UTC
    查看更新说明

    Android 0.1.0-alpha.73 (code99)

    Changes / 更新

    • 明确手机动作所需的观察凭据，缺失时返回可识别错误；返回 App 时刷新新装应用，并统一已知密码填写文案。
    • Clarify required phone-action observations and missing-token errors; refresh installed apps on resume and align known-password guidance.

    Validation / 已验证

    • 三星公开72→73完整包在线升级通过，主程序／运行环境99的实际字节和原UID匹配，原5条任务／2个项目保留。同进程新装应用刷新、本地受保护输入框填写校验通过。
    • 新的三星指南用例在结束并重开App进程后，恢复同一运行的原提问；回答后读回原A快照和不同的当前B摘要。6次工具调用全部成功，无重复创建／更新／提问。测试任务和设备导出已清理；指南按现有机制可恢复移除。
    • Samsung explicit full-package OTA, exact installed main/runtime99 bytes, original UIDs/data, same-process app refresh and a local protected-input fixture passed. A fresh guide case recovered the original question after actual App process death, then read the pinned A snapshot with a different current B digest: six successful tools, one original run, no duplicate create/update/question.
    • 27项相关App检查、Full／Play编译、精确输入复用native34、58项封装、API28／29签名和72→73宿主重建通过；这不等同索尼实机或所有账号验收。

    Known issues / 已知问题

    • 中间测试版本。索尼XZ／Android9解压后的具体启动根因仍未确认；新下载计量、自动解锁／重锁和部分后台／项目图形边界仍待闭合。三星自动解锁用例已停在手动处理等待，不记为通过。
    • 提问已回答、运行已结束时，界面可能仍显示“等待你处理”；打开该入口后点“刷新”可读取最新状态。自动刷新的后续源码尚未进入本包。
    • 密码框验证使用公开合成输入，并明确提示观察参数；未扩展为真实账号或任意自然提示可靠性验收。工具输入记录脱敏，用户文本／模型总结可能包含用户提供的测试文本。
    • Intermediate build: Sony XZ/Android9 startup, fresh-download metering, automatic unlock/relock and some background/project-display edges remain open. The Samsung automatic-unlock case reached manual fallback and is not a pass.
    • A completed/answered task may retain the cached waiting banner; open it and Refresh to read current state. The automatic-refresh source fix is not in this APK. Protected-input testing used public synthetic text with explicit observation guidance; real-account and arbitrary-prompt reliability remain unqualified.

    Assets / 附件

    One ARM64 Full APK, matching optional Office/CAD components, verified72→73 delta, checksums and corresponding source. iOS Latest is preserved.

    Source: b0722808df5e006b5f035d4a2f43e2a8c1f3490e

  5. v1.8.6Floe Agent 1.8.6 (build 326)最新正式版2026-11-09 · 2026-11-09 06:48 UTC

    Floe 1.8.6 (326)

    简体中文

    • 空间接入更多原生工作台，包括原理图与 PCB、LaTeX、生物学及 CAD 工程分析；完善从编辑、预览到保存和再次打开的操作。
    • PCB 支持直接在画布中编辑、检查设计规则及原理图与 PCB 同步；新增从 PCB 更新原理图的差异预览与确认。
    • LaTeX 增加源码折叠和 PDF 全文搜索，优化源码、项目面板和预览的布局，保留切换全屏后的阅读与搜索状态。
    • 增强音乐编辑与预制音色，完善原生科学计算、CSV 处理和正文内图表等内容的工具调用；修复部分编辑参数与工具结果格式问题。
    • 改善 iPhone 顶部导航与任务中心布局、文件预览与批量管理、连接工具历史及蓝牙串口的自动发现与错误反馈。
    • 完善 Linux 软件源与依赖安装路径，升级时按已有运行环境识别原镜像，避免误用新的默认镜像。

    本版用于内部及公开 TestFlight 测试。请重点检查新工作台入口、触屏与鼠标编辑、预览、保存重开、助手调用及之前报告的界面问题。部分高级 PCB 编辑和仿真分析仍在完善，原生 USB 串口驱动未包含。正式 App Store 提交及发布设置保持不变。

    English

    • Adds more native workbenches in Space, including schematic and PCB editing, LaTeX, biology and CAD engineering analysis, with improved editing, previews, saving and reopening.
    • PCB editing uses the canvas, design-rule checks and schematic/PCB synchronization. Updating a schematic from its PCB now includes a change preview and confirmation.
    • Adds LaTeX source folding and PDF full-text search. Refines the source, project-panel and preview layouts, and preserves reading and search state across full-screen changes.
    • Enhances music editing and preset sounds, native scientific tools, CSV workflows and inline content such as charts. Fixes several editor-argument and structured-result issues.
    • Improves iPhone navigation and task-center layout, file previews and batch management, connection-tool history, and Bluetooth serial discovery and feedback.
    • Improves Linux package sources and dependency installation. Existing runtimes retain their original image selection when a new default image becomes available.

    This build is for internal and public TestFlight testing. Focus on workbench entry points, touch and mouse editing, previews, saving and reopening, assistant actions, and previously reported UI issues. Some advanced PCB and simulation capabilities remain in development. Native USB serial drivers are not included. The existing App Store submission and release settings are unchanged.

    [!WARNING] GitHub IPA 未签名，不能直接安装，也不是 App Store 上传包。 The GitHub IPA is unsigned, cannot be installed directly, and is not the App Store upload package.

    本次安装包由精确的本地设备构建打包并经工作流签名证明；私有符号与传输归档不会公开。 This installable was packaged from the exact local device build and attested by the workflow; private symbols and the transport archive are never public.

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    Release iOS 26+ Android 9+ ARM64 alpha MPL 2.0

    Install · Features · Demo · Docs · Develop · Contribute

    Get started

    From installation to your first result · Full manual

    Choose an installation channel on the website. Explore the iOS AI Agent workspace for iPad and iPhone. Check current status and the installation page for each channel’s version, region and eligibility.

    https://raw.githubusercontent.com/JiangNanGenius/floe-agent/main/feather.json
    ChannelBefore you install
    iOS / iPadOS · App StoreGet the official release on the App Store. Install and update through the store; requires iOS / iPadOS 26+. Availability and versions follow your storefront.
    iOS / iPadOS · TestFlightApply for beta access on the website. Available builds and eligibility appear in TestFlight.
    iOS / iPadOS · Feather / AltStoreInstall the corresponding app, use a button above to add the source, then sign with your own setup.
    iOS / iPadOS · GitHub IPADownload the IPA and checksum from Releases. The IPA is unsigned and requires your own signing.
    Android alphaAndroid 9+ ARM64. BYOK cloud AI, Notes and Office, on-device Linux/IDE/project desktops, network tools and Android app workflows. Check the selected release notes for compatibility and actual save behavior. No local-model inference or assumed iOS editor parity.

    For your first iOS / iPadOS task: install → connect a model → create a task → open the result. Core Notes, file organization and Canvas work without an AI provider; AI features use your configured provider or a local model supported by your device. On Android: install → add your cloud provider key → start chatting; Basic Notes editing works without a provider; AI actions use your cloud configuration. Office files, the file workspace, the Linux terminal, the code IDE and the network workbench are already in the alpha.

    Installation steps · Model setup · Sources and signing

    The iOS setup guide offers four recommendations to prefill choices for models, search, voice and workspaces, while keeping every section editable. Continue setup while voice packs, models or environments download, then check progress later. Apple Intelligence is off by default for new users.

    Features

    Stable and newer-feature builds. The current App Store release is 1.7.74; the latest GitHub/Feather installer is 1.8.5 (325) and requires your own signing. Follow the Space and specialist workspaces guide and its version notes when choosing a channel. Features still in development are marked separately; TestFlight access and versions follow your actual test group.

    The features below describe Floe core workflows. Availability varies by platform and release; see the installation notes above and the Android release for the current Android alpha.

    WorkflowWhat you can doGuide
    AI tasksContinue a task with your material, tool actions and resulting files together.Tasks & workspaces
    On-device LinuxRun agent code in a persistent, task-owned Linux environment on your device: shell, Python, Node and apt packages, background jobs and local web previews. Requires the verified image download; packages must support the environment's architecture.Local terminal & Linux
    On-device AIRun inference on your device with supported local models — the system model or downloaded models (Beta). Availability depends on your device and model status; local models share memory with Linux.Model setup
    NotesImport PDFs and images, search, annotate with Pencil and ask about documents.Notes
    OfficeCreate, edit and save DOCX, XLSX and PPTX. Check saved results with complex layouts.Documents, sheets & slides
    Canvas & mediaOrganize material on a canvas and use focused image, video and audio workbenches.Canvas & media
    Drawings & 3DOn iOS/iPadOS, edit 2D drawings and create native 3D models in one workbench — keep refining them with the assistant, apply materials and present or export the result. Operations vary by format.Native 3D editor · 2D drawings
    Code & remoteEdit code, track Git changes and work with authorized remote hosts.Terminal & ports · Remote connections
    VoiceDictate editable drafts, hold voice conversations and have final answers read aloud with system, enhanced on-device or configured online voices. Android includes system/configured cloud voice paths; provider and device behavior remains under validation, and Android has no App-managed local voice model.Voice input & read-aloud
    Skills & Skill HubInstall reviewed skills with declared dependencies and version management, keep them updated, and automate with MCP services and mail actions. Android includes the signed Hub client; compatible package supply and task Linux dependencies remain independently checked.Skills, MCP & automation
    Space & specialist workspacesReach diagrams, mixed canvases, meetings, music, machining and print preparation through Space, Notes and Creative mode. Follow the relevant build requirements.Workspace tutorials
    In developmentLaTeX, GIS, font and electronics workspaces are being developed; see the availability guide before choosing a build.Workflows and availability

    Cloud model requests go directly to your chosen provider; supported local models run inference on the device. Credentials stay in protected storage on your device. Files, uploads and remote actions follow task permissions, with consequential actions confirmed under the current policy. See security.

    See Floe at work

    Recorded on iOS; the Android alpha already includes chat, Office, files, terminal, IDE and network-diagnostic workflows and keeps growing.

    Watch Floe: tasks, Office, code, Notes and Canvas

    Watch on YouTube · Bilibili 中文版 · Explore features on the website

    Documentation

    Looking forStart here
    How to use FloeIllustrated user manual · 中文手册
    A topicDocumentation hub
    Installation & versionsChannel status · Sources · Release records
    Help & feedbackTroubleshooting · Support
    Development & integrationEngineering guide · Architecture · Versioned format reference

    Build from source

    Use macOS, a full Xcode installation, Swift and XcodeGen. The current iOS 27 path requires Xcode 27; iOS/iPadOS 26 remains a compatibility target.

    git clone https://github.com/JiangNanGenius/floe-agent.git
cd floe-agent/FloeAgent
bash scripts/gen_project.sh
open FloeAgent.xcodeproj

    See the engineering guide for dependencies, build parameters and focused tests. For the Android app, see FloeAndroid/README.md. Gitee synchronizes source and release records; see the sync guide.

    Contributing and license

    Read contributing before reporting an issue or working on the project. Use support for general questions and report vulnerabilities privately through security.

    Original Floe code is licensed under MPL 2.0. Third-party components retain their own licenses and notices, available in the app under Settings → Diagnostics & About → Third-Party Licenses.

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    mediapipe
    google-ai-edge·C++

    跨平台机器学习框架，提供可定制的视觉、音频等实时流媒体处理方案，方便在移动端和桌面端搭建低延迟推理管线。

    端侧推理+4端侧部署
    37635+466.2kv1.2.22026-11-10 11:41 UTC
    ncnn
    Tencent·C++

    面向手机端的高性能神经网络推理框架，针对 ARM 平台深度优化，让 Caffe、ONNX 等模型能在 Android/iOS 上低延迟运行。

    推理框架+4端侧部署
    24035+54.5k202610202026-11-10 10:48 UTC
    mlc-llm
    mlc-ai·Python

    通用大模型部署引擎，借助机器学习编译技术把 LLM 高效跑在各种硬件上，从手机到服务器都能用。

    推理引擎+4端侧部署
    23319+92.2kv0.1.dev02026-10-30 09:07 UTC
    MNN
    alibaba·C++

    阿里开源的轻量级端侧推理引擎，主打手机和嵌入式设备上的高性能模型推理，能跑大模型和常规深度学习网络。

    推理引擎+4端侧部署
    16484+612.5k3.6.22026-11-10 13:13 UTC