Download a release tarball from GitHub Releases. Each archive contains multiple binaries (gestalt, gestalt-agent, gestalt-send, gestalt-notify, gestalt-otel).

Install all binaries into your PATH.

Linux/macOS example:

# choose your platform archive (example: linux amd64)
curl -L -o gestalt.tar.gz https://github.com/dyne/gestalt/releases/latest/download/gestalt-linux-amd64.tar.gz
sudo tar -xzf gestalt.tar.gz -C /usr/local/bin

Windows PowerShell example:

# choose your platform archive (example: windows amd64)
Invoke-WebRequest -Uri https://github.com/dyne/gestalt/releases/latest/download/gestalt-windows-amd64.tar.gz -OutFile gestalt.tar.gz
tar -xzf .\gestalt.tar.gz
Move-Item .\gestalt.exe "$env:USERPROFILE\bin\gestalt.exe"
Move-Item .\gestalt-agent.exe "$env:USERPROFILE\bin\gestalt-agent.exe"
Move-Item .\gestalt-send.exe "$env:USERPROFILE\bin\gestalt-send.exe"
Move-Item .\gestalt-notify.exe "$env:USERPROFILE\bin\gestalt-notify.exe"
Move-Item .\gestalt-otel.exe "$env:USERPROFILE\bin\gestalt-otel.exe"

Run:

# starts dashboard + API server
# dashboard URL: http://localhost:57417
gestalt

# runs an agent profile in standalone mode (requires Codex CLI installed)
gestalt-agent <agent-name>

Temporal workflow dev server auto-start requires the temporal CLI. If temporal is not installed, disable auto-start:

gestalt --temporal-dev-server=false

Prerequisites:

• Go and Node.js (see pinned versions in mise.toml)

Build and install:

npm i
make
make install

Main test command:

make test

Optional direct commands:

go test ./...
cd frontend && npm test -- --run

More details: TESTING.md

Copyright (C) 2025-2026 Dyne.org foundation

Designed and written by Denis "Jaromil" Roio.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.