Omnigraph Atlas Omnigraph's documentation, bound to its Rust workspace
79 documents
docs/user/install.md

Installation guide for the `omnigraph` CLI and `omnigraph-server` across macOS/Linux (curl install.sh) and Windows (PowerShell install.ps1), plus a Homebrew tap (ModernRelay/tap). Binaries land in ~/.local/bin; the default installer is binary-only — it downloads a release asset, verifies the SHA256 checksum, unpacks it, and falls back to the rolling `edge` release if no stable tag exists. Documents stable vs edge channels, install-source.sh for building from source, override env vars (INSTALL_DIR, VERSION, SOURCE_REF), a manual cargo build, the three release assets, and verification via `omnigraph version`. When installing or upgrading Omnigraph binaries, choosing a release channel, or building from source on any platform.

Install

Quick Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.sh | bash

Windows PowerShell:

powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -UseBasicParsing https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.ps1 | iex"

By default the installer places:

  • omnigraph
  • omnigraph-server

in ~/.local/bin on macOS / Linux, or:

  • omnigraph.exe
  • omnigraph-server.exe

in %USERPROFILE%\.local\bin on Windows.

The default installer is binary-only. It downloads a published release asset, verifies the SHA256 checksum, and unpacks it. It does not build from source. If no stable tag is published yet, the installer automatically falls back to the rolling edge release.

Homebrew

brew tap ModernRelay/tap
brew install ModernRelay/tap/omnigraph

Channels

Stable binaries:

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.sh | bash

Rolling edge binaries from main:

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.sh | RELEASE_CHANNEL=edge bash

Windows rolling edge binaries:

iwr -UseBasicParsing https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.ps1 -OutFile install.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -ReleaseChannel edge

Install from source:

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install-source.sh | bash

Useful Overrides

Install to a different directory:

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.sh | INSTALL_DIR="$HOME/bin" bash

Windows:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -InstallDir "$env:USERPROFILE\bin"

Install a specific tag:

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.sh | VERSION=v0.1.0 bash

Windows:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Version v0.1.0

Build from a specific git ref:

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install-source.sh | SOURCE_REF=main bash

Manual Source Build

macOS / Linux:

cargo build --release --locked -p omnigraph-cli -p omnigraph-server
install -m 0755 target/release/omnigraph ~/.local/bin/omnigraph
install -m 0755 target/release/omnigraph-server ~/.local/bin/omnigraph-server

Windows:

cargo build --release --locked -p omnigraph-cli -p omnigraph-server
New-Item -ItemType Directory -Force "$env:USERPROFILE\.local\bin" | Out-Null
Copy-Item target\release\omnigraph.exe "$env:USERPROFILE\.local\bin\omnigraph.exe"
Copy-Item target\release\omnigraph-server.exe "$env:USERPROFILE\.local\bin\omnigraph-server.exe"

Release Assets

Tagged releases are expected to publish:

  • omnigraph-linux-x86_64.tar.gz
  • omnigraph-macos-arm64.tar.gz
  • omnigraph-windows-x86_64.zip

The macOS / Linux archives contain both binaries:

  • omnigraph
  • omnigraph-server

The Windows archive contains:

  • omnigraph.exe
  • omnigraph-server.exe

Verify The Install

macOS / Linux:

omnigraph version
omnigraph-server --help

Windows:

omnigraph.exe version
omnigraph-server.exe --help