Install any OS on any device. CLI and web UI.

OSmosis gives you real ownership of your hardware. Your device, your choice of operating system. Whether you're installing a privacy OS on a phone, reviving an old tablet, or escaping a locked-down ecosystem — OSmosis handles the flashing, you make the choices.

git clone https://github.com/thdelmas/OSmosis.git ~/OSmosis || true \
  && cd ~/OSmosis \
  && git pull --recurse-submodules \
  && make install \
  && make serve

Plug in your device via USB. OSmosis detects it and walks you through the rest.

Requirements: Python 3.10+, Node.js, a USB data cable. Linux recommended, macOS works, Windows via WSL2. See detailed requirements below.

OSmosis supports phones, tablets, SBCs, scooters, routers, microcontrollers, and more. Here are the most common:

See the full device catalog for 200+ device types including laptops, game consoles, e-readers, cameras, lab equipment, and more.

LETHE is a privacy-first OS that runs on your existing phone — no new hardware needed. It bundles financial protection (PreuJust), health data guardianship (Bios), and an on-device AI companion, all designed to give you back control of your digital life.

Install LETHE with OSmosis:

# 1. Set up OSmosis (quick start above), then:
make serve
# 2. Plug in your phone via USB
# 3. Select "LETHE" from the OS list when prompted

LETHE works on Samsung Galaxy, Google Pixel, OnePlus, Xiaomi, Fairphone, Motorola, Sony, and Nothing phones. See the LETHE documentation for details.

make serve
# Opens http://localhost:5000

The web UI detects your device, shows compatible OS options, and guides you through flashing with real-time progress and physical button instructions.

./osmosis.sh            # interactive menu
./osmosis.sh --dry-run  # preview commands without executing
./osmosis.sh --help     # show help

• Auto-detect connected devices via USB
• Pre-flight checks — battery level, backup status, storage space
• Guided flashing — step-by-step with physical button instructions and countdown timers
• Backup & restore — partition backups before flashing
• ROM downloads — built-in firmware registry with SHA256 verification
• Scooter support — BLE scan, firmware flash, ST-Link recovery
• OS Builder — build custom Debian, Arch, Fedora, NixOS, or Alpine images
• IPFS distribution — decentralized firmware hosting and pinning

# Core
sudo apt install -y heimdall-flash adb unzip wget

# Optional
sudo apt install -y lz4 curl python3 python3-venv

# Scooter flashing (BLE)
pip install --user bleak

# Scooter flashing (ST-Link)
sudo apt install -y stlink-tools

OSmosis is free, open source, and not monetized. If it's useful to you, consider supporting the work:

• 💛 theophile.world/sponsor — tip jar or recurring support.
• ⭐ Star the repo and share it with someone who'd benefit.
• 🐛 Open an issue or join the Discord.

OSmosis wraps and integrates upstream tools — the real work happens in the communities we depend on. See CREDITS.md for the full list, including:

• Heimdall, fastboot/adb, Magisk
• LineageOS, GrapheneOS, CalyxOS, /e/OS, PostmarketOS
• ScooterHacking community
• Flask, Vue 3, Vite

Read the Manifesto — the principles behind OSmosis — and the Design doc for how it's put together.

We support Windows only so you can escape from it.