floe-agent
Floe Agent is an open-source AI agent for iOS, iPadOS and Android.
Automatically checked · GitHub checked 2026-11-14

Overview
Floe Agent
An on-device AI workspace for iOS, iPadOS and Android.
Your models. Your files. Your machines.
Floe Agent is an open-source AI agent for iOS, iPadOS and Android. Work with documents, code and creative projects in one place, with a real Linux environment running on your device. Designed primarily for iPadOS and Apple Pencil, with native iPhone support and Android-specific device workflows.
简体中文 · floe-agent.com · Releases & updates · Documentation · Disclaimer
Install · Features · Demo · Docs · Build · Feedback
See Floe at work
Watch on YouTube · Bilibili 中文版 · Explore the interactive feature tour
Recorded on iOS/iPadOS. Android's workflows and limits are described in its own guide.
Get started
Choose a product in the release centre. It keeps the latest downloads and release notes together, with separate histories for Floe Agent and both Bridge companions.
| Product | Install or explore | What to know |
|---|---|---|
| Floe Agent · iOS / iPadOS | App Store · Apply for TestFlight · GitHub IPA releases | iOS/iPadOS 26+. App Store availability follows your storefront; TestFlight availability follows your test group. GitHub IPAs require your own signing. |
| Floe Agent · Android | Download the Full APK · Setup guide | Android 9+ ARM64, independently distributed. Check the selected release's prerelease status and installation requirements. |
| Floe Bridge · Mac | Companion overview · Downloads | Optional menu-bar companion for Floe running on the same Mac: terminal, files and MCP. |
| Floe iOS Bridge | Companion overview · Install guide · Downloads | Separate iPhone/iPad device-control app. Initial setup needs a computer, signing and developer pairing; main Floe integration is outside its current release. |
App Store, TestFlight and GitHub releases update independently. Use the selected release notes and dated channel status to choose a build; publication on GitHub does not establish availability in an Apple channel.
Self-signing stores: setup and source URL
Use the Self-signing button above, choose Feather or AltStore on the shared page, then follow your signing method.
Or copy the source URL manually:
https://raw.githubusercontent.com/JiangNanGenius/floe-agent/main/feather.json
Your first task: install Floe → configure a model → create a task → open the resulting file. Start with the quickstart, or choose the iOS/iPadOS or Android guide. Basic document and file work can be used without an AI provider; AI actions use the model you configure.
Features
Workflows vary by platform and release. Choose the build described in the linked guide and its release notes.
On-device work, with your own models
Floe's workspaces and persistent Linux environment run on your hardware. Run shell commands, Python, Node, packages and local web services, then keep the files and execution history with the task. The environment image is downloaded separately; packages must support its architecture.
For AI, connect your own cloud provider using an API key (BYOK: bring your own key). Supported iOS/iPadOS devices can also use Apple's system model or downloaded local models in Beta. Android currently uses cloud providers. Device memory, model readiness and the selected release determine which local options are available.
From a task to an editable result
| Workflow | What you can do | Guide |
|---|---|---|
| AI tasks & development | Bring materials, tool actions and output files together; use the terminal, code editor, Git and local previews. | Tasks · Linux & development |
| Notes & Office | Import PDFs and images, annotate with Pencil on iPad, ask about documents, and edit DOCX, XLSX and PPTX. | Notes · Office |
| Drawings & 3D | On iOS/iPadOS, edit 2D drawings and native 3D models, continue with the work assistant, and present or export the result. | 2D drawings · 3D workbench |
| Canvas & media | Organize material on a canvas and work on image, video and audio projects in dedicated editors. | Canvas & media |
| Voice & meetings | Dictate drafts, hold voice conversations, record meetings, transcribe and organize notes with your selected services. | Voice · Meeting workflows |
| Skills & automation | Discover reviewed skills, manage their dependencies and versions, and connect configured MCP and automation services. | Skill Hub on the web · Skills & MCP |
Space and specialist workbenches add workflows for diagrams, music, LaTeX, GIS, electronics, manufacturing and print preparation, depending on the chosen build. Features vary by platform and release. The Android guide covers its phone control, self-ADB, project Linux and external-editor workflows; Android CAD/3D preview is separate from the iOS modeling editor.
Documentation
Start with your platform; use the shared guide for models, tasks and files.
| Looking for | Start here |
|---|---|
| First result | Quickstart · 中文快速开始 |
| iOS / iPadOS | Website guide index · Full manual · Workspace tutorials |
| Android | Website guide index · Android manual · Android 9/10 USB activation |
| Shared workflows | Models, tasks & files |
| Bridge companions | Mac Bridge · iOS Bridge |
| Versions & installation | Release centre · Channel status · Signing & sources |
| Troubleshooting | Common issues · Support |
| Development | Engineering guide · Architecture · Documentation hub |
Models, permissions and privacy
Cloud model requests go directly to the provider you configure; supported local models perform inference on your device. Floe's maintainer does not provide a model API, model hosting or API credits. Credentials use protected device storage; uploads and remote actions follow the permissions you grant. Review AI-generated content before using it.
Disclaimer and usage terms · Security policy
Build from source
For iOS/iPadOS, use macOS, a full Xcode installation and XcodeGen. See the engineering guide for current SDK, dependency and signing requirements; 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
iOS build guide · Android Full APK build guide · Mac Bridge build guide · iOS Bridge build guide
Gitee synchronizes source and release records. See the mirror guide.
Contributing and license
GitHub Issues is the main channel for feature requests and bug reports. Include your version, device and reproduction steps. In-app logs provide optional diagnostic material and are handled as time permits.
Read CONTRIBUTING.md before contributing. Report vulnerabilities privately through SECURITY.md.
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.
