Skip to main content

Linux Install (x86_64)

1. Download the tarball​

From Releases, download the .tar.gz and its .tar.gz.sha256 sidecar:

curl -LO https://github.com/locai-co-uk/locai-link/releases/latest/download/locai-link-llm-stt-linux-x86_64-vX.Y.Z.tar.gz
curl -LO https://github.com/locai-co-uk/locai-link/releases/latest/download/locai-link-llm-stt-linux-x86_64-vX.Y.Z.tar.gz.sha256
sha256sum -c locai-link-llm-stt-linux-x86_64-vX.Y.Z.tar.gz.sha256

Substitute the exact release version.

2. Extract and install​

Extract, then run the bundled installer:

tar -xzf locai-link-llm-stt-linux-x86_64-vX.Y.Z.tar.gz
cd locai-link-llm-stt-linux-x86_64-vX.Y.Z
./install.sh

install.sh runs unprivileged (no sudo needed):

  • Copies the runtime, Setup Assistant, and companion binaries to ~/.local/share/locai/.
  • Registers systemd --user unit files (locai-link-agent.service, locai-link-companion.service).
  • Drops .desktop entries under ~/.local/share/applications/ so Locai Link and Setup Assistant appear in your desktop environment's app launcher (GNOME Activities, KDE Menu, etc.).
  • Installs hicolor icons.
  • Starts the agent and companion via systemctl --user.
  • Launches the Setup Assistant automatically.
Custom install location

$LOCAI_INSTALL_ROOT overrides the install path if you want it somewhere other than ~/.local/share/locai.

3. Setup Assistant​

Identical to the macOS flow starting at step 3 of the macOS install: welcome, sign in, device name, permissions, registration, models, finish.

The companion appears in your system tray (GNOME Shell, KDE Plasma, etc.). If your desktop environment doesn't have a system tray (some minimal window managers), the companion still runs but you'll need to interact with it via the CLI / Preferences shortcut.

Continue to Using the companion.