vinOS

An agentic OS for founders, innovators, and thinkers.

Flash a USB. Boot. In fifteen minutes, local LLMs and Claude Code
are one keystroke away — on any x86_64 laptop, workstation, or server.

vinos.computer  ·  Download  ·  Install guide  ·  Bundles  ·  Hardware matrix  ·  Discussions

• 🤖 Agent-native from first boot. Super+A → local LLM (Ollama). Super+Shift+A → Claude Code. vinos-ai chat in any terminal.
• 💻 Runs on any x86_64. Framework, System76, StarLabs, Tuxedo, your old MacBook, the box in your basement. linux-t2 baked into the ISO so Intel MacBooks work on first boot — keyboard, trackpad, Wi-Fi, Touch Bar.
• 🎨 Beautiful Wayland desktop. Hyprland + waybar + walker + foot + hyprlock. Tokyo-night polish. Sensible defaults. No setup weekend.
• 📦 8 opt-in bundles. ai · dev · media · office · gaming · comms · browser · productivity — one command each. vinos-install ai and you're done.
• 🔧 88 vinos-* helpers. Every one a shell script you can read. vinos-doctor for status. vinos-menu (Super+Ctrl+O) for the hub.
• 🔒 Local-first economics. 80% of agent workloads on your own GPU. Frontier API for the 20% that needs it. Your prompts, files, and keys don't leave your hardware.

Real frames from a boot of the shipping ISO. See the site for the full walkthrough video.

Hyprland desktop, first boot — no dotfile weekend	Super+Ctrl+O — the vinOS hub (bundles, themes, doctor, wifi)
vinos-doctor — every check green on a fresh boot	Hyprland tiling. One workspace, three panes.

vinOS is solo-maintained and MIT licensed. If it saves you a subscription fee or a weekend of setup, please consider supporting the work:

Sponsors fund:

• Real-hardware verification — Framework, StarLabs, Tuxedo, older ThinkPads, MacBooks
• Infrastructure — archive.org hosting, GitHub Actions runners, build machines
• Roadmap work — fleet management, agent snapshots, audit/safety layers, offline docs
• Community support — hardware reports, documentation, response time

For OEMs and enterprise deployments: hello@vinos.computer.

Path A — flash the ISO (recommended, no prior Arch needed):

# 1. Download from archive.org (4.3 GB)
curl -L -o vinos-1.1.0-x86_64.iso \
  https://archive.org/download/vinos-1.1.0-x86_64/vinos-1.1.0-x86_64.iso

# 2. Flash to USB (replace /dev/sdX with your USB device — check `lsblk`)
sudo dd if=vinos-1.1.0-x86_64.iso of=/dev/sdX bs=4M status=progress oflag=direct conv=fsync

# 3. Boot the target machine off the USB, then:
sudo vinos-install-disk

Path B — layer onto existing Arch:

curl -fsSL https://raw.githubusercontent.com/vinpatel/vinos/main/boot.sh | bash

Clones this repo to ~/.local/share/vinos and runs install.sh idempotently. Full details: docs/INSTALL.md.

Full list: docs/KEYBINDINGS.txt.

• v1.1.0 — shipping. Boots clean on x86_64 + Intel T2 Macs. 8 opt-in bundles. Local + frontier AI wired.
• v1.2 — AI stack preloaded in the base ISO (Super+A works out of box). Cockpit + nodes for fleet deployments. Agent snapshots + audit. OEM preload builds.
• v1.3 — Custom-branded builds for enterprise. Community model marketplace. First-party hardware partner announcement.

Add only what you use — each bundle is a plain list of packages, no magic.

Read the bundle definitions: docs/BUNDLES.md.

Start with docs/README.md — the documentation index. It routes you to the right doc based on what you're trying to do.

• docs/QUICKSTART.md — first-boot walkthrough
• docs/INSTALL.md — install paths (fresh USB, existing Arch, T2 Mac)
• docs/USB.md — flashing live USBs
• docs/HARDWARE.md — verified-hardware matrix
• docs/KEYBINDINGS.txt — the cheat sheet Super+K shows
• docs/BUNDLES.md — every opt-in bundle
• docs/PREFLIGHT.md — the mandatory pre-flash gate

• docs/VISION.md — why vinOS exists, the two-product framing, the north star
• docs/ARCHITECTURE-v1.1.0.md — the frozen baseline architecture reference
• docs/DESIGN-DECISIONS.md — every big design decision (why Ubuntu for the VM, why no Omarchy, why runner-agnostic, etc.)
• .planning/RULES.md — durable rules that govern all future work
• .planning/ROADMAP.md — milestones v1.2.0 → v1.4.0
• .planning/research/PERSONAS.md — full dual-persona design spec

• docs/CONTRIBUTING.md — dev setup, commit style, review flow
• docs/BUILDING.md — reproduce the ISO from source, step-by-step
• iso/README.md — the ISO build subsystem
• ATTRIBUTIONS.md — prior-art credits

Every script is Bash, shellcheck-clean, under ~80 lines. Config lives in config/ and gets rsync'd to ~/.config/.

Read docs/CONTRIBUTING.md before your first PR — vinOS has strong opinions (no Omarchy code, no commit trailers, ship-gate mandatory) that are easier to honor if you know them upfront.

Best first contribution: flash the ISO on a new hardware family and file a hardware report. Every report widens the compatibility matrix.

MIT © Vin Patel. See LICENSE and ATTRIBUTIONS.md.