Floe Agent

Floe Agent

Your models. Your files. Your machines.

Floe Agent is an open-source on-device AI agent workspace for iOS and Android — iPad-first, with native iPhone support and a separate Android alpha. Bring AI tasks, Notes, Office documents, creative tools, development, voice conversations and skills together — with a real Linux environment on your device that runs code, packages and services, supported local models for on-device inference, and cloud AI using your own API keys (BYOK).

简体中文 · Website · Apply for iOS beta · User manual · Documentation · Disclaimer

Install · Features · Demo · Docs · Develop · Contribute

Get started

From installation to your first result · Full manual

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.

Download releases  ·  Apply for TestFlight on the website

https://raw.githubusercontent.com/JiangNanGenius/floe-agent/main/feather.json

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

iOS 1.8.2 (322) integrates this round of predevelopment work and is available through internal TestFlight. Apple processing is valid, the build is unexpired, and Floe QA availability is verified. See the integration record and build notes. Interface acceptance covers menus, pages opening, controls and the agreed layouts; comprehensive functional and stability qualification was not repeated.

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.

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 on YouTube · Bilibili 中文版 · Explore features on the website

Documentation

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.