A Linux desktop with an AI that runs on your own computer.
SynapseOS is a free operating system built on Arch Linux. It has its own desktop and apps, and a language model that runs locally, so you can ask for things in plain English without an account, an API key, or anything leaving your computer.
What it’s like to use
Ask the shell in plain English
The shell, synsh, works like any other until you type
something that isn’t a command. Then it asks the model running on
your machine what you meant and shows you the command it came up with.
Nothing runs until you press Enter.
syn find the big files in Downloads
→ du -ah ~/Downloads | sort -rh | head -20
Enter to run · Esc to edit it first
-
An assistant that does things
vibeis a chat window and a terminal command. It opens folders, apps and settings panels, changes settings, reads and edits files, and runs commands, and it asks before it changes anything. It speaks, takes dictation and answers to its name. It uses the local model, or Claude or OpenAI if you give it a key. -
Private from the start
The model sits on your disk and runs through llama.cpp. There’s no SynapseOS account or server, and nothing reports back. The installer suggests Mistral 7B Instruct (about 4.1 GB), and you can say no. Once it’s installed, the AI works with the network unplugged.
-
A desktop of its own
The desktop,
synui, is written for SynapseOS. Windows tile or fill the screen, with blur and shadows; workspaces can be shared across monitors or kept per monitor, and can turn like a cube. HDR displays work. There are fifteen themes, and a CRT filter for anyone who misses old monitors. -
Apps that belong together
Files, software, settings, a text editor, a disk utility, a calendar, a media player, a locked folder and a disk cleaner, all written for SynapseOS. Each has a window and a command-line version, and all of them follow the theme. The terminal,
syntty, is 359 KB and opens in 5.8 ms. -
Your language from the first screen
Choose from fourteen languages in the boot menu and the installer and every app use it from then on: English, German, French, Spanish, Portuguese, Italian, Dutch, Polish, Russian, Japanese, Chinese, Korean, Hindi and Arabic. Arabic reads right to left.
-
Good on a TV
Big screen mode (Super+F10, or the Guide button on a controller) puts your Steam library, Big Picture, a browser, music, and any Plex or Jellyfin server on your network onto the television. A controller drives all of it, and works as a mouse too.
-
Installs beside what you have
The installer can use the whole disk, with full-disk encryption if you want it. On a UEFI machine that already has another system, it can go into the free space beside it and leave that system alone. Four filesystems and three bootloaders to choose from.
-
Security you can see
synguardwatches system calls, scores anything that looks risky, and shows its verdicts on the desktop. It can also block in the kernel. The firewall asks about each new network, and the malware scanner tells you what it found.
The desktop
The settings, wallpaper picker, dock, cursor picker, sound panel and control
panel are all drawn by synui itself. The top bar and the desktop
widgets run on quickshell.
A fresh install starts in the Prism theme: a dark, see-through surface that takes its colour from your wallpaper and passes it on to the bar, the dock, the icons, and any RGB lighting in the machine. Fifteen themes ship, including a light one, and a slider sets how much of the desktop shows through.
Try seven of them on this page:
The top bar takes widgets in
Omarchy’s
shell-plugin format, so a widget written for one works on both. Browse and
install them with synui-plugins browse, a terminal browser, or a
window.
A few keyboard shortcuts
| Keys | What it does |
|---|---|
| Super (tapped alone) | Start menu |
| Super+C | Control panel, with every setting and shortcut |
| Super+/ | Search every shortcut; F2 on a row changes it |
| Super+Return | Terminal |
| Super+Space | Command bar for synsh |
| Super+= | App launcher |
| Super+Backspace | Ask the AI |
| Super+A | Neural activity overlay |
| Super+W | Wallpaper picker (Tab for each monitor) |
| Super+E | Visual effects: CRT, corners, shadow, blur |
| Super+T | Themes, all fifteen |
| Alt+Tab | Every window at once, with the workspaces along the bottom |
| Ctrl+Alt+Delete | Task manager |
| Super+G | Game mode |
| Super+F10 | Big screen mode |
There are about sixty in all. Super+C lists every one that is set, and the README has the full table.
Screenshots
Every window here is part of SynapseOS.
Under the hood
One service, synapd, loads the model once. Everything else asks
it over a local socket: the shell, the desktop assistant, the security
monitor and the network filter. So the model takes up memory once, however
many things are using it.
User
│
▼
synsh ─── natural language / commands ──┐
│ │
▼ │
synapd (local LLM — Mistral 7B) │
│ inference over SYN socket protocol │
├──► synguard security verdicts ─┤
├──► synnet network policy │
└──► synapse_kmod kernel sysfs │
│ ▼
▼ synui (Wayland)
/sys/kernel/synapse/
syscall_log, ai_hints, stats,
status, config, version
Each part has its own folder and PKGBUILD in the source tree.
Twenty-four are also published from their own repositories under
github.com/velle999,
so the desktop, the terminal, the apps and the AI service install on a plain
Arch system too.
| Part | What it does |
|---|---|
synapd | Runs the local model through llama.cpp and answers every other part over a Unix socket. Drops root after it starts. |
synsh | The shell. Use it like any shell, or type what you want in plain English. |
synui | The Wayland compositor, on wlroots 0.20 and scenefx 0.5: tiling and monocle layouts, workspaces per monitor, XWayland, layer-shell, glass, blur and shadows. |
synguard | Security monitor. Sorts system-call events, scores threats and sends its verdicts to the desktop. Can also enforce in the kernel through BPF-LSM. |
synnet | Network policy daemon, using nftables. |
synapse_kmod | Kernel module (DKMS) for system-call monitoring and AI scheduling hints, published under /sys/kernel/synapse/. |
syntty | The default terminal. It draws on the CPU with no GL at all: 359 KB, a window in 5.8 ms, tabs, images and OSC 133 prompt marks. |
synpkg | The package manager: one C program over libalpm for the Arch repositories, the AUR, Flathub, BlackArch and SynapseOS’s own parts, as a command, a terminal browser and a window. |
synstudio | Photo and video editing with one colour engine, so a photo and a video frame graded the same way come out the same. Edits are saved beside the file and the original is never changed. |
synfiles | The file manager: trash, undo, split view, thumbnails, archives and search, as a window, a terminal browser or a command. |
syn-settings | Displays, keyboard and language, date and time, network, Bluetooth, power, kernels, default apps, startup apps and user accounts. Each page shows which file a setting came from. |
syn-edit | The text editor: one modal engine behind a terminal editor, a window, and a scripting mode. |
syn-cal | Calendar for CalDAV, Google Calendar and Microsoft 365, as a window, a terminal view and a command. Appointments are kept as plain .ics files in a folder. |
syn-play | Media player built on mpv: playlists, shuffle, quick open and history. |
syn-vault | A folder with a password. It opens at ~/Vaults/<name>, stays encrypted on disk with gocryptfs, and appears in the file manager’s sidebar. |
syn-clean | Disk cleanup across ten categories, and secure delete for files and folders. Both are in the file manager’s right-click menu too. |
syn-disks | The disk utility: drives, health, mounting, safe removal, formatting and partitioning. It refuses to format a disk the running system is on. |
syn-arcade | The game helper: the MangoHud overlay, controllers outside Steam, SDL mapping overrides, and big screen mode. |
syn-confine | Runs a command inside a Landlock sandbox that everything it starts inherits. |
syn-arsenal | Browse and install about 5,000 BlackArch security tools by category, in a window or a terminal. |
vibe | The desktop assistant, as a chat window and a terminal, on the local model or on Claude or OpenAI with a key. Opens apps, folders and panels, changes settings, reads and edits files, and runs commands inside syn-confine’s sandbox. Asks before it changes anything. |
chibi | A voice companion that also keeps an eye on synguard’s verdicts. |
syn-update | Updates the SynapseOS side of an installed system, rebuilding only the parts that changed. |
Download and install
SynapseOS 1.0.2 is the current release. It rebinds a gaming mouse’s extra buttons per game, opens YouTube and Jellyfin in their television interfaces on the big screen, and fixes multi-monitor and NVIDIA display problems. It’s free, for 64-bit PCs, and the ISO is about 4.7 GiB. The AI model downloads during installation.
-
Download the ISO
Download SynapseOS 1.0.2 Mirror Torrent
One file, and your browser can resume it. The mirror and the torrent are on the Internet Archive.
Or download it in parts from GitHub
The GitHub release has the same image split into three parts, because GitHub limits a file to 2 GiB. Download all the
.part*files and the.sha256into one folder, then join them:Linux / macOS
cat SynapseOS-1.0.2-x86_64.iso.part* > SynapseOS-1.0.2-x86_64.iso sha256sum -c SynapseOS-1.0.2-x86_64.iso.sha256 # shasum -a 256 -c on macOSWindows
In Command Prompt, in the folder you downloaded to:
copy /b SynapseOS-1.0.2-x86_64.iso.part00 + SynapseOS-1.0.2-x86_64.iso.part01 + SynapseOS-1.0.2-x86_64.iso.part02 SynapseOS-1.0.2-x86_64.iso certutil -hashfile SynapseOS-1.0.2-x86_64.iso SHA256Name every part, in order, joined by
+, and keep the/b. Without it,copystops early and leaves a short file that won’t boot, with no error. -
Check that it arrived whole
A download that stopped early can still look like a normal ISO. The checksum tells you it’s complete.
Linux / macOS
curl -O https://dl.soslinux.org/SynapseOS-1.0.2-x86_64.iso.sha256 sha256sum -c SynapseOS-1.0.2-x86_64.iso.sha256 # shasum -a 256 -c on macOSWindows
In PowerShell, in the folder you downloaded to:
(Get-FileHash -Algorithm SHA256 .\SynapseOS-1.0.2-x86_64.iso).Hash -eq ` (((Get-Content .\SynapseOS-1.0.2-x86_64.iso.sha256) -split '\s+')[0]).ToUpper()Truemeans it’s intact. In Command Prompt,certutil -hashfile SynapseOS-1.0.2-x86_64.iso SHA256prints the checksum for you to compare with the.sha256file. -
Check who built it optional
The checksum comes from the same server as the ISO, so it can’t tell you who made the image. The signature can. Its key’s fingerprint is also kept in the source repository, in archiso/release-key.fingerprint, on a different host. Check that what
gpgprints, what’s on this page, and what’s in the repository all match.Linux / macOS
curl -O https://soslinux.org/synapseos-release-key.asc gpg --import synapseos-release-key.asc gpg --verify SynapseOS-1.0.2-x86_64.iso.asc SynapseOS-1.0.2-x86_64.isoA good result says
Good signature from "SynapseOS Release Signing", with this fingerprint:6548 9EF5 C20D 0BD9 4211 472B ED33 6DB7 952B 609Egpgalso says the key is not certified with a trusted signature. That’s normal: you haven’t marked the key as trusted in GnuPG. Matching the fingerprint is the check.Windows
Install Gpg4win and the same three commands work in PowerShell.
Releases from 0.2.9.5 on are signed. Earlier ones, including 0.2.9.4, have no signature to check.
-
Write it to a USB stick
This erases the stick. Copy off anything you want to keep first.
Linux / macOS
sudo dd if=SynapseOS-1.0.2-x86_64.iso of=/dev/sdX bs=4M status=progress oflag=syncFind the stick with
lsblkfirst, and write to the whole disk (/dev/sdb), not a partition on it (/dev/sdb1).Windows
- Rufus: pick the ISO, press START, and choose DD Image mode when it asks.
- balenaEtcher: nothing to set.
- Ventoy:
copy the
.isoonto a stick that already has Ventoy and pick it from Ventoy’s menu. This one doesn’t erase the stick.
-
Start from the stick and install
Restart with the stick plugged in and choose it from the boot menu (usually F12, F11, Esc or Del as the machine starts). Secure Boot needs to be off, or SynapseOS enrolled: see Secure Boot. Then run
syn-installfrom the live desktop.The installation guide walks through every choice the installer offers.
Or try it in a virtual machine first
git clone https://github.com/velle999/SYNAPSE.git && cd SYNAPSE
QEMU_RAM=8G ./archiso/build_scripts/qemu-test.sh
The script finds the newest ISO, uses KVM when it can, boots UEFI through OVMF, and attaches a 20 GB test disk that keeps its contents.
What you need
- Processor: 64-bit (x86_64). The AI runs on the CPU by default.
- Memory: 8 GB or more, because the model stays loaded.
- Disk: about 25 GB, plus room for the model.
- Internet: once, during installation, to download the model.
- Graphics card: optional. NVIDIA through CUDA; AMD and Intel through Vulkan.
- Firmware: UEFI or BIOS. Installing beside another system needs UEFI.
Questions
Does SynapseOS send anything to the cloud?
No. The installer downloads the model once. After that it lives on your disk and runs through llama.cpp on your machine. There’s no API key or account, and the AI works offline.
Is it just Arch with an app on top?
No. The model runs as a system service and the rest of the system uses it: the shell turns your words into commands with it, the desktop talks to it, and the security monitor uses it to sort events. The desktop, the shell, the security monitor, the network daemon and the kernel module are all written for SynapseOS.
Do I need a graphics card?
No. The model runs on the CPU by default, on any 64-bit PC. If you have an NVIDIA, AMD or Intel graphics card, you can install a faster build afterwards.
Is it free and open source?
Yes. SynapseOS’s own code is GPL-2.0-or-later, except the kernel module, which is GPL-2.0-only like the Linux kernel. All of it is on GitHub.
Can I use it every day?
Yes. Its author does, and at 1.0 it’s ready for you to do the same. It’s a rolling release, so it keeps updating after you install it. A virtual machine is still the quickest way to look around first.
How do updates work?
There are two commands, one for each half of the system.
sudo pacman -Syu updates the Arch packages, and
syn-update check and syn-update apply update the
SynapseOS parts. The second also has a window in the start menu.
Merch
There’s a shop because people asked for a mug. Printify prints and ships everything and takes the payment, so this site sells nothing and keeps nothing about you.
-
SynapseOS Logo Ceramic Mug
$12.40
-
Custom UV Acrylic Night Light
from $13.72
-
SynapseOS Purple Logo Vinyl Sticker
from $4.09
-
SynapseOS Glass Mug, 10 oz
$26.10
The store also has a t‑shirt, a hoodie, a trucker hat, kiss‑cut stickers and socks. Visit the store.
Prices are copied from the store and may be out of date; the store’s price is the one that counts. Items with sizes show the lowest price.
Help and source code
The wiki is the manual: installing, updating, every shortcut and setting, and fixes for problems people have already run into. Questions, bug reports and the source code are on GitHub.