Floe Agent

Your models. Your files. Your machines.

Floe Agent is an open-source, iPad-first iOS AI Agent optimized for iOS and iPadOS, 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 · User manual · Documentation

Install · Features · Demo · Docs · Develop · Contribute

Get started

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

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

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.