Skip to content
Bromigos™
Menu

Get bromigOS // early access

Install. Update. Roll back.

One short script takes a fresh Arch install to the whole desktop. Every update is bracketed by a snapshot, and any update can be undone in place. Or boot the ISO: it installs with no network, encrypted, with snapshots in the boot menu.

On a fresh Arch install, as your own user: download the installer, read it, run it.

Stuck, or want company? Ask on the Discord.

01 · Install

On a fresh Arch install.

Start from Arch with a user who has sudo and a network (archinstall's minimal profile is enough). The installer refuses to run as root or off Arch, trusts the repository's key only if its fingerprint matches the one it pins, and hands over to bromigos install. --dry-run shows every step and changes nothing; running it again is safe.

Signing key 393E 7D54 F7DE 58FE 75B9 7214 947C 9D61 93D3 DD8B

  1. preflight

    Checks for a regular user with sudo, on Arch, with the [bromigos] repository

  2. packages

    Installs the bromigos package and any --with extras

  3. aur

    Installs paru, the AUR helper, unless the AUR is off or a helper is already installed

  4. services

    Enables networking, the login screen, Bluetooth and PipeWire

  5. rollback

    Sets up update snapshots, where / is btrfs

  6. hardware

    Installs and configures the graphics drivers and laptop power tools

  7. configs

    Runs the pending migrations, which create your config files

  8. desktop settings

    Sets the GTK theme, icons, cursor, font and dark mode

  9. theme

    Renders the theme

  10. boot menu

    Turns on bromigOS's GRUB theme, where GRUB boots the machine

Then bromigos setupasks the first-run questions: your monitors, the theme, VECTOR's brain and voice, your homelab, where AI runs. Reboot, sign in at the Bromigos login screen, and the desktop is there.

02 · Update

One way to update.

A snapshot, the package transaction, any pending migrations, the theme rendered again, then a restart of whatever still runs old code. A bare pacman -Syu is nudged back to it.

  • stable

    Tagged releases (vX.Y.Z). The default for new installs.

  • rc

    Release candidates (vX.Y.Z-rcN).

  • edge

    Every push to main, as soon as CI publishes it.

  • dev

    Your own build, from a local repository.

03 · Roll back

Undo any update.

On a btrfs root, rolling back shows the update and what it would touch, asks, then puts back every file the system had before it, in place. For an update that won't boot, the boot menu lists the snapshots and boots one.

04 · Packages

16 packages. One meta-package.

bromigos pulls in the desktop; the rest are options. A few packages that only live in the AUR are built into the same repository, pinned by checksum.

  • bromigosMIT OR Apache-2.0 · any

    bromigOS: holograms, homelab integrations, living themes and widgets on Arch and Hyprland

    Pulls inbromigos-keyringbromigos-corebromigos-desktopbromigos-settingsbromigos-livebromigos-widgetsbromigos-vectorbromigos-manual

    0 Arch dependencies · 15 optional
    • bromigos-homelab the homelab integrations (cluster, GitOps, metrics, models, agents)
    • bromigos-apps the app bundle (LazyVim, tmux, lazygit, mise, Chromium, Spotify, Signal), configured and themed
    • herdr the agents the Swarm deck and the worlds show
    • paru AUR packages, updated by bromigos update (bromigos install installs it; docs/aur.md)
    • ollama a local brain for VECTOR
    • uv VECTOR builds its voice and brain environments with it
    • bluez Bluetooth
    • bluez-utils Bluetooth from the terminal (bluetoothctl)
    • brightnessctl the brightness keys
    • btop the bar CPU/memory click
    • pavucontrol the bar volume click
    • pcmanfm the default file manager bind
    • swappy annotate a screenshot from its notification
    • wf-recorder screen recording
    • zoxide frecent folders (z) and WORKBENCH
  • bromigos-appsMIT OR Apache-2.0 · any

    bromigOS app bundle: LazyVim, tmux, lazygit, mise, Chromium, Spotify and Signal, configured and themed

    Pulls inbromigos-corebromigos-desktop

    12 Arch dependencies · 3 optional

    neovimtmuxlazygitmisechromiumspotify-launchersignal-desktopgitripgrepfdwl-clipboardbtop

    • 1password the password manager (bromigOS builds it into its repository)
    • nodejs language servers LazyVim installs through mason
    • python the same, for Python tooling
  • bromigos-coreMIT OR Apache-2.0 · x86_64

    bromigos: one command for the bromigOS desktop

    4 Arch dependencies · 10 optional

    gcc-libsglibcopensslgit

    • python bromigos private, secrets and emblem
    • sops the private overlay (bromigos private)
    • age the private overlay key (bromigos private)
    • inkscape emblem text as outlines (bromigos emblem build)
    • librsvg emblem PNGs and the banner braille (bromigos emblem build)
    • python-gobject emblem PNGs (bromigos emblem build)
    • python-cairo emblem PNGs (bromigos emblem build)
    • python-pillow the banner braille (bromigos emblem build)
    • python-numpy a world loop from a raw clip (bromigos art make video.loop --alpha)
    • ffmpeg a world loop from a raw clip (bromigos art make video.loop --alpha)
  • bromigos-desktopMIT OR Apache-2.0 · any

    bromigOS desktop: default configs for Hyprland, waybar, rofi, dunst, gtklock and hypridle, and their tools

    Pulls inbromigos-corebromigos-livebromigos-widgetsbromigos-settingsbromigos-homelab

    37 Arch dependencies · 13 optional

    hyprlandwaybarrofidunstgtklockhypridlehyprlockswaybgzshpythonlibnotifywl-clipboardgrimslurpplayerctlkittyxdg-desktop-portal-hyprlandxdg-desktop-portal-gtkhyprpolkitagentpipewirepipewire-pulsepipewire-audiowireplumberlibpulsenetworkmanagerxdg-utilspython-gobjectpython-pillowdesktop-file-utilsswayosdwestongtk3gtk4libadwaitaluagtk4-layer-shelllibxkbcommon

    • git bromigos theme install <url>
    • swappy annotate a screenshot from its notification
    • wf-recorder screen recording (bromigos-rec)
    • brightnessctl the brightness keys
    • pavucontrol the bar volume click
    • bluez-utils Settings › Bluetooth (bluetoothctl)
    • nm-connection-editor Settings › Network › More settings (802.1X, WEP, proxies)
    • btop the bar CPU/memory click
    • pcmanfm the default file manager bind
    • zoxide frecent folders (z) and WORKBENCH
    • iproute2 the bar address copy
    • python-evdev the dial of a peripheral module (bromigos peripheral enable installs it)
    • python-openrazer the lighting of a Razer keyboard (bromigos peripheral enable installs it)
  • bromigos-homelabMIT OR Apache-2.0 · any

    bromigOS homelab integrations: capabilities, adapters, the LAB panel, homelab decks and VECTOR tools

    Pulls inbromigos-corebromigos-lab-catalog

    2 Arch dependencies · 10 optional

    pythonpython-textual

    • bromigos-widgets the LAB panel and declared panels
    • bromigos-live the Ops, Netmap and Mind decks; the worlds homelab signals
    • bromigos-vector VECTOR homelab tools and Gnosis memory
    • kubectl the kubernetes source (read-only kubeconfig)
    • github-cli the github source (CI, PRs)
    • vault @vault: references in homelab.toml
    • python-numpy VECTOR Gnosis memory mirror
    • python-huggingface-hub bromigos lab models refresh --hf (newer models on Hugging Face)
    • python-boto3 s3 sources: bucket sizes (with a read-only key)
    • poppler the ocr job kind: PDF pages
  • bromigos-keyringMIT OR Apache-2.0 · any

    bromigOS package-signing key for pacman

  • bromigos-lab-catalogMIT OR Apache-2.0 · any

    bromigOS lab model catalog: the best open models per AI capability and GPU size, with licences

  • bromigos-liveMIT OR Apache-2.0 · any

    bromigOS live layer: the animated, data-reactive background, its worlds and decks

    Pulls inbromigos-core

    12 Arch dependencies · 7 optional

    pythonpython-gobjectgtk3gtk-layer-shelllibrsvgpython-cairopython-openglpython-numpypython-pillowpython-psutilffmpeghyprland

    • pipewire-audio sound cues (pw-play)
    • libnotify notices from the supervisor
    • git the Swarm deck and the timeline
    • github-cli CI in the Swarm deck
    • nvidia-utils GPU readings on NVIDIA
    • grim the intercept freezes the screen it tears
    • iputils latency readings
  • bromigos-manualMIT OR Apache-2.0 · any

    bromigOS manual: how to use the desktop, as HTML, for reading offline

  • bromigos-settingsMIT OR Apache-2.0 · any

    bromigOS system settings: the login screen, the boot splash and menu, the GTK, icon and cursor themes, the fonts

    Pulls inttf-geist-mono

    13 Arch dependencies · 3 optional

    sddmqt6-declarativewestonttf-meslo-nerdnoto-fontsnoto-fonts-emojibreeze-iconsadwaita-cursorspythongtk3gtk4glib2-develpython-pillow

    • plymouth the Bromigos boot splash (plymouth-set-default-theme -R bromigos)
    • grub the Bromigos boot menu (bromigos boot theme on)
    • grub-btrfs snapshots in the boot menu, titled like bromigOS's rollback list
  • bromigos-vectorMIT OR Apache-2.0 · any

    bromigOS VECTOR: the desktop caretaker, his hologram, voice, tools and memory

    Pulls inbromigos-core

    12 Arch dependencies · 8 optional

    pythonpython-gobjectgtk3gtk-layer-shellpython-cairopython-openglpython-numpypython-pillowpython-psutilpython-yamlbubblewraphyprland

    • uv bromigos-holo setup (fetches Python 3.12 for the voice)
    • pipewire-audio his voice and push-to-talk (pw-play, pw-record)
    • bromigos-live the holograms, the codec and his place in the live layer
    • ollama a local brain (the default endpoint without a configured one)
    • grim his eyes (read-only screenshots)
    • github-cli CI and repo tools
    • kubectl the homelab tools
    • git the build loop and change tracking
  • bromigos-widgetsMIT OR Apache-2.0 · any

    bromigOS desktop widgets: system, network, storage, workbench, notes and shortcuts panels

    Pulls inbromigos-core

    8 Arch dependencies · 5 optional

    pythonpython-gobjectgtk3gtk-layer-shellpython-cairopython-psutilpangohyprland

    • git recent repos on WORKBENCH
    • zoxide most-visited folders on WORKBENCH
    • nvidia-utils GPU readings on NVIDIA
    • iputils the latency radar
    • lua SHORTCUTS from a Lua Hyprland config when Hyprland is not running

Built into the repository

  • 1passwordLicenseRef-1Password-Proprietary · x86_64

    Password manager and secure wallet

    1password.com
    5 Arch dependencies

    gtk3nsshicolor-icon-themexdg-utilspolkit

  • herdrAGPL-3.0-or-later · x86_64

    Terminal workspace manager for AI coding agents

    github.com/ogulcancelik/herdr
    2 Arch dependencies

    gcc-libsglibc

  • paruGPL-3.0-or-later · x86_64

    Feature packed AUR helper

    github.com/Morganamilo/paru
    4 Arch dependencies · 2 optional

    gitpacmanlibalpm.so>=14base-devel

    • bat colored pkgbuild printing
    • devtools build in chroot and downloading pkgbuilds
  • ttf-geist-monoOFL-1.1 · any

    Geist Mono, a monospaced typeface by Vercel

    github.com/vercel/geist-font
    1 Arch dependency

    fontconfig

05 · Reference

Every command.

The bromigos command's built-ins. Plugins add their own; bromigos commands lists everything on your machine.

The command reference · 27
bromigos session
The live Hyprland session (prints KEY=value; import, exec or adopt it; hold and release its config reloads around a package transaction)
bromigos theme
The look: list the themes, show the current one, set one (renders every app's colours)
bromigos ext
Extensions from git: themes, decks, widgets, VECTOR tools, homelab adapters, commands, hooks (install, list, info, update, remove, new, search)
bromigos anim
Every wallpaper animation and whether it's on; turn them on, off or reset
bromigos live
The whole animated background: on|off (runtime), or any bromigos-live command
bromigos vector
VECTOR (any bromigos-holo command: off, on, vector, ask, status, mute, …)
bromigos profile
Who you are and what VECTOR calls you (show, set, address, alias)
bromigos art
A world's art: plan (price it), run (make it through nolgia), status, mark
bromigos target
Where AI work runs: homelab, local or cloud, per service (art, VECTOR's voice and brain); show it, probe it, switch it (bromigos target local)
bromigos mute
The desktop's one mute: the theme's sounds and VECTOR's voice together (on, off, toggle, status; SUPER+SHIFT+M)
bromigos peripheral
Optional peripheral modules: a Razer keyboard's macro keys, its dial as VECTOR's voice dial, lighting that follows VECTOR (list, status, enable, disable, refresh)
bromigos accessibility
Reduced motion and high contrast: show them, set them (bromigos accessibility motion reduced, contrast high), measure a theme's colours (check)
bromigos idle
Idle and lock: when the screensaver starts, the screen locks, the displays go off and it suspends (status, set, preset, stay-awake, off, undo)
bromigos lock
Lock the screen now (loginctl lock-session)
bromigos wallpaper
The den wallpaper (any bromigos-wallpaper command)
bromigos update
Update everything: packages (sudo pacman -Syu, then AUR packages with paru), then migrations, the theme, and restarts of whatever runs older code than is installed
bromigos channel
The update channel this machine follows (stable, rc, edge, dev): show it, or switch
bromigos rollback
Rolling updates back: status (how this machine snapshots updates, what can be undone), setup (snapper's root configuration, snap-pac, grub-btrfs with its overlay hook or limine-snapper-sync, where / is btrfs), allow (wheel may list root's snapshots, so updates are recorded). Undoing one is bromigos update --rollback
bromigos aur
The AUR (build recipes Arch users share): status (the helper here, whether bromigos update uses it, the AUR updates waiting), on, off, ensure
bromigos boot
The boot menu: bromigOS's GRUB theme in your theme's colours (bromigos boot theme status|on|off|apply)
bromigos restart
Restart what runs stale (its package is newer than the process), or the pieces named
bromigos whats-new
What's new in this release of bromigOS: the release notes installed with it (they read offline; the manual's "What's new" page)
bromigos install
Install bromigOS on this machine (after install.sh): the packages, services, the hardware, your configs, the desktop settings and the theme, then the first-run setup
bromigos hw
This machine's hardware: its GPUs and their drivers, a laptop's battery, backlight, touchpad and power profiles; hw setup sets them up
bromigos setup
The first-run questions (monitors, the AUR, hardware, accessibility, theme, VECTOR's brain and voice, homelab, where AI runs, the creation tools, peripheral modules); run again any time, or one section: bromigos setup voice. bromigos setup homelab detects your homelab's services (bromigos-homelab; --hosts, --url, --yes, --print)
bromigos status
The live layer, VECTOR, the session and the animations
bromigos commands
Every command: the built-ins and the bromigos-<group>-<name> executables found

Generated from bromigOS · bromigOS@4b30a91 · vector@67f98a8

What bromigOS does