Install Ódinn

Ódinn Forge currently ships as verified source archives rather than a native desktop installer. You need:

Node.js 24 or newer
Corepack
a terminal

The current public beta is v0.4.0-beta.3. Download assets only from the project’s GitHub Releases page.

Linux

tag=v0.4.0-beta.3
curl -fLO "https://github.com/jason-allen-oneal/Odinn/releases/download/$tag/odinn-$tag.tar.gz"
curl -fLO "https://github.com/jason-allen-oneal/Odinn/releases/download/$tag/SHA256SUMS.txt"
grep "  odinn-$tag.tar.gz$" SHA256SUMS.txt | sha256sum -c -
tar -xzf "odinn-$tag.tar.gz"
cd "odinn-$tag"
corepack enable
./scripts/install.sh --prefix "$HOME/.local/share/odinn"
export PATH="$HOME/.local/share/odinn/bin:$PATH"
odinn onboard

Persist the final PATH entry in your shell profile if you want odinn available in future terminals.

macOS

Use the Linux steps, but verify with the macOS checksum tool:

grep "  odinn-$tag.tar.gz$" SHA256SUMS.txt | shasum -a 256 -c -

The remaining install and onboarding commands are the same.

Windows PowerShell

$Tag = "v0.4.0-beta.3"
$Archive = "odinn-$Tag.zip"
Invoke-WebRequest "https://github.com/jason-allen-oneal/Odinn/releases/download/$Tag/$Archive" -OutFile $Archive
Invoke-WebRequest "https://github.com/jason-allen-oneal/Odinn/releases/download/$Tag/SHA256SUMS.txt" -OutFile SHA256SUMS.txt
$Expected = ((Select-String -Path SHA256SUMS.txt -Pattern "  $([regex]::Escape($Archive))$").Line -split "  ")[0]
$Actual = (Get-FileHash $Archive -Algorithm SHA256).Hash.ToLowerInvariant()
if ($Actual -ne $Expected) { throw "checksum mismatch for $Archive" }
Expand-Archive $Archive -DestinationPath . -Force
Set-Location "odinn-$Tag"
corepack enable
./scripts/install.ps1 -Prefix "$HOME/.local/share/odinn"
$env:Path = "$HOME/.local/share/odinn/bin;$env:Path"
odinn.cmd onboard

The Windows path is part of the beta and has automated cross-platform coverage, but real-host Windows stable-exit validation remains open.

Confirm the installation

odinn doctor
odinn onboard --verify --non-interactive

odinn doctor is the release-identity and diagnostic surface. odinn status reports current configuration and runtime health.

Next: Onboarding.