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

If this saves you a subscription — or a setup weekend — a ⭐ helps others find it.

---

What it does

• 🤖 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.

Screenshots

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.

Install

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.

Keybindings (a taste)

Chord	Action
Super + A	Local AI chat (Ollama)
Super + Shift + A	Claude Code in project
Super + Space	Walker launcher
Super + Return	Terminal (foot)
Super + Ctrl + O	vinOS menu (hub)
Super + Ctrl + W	Wi-Fi picker (impala)
Super + Ctrl + T	Live theme switch
Super + K	Full cheat sheet (live from your Hyprland config)

Full list: docs/KEYBINDINGS.txt.

Roadmap

• 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.

Bundles

Add only what you use — 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 · zathura · obsidian · localsend
gaming	vinos-install gaming	steam · lutris · gamemode · mangohud · protontricks
comms	vinos-install comms	signal-desktop · slack · zoom · discord
browser	vinos-install browser	chromium · firefox · brave-bin
productivity	vinos-install productivity	obsidian · dbeaver · postman · flameshot · syncthing

Read the bundle definitions: docs/BUNDLES.md.

Docs

• docs/INSTALL.md — install paths (fresh USB, existing Arch, T2 Mac)
• docs/QUICKSTART.md — first-boot walkthrough
• docs/BUNDLES.md — every opt-in bundle
• docs/HARDWARE.md — verified-hardware matrix
• docs/KEYBINDINGS.txt — the cheat sheet Super+K shows
• docs/USB.md — flashing live USBs
• docs/PREFLIGHT.md — the mandatory pre-flash gate
• overlays/README.md — persona forks (education, health)
• iso/README.md — the ISO build path
• ATTRIBUTIONS.md — prior-art credits

Contributing

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

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

💛 Sponsor this project

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.

License

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