Skip to main content

Install Gnarl

A node is a single self-contained binary with a desktop wrapper around it. There is no cluster to provision and no external datastore to stand up first.

Early-adopter software

Gnarl is pre-1.0 software from Lucenia, under active development. Interfaces described here can still change between releases, and release candidates are tagged v0.1.0-rcN. Check the releases page for what is currently published.

Requirements​

OSmacOS 12+, Windows 10+, Linux (x86_64, aarch64)
Memory2 GB minimum, 8 GB+ for large corpora
DiskRoughly 25–40% of your corpus size for the local index
NetworkOne HTTP port (default 8080)
JDKNot required. Search and agent memory are pure Rust.

Desktop​

Start at the download page. It presents the license, then hands you the right package for your OS and CPU. That is the canonical way in.

If you would rather pick a file by hand, every artifact is also listed on the latest release.

OSInstaller
macOS Apple Silicongnarl-*-macos-aarch64.dmg
macOS Intelgnarl-*-macos-x86_64.dmg
Windows x64gnarl-*-windows-x86_64-setup.exe
Windows ARM64gnarl-*-windows-arm64-setup.exe
Debian / Ubuntugnarl_*_amd64.deb · *_arm64.deb
RHEL / Rocky / Almagnarl-*.x86_64.rpm · *.aarch64.rpm

Every artifact is gnarl-*, and the installed app is Gnarly — the command it gives you is gnarl.

Launch it once. The node runs in the background with an icon in the menu bar or system tray:

  • Open Console — opens the web UI at your machine's bound address
  • Quit — stops the node

Early-adopter builds are not yet notarized: macOS may need right-click → Open, and Windows SmartScreen needs More info → Run anyway.

CLI​

macOS and Linux​

curl -fsSL https://gnarl.dev/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
gnarl --help

Windows (PowerShell)​

irm https://gnarl.dev/install.ps1 | iex
gnarl --help

Both scripts are served by this site, not by a source repository, so the URL stays the same across releases. Read either one before piping it to a shell.

The installer needs a published release asset for your platform. If it cannot find one, build from source below.

brew install lucenia is a different product

The lucenia Homebrew cask is the older command-line client for Lucenia search clusters. It is not this node. Use the installers above.

Mobile​

Phones are full peers, not thin clients — they index locally and answer for the data they hold, within power and connectivity limits.

iOS and Android builds (Gnarly Edge) are produced by every release but are not yet published to the App Store or Google Play. Until then they install from the release page by hand.

First run​

gnarl start
▸ Console  http://127.0.0.1:8080/

The node is now searchable by you and invisible to everyone else. Nothing is announced to any network until you create or join a mesh.

gnarl search "glacier retreat"

Next​