Project Aquarius · FlowOS Desktop

The OS that listens

A bootable Linux OS where AI is the interface. No icon grid. No file manager. Just tell it what you want and FlowOS handles the rest.

Download ISO View Source
FlowOS Desktop
→ what's using my memory?
  → checking system resources
  Chrome: 1.4GB (38%) firefox: 620MB code: 410MB
  Total: 11.2 / 16.0 GB — want me to clear Chrome's cache?
→ push my project to github
  → git add -A
  → git commit: "update plugin store UI"
  → git push origin main
  Done. 4 files changed, pushed to main.
→
~50MB
Base OS size
<5s
Boot to CLI
9
Built-in plugins
x86-64
Architecture
Why FlowOS

An OS you talk to,
not click through

FlowOS replaces the traditional desktop with an AI that has real system access — it runs commands, manages files, installs packages, and controls your machine through natural conversation.

◈
AI as the shell
Powered by Claude with real tool access. The AI doesn't describe what to do — it does it. Run commands, edit files, install software, check system health.
⊞
Boots from USB
Write the ISO to any USB drive with Etcher. Boot on any x86-64 machine — laptop, desktop, or server. No installation required.
◎
Persistent sessions
Session history is saved across reboots when running from a writable medium. The AI remembers what you were working on.
⎇
Plugin ecosystem
Extend FlowOS with plugins for Git, Docker, SSH, Spotify, browser automation, and your home server. Enable or disable from the built-in store.
◧
GUI plugin store
Launch a browser-based plugin store with flowos --store. Browse, toggle, and manage plugins with a visual interface.
⚡
Alpine base
Built on Alpine Linux for a minimal attack surface and fast boot. The full OS fits in ~50MB compressed. No bloat, no telemetry.
Getting started

Boot in four steps

01 — Download
Get the ISO
Download flowos.iso from the releases page below. Verified SHA-256 checksum included.
02 — Flash
Write to USB
Use Balena Etcher (Mac/Win/Linux) or dd on Linux. Any USB ≥ 1GB works.
03 — Boot
Select USB at startup
Restart your machine, select the USB from your boot menu (usually F12 or Del), and FlowOS boots in under 5 seconds.
04 — Connect
Enter your API key
On first boot you're prompted for your Anthropic API key. Get one free at console.anthropic.com.
Plugin store

9 plugins included

Enable what you need. All plugins are optional and can be toggled anytime from the CLI or the visual store.

⎇ git status · commit · push · log
◫ docker snap
⚡ ssh remote exec · scp
◧ notes save · retrieve · list
◎ weather now · forecast
⊡ clipboard read · write
◉ browser snap: chromium
◈ spotify snap: spotify
⊞ homeserver ssh · docker · deploy
Compatibility

System requirements

Minimum
  • x86-64 CPU
  • 1 GB RAM
  • USB 2.0 port (boot)
  • Internet connection (API calls)
  • Anthropic API key
Recommended
  • 4+ GB RAM
  • USB 3.0 for faster boot
  • UEFI or legacy BIOS (both supported)
  • Ethernet or Wi-Fi
  • 16+ GB USB for persistent storage
Free & open source

Download FlowOS

Build from source or download the latest release.

One-line install — macOS · Linux · Termux · Android
curl -fsSL https://flowos.wiki/install.sh | bash
Or run in the browser: os.relayapp.pro →
⬇ Latest Release Build from source

flowos-desktop · github.com/Mattjhagen/FlowOS-Project-Aquarius

💿
Etcher
Mac · Windows · Linux
etcher.balena.io → 🐧
dd
Linux · macOS
See guide below → 🪟
Rufus
Windows only
rufus.ie →

Runs alongside any existing OS — boots from USB, leaves your hard drive untouched.

Docs at flowos.wiki · Built with Claude

Using dd to flash FlowOS

The command-line method for Linux and macOS. No GUI needed.

⚠️
Double-check your device name
Writing to the wrong disk overwrites your data. Always verify with lsblk (Linux) or diskutil list (Mac) first.
Step 1 — Find your USB drive
# Linux
lsblk
# macOS
diskutil list
Step 2a — Flash on Linux
# Replace sdX with your USB device (e.g. sdb — NOT sdb1)
sudo dd if=flowos.iso of=/dev/sdX bs=4M status=progress && sync
Step 2b — Flash on macOS
# Replace diskN with your disk number (e.g. disk2)
diskutil unmountDisk /dev/diskN
sudo dd if=flowos.iso of=/dev/rdiskN bs=4m

Tip: rdisk (raw disk) is faster than disk on macOS.

Step 3 — Boot from USB
1.Restart and hold the boot menu key (see table below)
2.Select your USB drive
3.GRUB loads → select FlowOS Desktop
4.Enter your Anthropic API key on first boot
5.FlowOS CLI launches ⟁
Common Boot Menu Keys
Dell F12
HP F9 / Esc
Lenovo F12 / F11
ASUS F8 / Esc
Acer F12
MSI F11
Gigabyte F12
Mac Hold ⌥ Option
F
Project Aquarius
flowos.wiki GitHub Releases Get API Key
© 2025 Project Aquarius · MIT License