JiangNanGenius / floe-agent

Floe Agent 
 Your models. Your files. Your machines. 
 Floe Agent is an open-source on-device AI agent workspace designed for iOS and Android — iPad-first, with native iPhone support. Bring AI tasks, Notes, Office documents, creative tools and development 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. Check current status and the installation page for each channel’s version, region and eligibility.
 Download releases 
 Copy the source URL manually 
 [code] 
| Channel | Before you install |
| --- | --- |
| iOS / iPadOS · TestFlight | Requires valid beta access. Available builds and expiry appear in TestFlight. |
| iOS / iPadOS · Feather / AltStore | Install the corresponding app, use a button above to add the source, then sign with your own setup. |
| iOS / iPadOS · GitHub IPA | Download the IPA and checksum from Releases. The IPA is unsigned and requires your own signing. |
| Android alpha | Android 9+ (ARM64). Download the signed APK and checksum from the Android release and install it manually; updates are manual for now. The current alpha supports basic cloud chat with your own provider key (BYOK), plus configuration and history restore; no local model is included. The on-device environment and local AI are coming to Android, which will grow toward iOS capabilities over time alongside Android-specific features. |
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**.
Installation steps · Model setup · Sources and signing
## 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.
| Workflow | What you can do | Guide |
| --- | --- | --- |
| AI tasks | Continue a task with your material, tool actions and resulting files together. | Tasks & workspaces |
| On-device Linux | Run 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 AI | Run 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 |
| Notes | Import PDFs and images, search, annotate with Pencil and ask about docume