Adom Hydrogen (Linux)

Bootstrap with one command

Latest: v0.1.3, published

Fresh container (no adom-wiki yet):

bash <(curl -fsSL https://wiki.adom.inc/static/bootstrap.sh) adom/hydrogen-linux-bootstrap

Already have adom-wiki installed:

adom-wiki pkg install adom/hydrogen-linux-bootstrap

What you'll get 2 apps, 1 bootstrap

Contents

README

markdown

Adom Hydrogen (Linux)

The Linux platform layer for Hydrogen. On Linux, Hydrogen's workspace is a systemd-nspawn machine on your own computer; this package makes both the computer and the workspace ready for Hydrogen and its dock apps, on Ubuntu, Debian and Fedora.

adom/core
 └─ adom/hydrogen-bootstrap                 (platform-generic Hydrogen layer)
     ├─ adom/hydrogen-windows-bootstrap     (Windows, WSL2)
     ├─ adom/hydrogen-mac-bootstrap         (macOS, Lima)
     └─ adom/hydrogen-linux-bootstrap       <- THIS: Ubuntu, Debian, Fedora

You never install this by hand: Hydrogen for Linux installs it in the workspace and runs its host half on your computer during setup and after every update.

Two halves

In the workspace (install.sh, then hooks/hydrogen-linux-platform-hygiene.sh after every package update):

  • ffmpeg with libx264 (AI runs that make video);
  • the en_US.UTF-8 locale;
  • Node 22 LTS when the workspace's Node is older than 20 (the official nodejs.org build, checked against its SHA256SUMS);
  • earlyoom, told never to stop VS Code (its extension host runs every AI chat), Hydrogen or the AI CLIs, and to stop compilers, linkers and ffmpeg first;
  • the AIs' sign-in sites trusted in VS Code, so their sign-in pages open without "Do you want to open the external website?".

On the computer (host/hydrogen-host-setup.sh): Hydrogen runs it with one password prompt. It installs only what is missing, says what it is about to change, and changes nothing on a second run. check changes nothing at all; Hydrogen Doctor uses it.

What it sets up

Item Why Ubuntu / Debian Fedora
H.264 playback Hydrogen's webviews (WebKitGTK) play video through GStreamer; Adom's videos are H.264 High + AAC gstreamer1.0-libav, -plugins-bad, -plugins-good, -vaapi RPM Fusion free (announced on screen), ffmpeg in place of ffmpeg-free, gstreamer1-plugin-libav
AppImage runtime Grok Bot and the Adom Bridge AppImage need FUSE 2 libfuse2t64 (24.04, Debian 13) or libfuse2 fuse-libs
Flatpak + Flathub KiCad installs from Flathub flatpak (present)
Flatpak apps in menus now KiCad's icon and entry without logging out links in ~/.local/share + environment.d same
Tray icon Hydrogen lives in the tray when closed Ubuntu has it; Debian GNOME: gnome-shell-extension-appindicator gnome-shell-extension-appindicator
Desktop portal screenshots, screen capture, annotate xdg-desktop-portal + -gnome, -xapp (Cinnamon) or -kde xdg-desktop-portal-gnome
Dictate audio Hydrogen records the mic itself PipeWire's pw-record (or pulseaudio-utils on PulseAudio) pipewire-utils
Clipboard tools an annotate picture stays on the clipboard wl-clipboard, xclip same
Notifications, links Adom Bridge notifications, opening links libnotify-bin, xdg-utils libnotify, xdg-utils
Out-of-memory guard a full memory must not freeze the desktop, and never stops VS Code, Hydrogen or the AIs earlyoom where systemd-oomd is not running (Debian), with Hydrogen's avoid and prefer lists systemd-oomd
Adom fonts dashboards and tiles Familjen Grotesk, Satoshi, JetBrains Mono in ~/.local/share/fonts same
Workspace time zone the workspace follows the computer set on every run same
Google Chrome (optional) only the native browser bridge needs it; your default browser is kept Google's .deb Google's .rpm

In the workspace it also installs the libraries headless Chrome needs (libnss3, libnspr4, libasound2t64, libgbm1 and the rest), so tools that drive Chrome there (Hero Studio, page renders) work.

Known gap, next: tools in the workspace cannot reach the computer's Adom Bridge relay the way adom-bridge ping does (Hero Studio's pup fallback answers "Adom Desktop did not answer browser_status").

It also checks, and reports in Doctor: the Adom Bridge window list extension on GNOME Wayland (Adom Bridge installs it; it is active after logging out and in once), Adom Bridge's mesh (on, relay mode), firewalld for the mesh port, and the login keyring Chrome uses.

Checking a computer

bash host/hydrogen-host-setup.sh check
Hydrogen host check 0.1.0 on Ubuntu 24.04.5 LTS (ubuntu:GNOME, wayland)
  h264          ok       avdec_h264 decodes the High-profile sample
  fuse2         ok       libfuse.so.2 present (AppImages run)
  flatpak       ok       flatpak with Flathub
  tray          ok       Ubuntu's own AppIndicator extension
  ...

relogin means installed, active after logging out and in once.