Your laptop.
Your agents.
One keystroke away.
Flash a USB. Boot. In fifteen minutes, Claude Code and a local LLM are one keystroke away. On your MacBook. Your ThinkPad. Whatever's on your desk.
v0.11 · 246 packages · 4.2 GB ISO · x86_64
vinOS is Arch Linux, refined. Every driver you need. Every config you'd tune yourself. AI wired in from the first boot. Secure by design — your password, your files, your prompts, all yours. Ready the moment you press power.
A thin layer on stock Arch.
vinOS is not a fork. It's a set of idempotent scripts and opinionated configs on top of upstream Arch. Nothing hidden. Nothing patched. You can leave any time.
┌─────────────────────────────────────────────────────────────┐ │ your desktop │ │ hyprland · waybar · walker · foot · mako · greetd │ ├─────────────────────────────────────────────────────────────┤ │ vinos overlay # 246 pkgs · 88 vinos-* bins │ │ install/ themes/ bin/vinos-* configs/*.conf │ │ ai · dev · media · office · gaming · comms · +2 bundles │ ├─────────────────────────────────────────────────────────────┤ │ stock arch linux # rolling · pacman · systemd │ │ linux 6.x · linux-t2 (Apple T2) · glibc · wayland │ └─────────────────────────────────────────────────────────────┘
Every driver detected. Nothing to configure.
vinos-doctor runs at first login and prints exactly what it did. Read it. Trust it. Or don't — every step is a script you can read in /usr/local/bin.
$ vinos-doctor → checking kernel ok linux 6.11.7-arch1-1 → checking hardware profile ok t2mac (MacBookPro16,1) → checking iwd ok connected ssid=home -47dBm → checking hyprland session ok 0.55.0 vrr=off hdr=off → checking greetd ok tuigreet autologin=off → checking audio ok pipewire 1.4.9 wireplumber ok → checking t2 firmware ok apple-bcm-firmware 0.1-4 → checking touchbar ok tiny-dfr running → checking gpu ok AMD Radeon Pro 5300M amdgpu → checking ollama -- not installed (run: vinos-install-ai) → checking claude-code -- not installed (run: vinos-install-ai) → checking updates ok system up-to-date all good. 12 checks · 0 errors · 2 optional $ vinos-install ai :: bundle ai — installs ollama + claude-code + open-webui :: 4 packages · ~ 380 MB :: proceed? [Y/n]
Real output. Not a mockup for the website — this is what runs on your first boot. Every check maps to a shell function in /usr/local/bin/vinos-doctor.
From USB to a working AI desktop.
Super+A. Your assistant, anywhere.
Free forever. Local by default. Yours.
Three steps.
Flash to USB
Use Etcher, Rufus, or dd. Any 8 GB+ USB stick works.
Boot and install
Boot from USB. When the desktop loads, run:
That's it. vinOS detects your hardware, picks the right drivers, and sets everything up. Reboot into a clean desktop. Your AI tools are already there.
The spec sheet.
Everything below is in the base ISO. No downloads. No wizards. No "click here to enable optional feature."
- kernel
- linux · linux-t2
- init
- systemd
- display
- wayland · hyprland 0.55+
- login
- greetd · tuigreet
- wifi
- iwd · impala
- audio
- pipewire · wireplumber
- shell
- bash · fish (opt)
- updates
- rolling · pacman
- bar
- waybar
- launcher
- walker
- terminal
- foot
- notifications
- mako
- idle
- hypridle
- lock
- hyprlock
- picker
- hyprpicker
- screenshots
- satty · grim · slurp
- osd
- swayosd
- night-light
- hyprsunset
- vinos-doctor
- hardware + config check
- vinos-menu
- gum-based hub · Super+Ctrl+O
- vinos-install-disk
- installer TUI
- vinos-install-<bundle>
- opt-in package sets
- vinos-theme
- live theme switch
- vinos-launch-wifi
- impala in floating foot
- vinos-welcome
- first-boot walkthrough
- vinos-update
- pacman + AUR + firmware
- generic
- any x86_64 UEFI laptop
- nvidia
- nvidia-open-dkms + KMS drop-ins
- t2mac
- linux-t2 · apple-bcm-firmware · tiny-dfr
- tokyo-night
- default
- catppuccin-mocha
- warm mauve
- rose-pine
- soft pastel
- everforest
- green forest
- gruvbox-dark
- retro amber
- builder
- archiso
- boot
- UEFI · limine
- live user
- vin / (no password)
- offline install
- yes — no network required
- persistence
- optional overlay partition
- splash
- plymouth
How it stacks up.
Same kernel. Same repos. The difference is what's already done when you log in.
| vinOS | Arch (stock) | DIY Hyprland | |
|---|---|---|---|
| Live installer ISO | yes | yes | no |
| Hyprland pre-configured | yes | no | bring your own |
| T2 / NVIDIA / ThinkPad drivers | baked in | manual | manual |
| AI stack (Ollama + Claude Code) | one command | no | no |
| First-boot user creation | TUI installer | archinstall | manual |
| Live theme switcher | 5 themes · Super+Ctrl+T | no | no |
| Opt-in app bundles | 8 bundles | no | no |
| Wi-Fi TUI (iwd + impala) | wired in | iwd only | DIY |
| Sudo / security defaults | hardened | defaults | defaults |
| Rolling updates | pacman + AUR | pacman | pacman |
| Time to a working desktop | ~15 min | ~45 min | ~1 weekend |
Add only what you use.
The base stays small. When you want a thing, one command installs it. Each bundle is a plain list of packages — no magic.
| bundle | command | what's inside |
|---|---|---|
| ai | vinos-install ai | ollama · claude-code · open-webui · llm |
| dev | vinos-install dev | neovim · lazygit · docker · gh · nodejs · rustup · uv · direnv |
| media | vinos-install media | mpv · imv · yt-dlp · ffmpeg · spotify · pinta |
| office | vinos-install office | libreoffice-fresh · zathura · obsidian · localsend |
| gaming | vinos-install gaming | steam · lutris · gamemode · mangohud · protontricks |
| productivity | vinos-install productivity | obsidian · dbeaver · postman · flameshot · syncthing |
| comms | vinos-install comms | signal-desktop · slack · zoom · discord |
| browser | vinos-install browser | chromium · firefox · brave-bin |
Bundle lists live at /usr/share/vinos/bundles/*.list. Read them. Edit them. Fork them.
Ready when you are.
Every driver. Every config. Every keybinding. All wired up before you press power.
Your AI, two keys away.
Super+A opens a local chat. Super+Shift+A opens Claude Code across your whole project. Fast. Private. Always ready.
Private by design.
Your password, your files, your prompts. No defaults. Nothing listening on the network. Nothing leaves your laptop unless you send it.
It just boots.
T2 MacBook. NVIDIA laptop. ThinkPad. Framework. Dell XPS. Wi-Fi works. Trackpad works. GPU works. That's the whole point.
A desktop that feels finished.
Snappy windows. Smart tiling. Beautiful defaults. Every terminal, notification, and launcher already looks like it belongs.
One key. New look.
Super+Ctrl+T. Tokyo Night, Catppuccin, Rose Pine, Everforest, Gruvbox. Everything retints in half a second. No session restart.
Add only what you use.
Base stays lean. When you want it, one command adds your AI stack, dev tools, creative apps, games, or comms. Nothing you didn't ask for.
Wi-Fi in two keystrokes.
Super+Ctrl+W. Pick a network. Type your password. Done. No settings app. No waiting.
Your hands stay home.
Super+K lists every shortcut. Super+Space launches anything — apps, files, symbols, calc. Once you're here your hands never leave the home row.
New every day.
Security patches arrive the day they're written. No year-old libraries. No LTS backlog. When something new ships, you get it.
Five looks. Swap live.
Pick your palette. Change it whenever you want with Super+Ctrl+T.
Wi-Fi in two keystrokes.
Super+Ctrl+W opens impala — a keyboard-first
TUI on top of iwd. No NetworkManager, no tray icon, no mystery daemons.
The whole cheat sheet.
Every binding is real, wired in the default Hyprland config, and works on first boot. Press Super+K to see it inside the OS.
| chord | action | what runs |
|---|---|---|
| agents | ||
| Super+A | Local AI chat | vinos-ai-chat (Ollama) |
| Super+Shift+A | Claude Code in project | claude |
| launch | ||
| Super+Space | App / file / calc launcher | walker |
| Super+Return | Terminal | foot |
| Super+B | Browser | xdg-open |
| Super+E | File manager | nautilus |
| vinos | ||
| Super+Ctrl+O | vinOS menu (hub) | vinos-menu |
| Super+Ctrl+W | Wi-Fi picker | vinos-launch-wifi |
| Super+Ctrl+T | Live theme switch | vinos-theme |
| Super+Ctrl+L | Lock screen | hyprlock |
| screen | ||
| Super+Shift+3 | Screenshot region | grim | satty |
| Super+Shift+4 | Screenshot full | grim |
| Super+P | Color picker | hyprpicker |
| windows | ||
| Super+H / J / K / L | Move focus (vim keys) | hyprland |
| Super+1…9 | Switch workspace | hyprland |
| Super+Shift+Q | Close window | hyprland |
| Super+F | Fullscreen | hyprland |
| Super+K | Show all bindings | vinos-keys |
Made for people who ship.
- You want AI on your laptop, not in someone else's cloud.
- You'd rather press one key than open five menus.
- You have a MacBook, ThinkPad, or Framework — and you want it to feel new again.
- You value speed, simplicity, and things that just work.
Not for you if you love spending weekends configuring your desktop from scratch, or you need Windows-style hand-holding.
Press power.
Free. Open source. Yours to keep.