Skip to content
Install

Get DeltaForge on your machine
macOS, Windows, and Linux

Install from your platform's package manager, or grab a tarball from GitHub Releases. Artifacts include GPG signatures and a SHA256SUMS manifest for verification.

Packages

Four binaries, pick what you need

Choose the package for your platform and workflow. Install only what you use.

deltaforge

Desktop application with integrated query editor, catalog browser, pipeline viewer, and compute-node management. Start here for interactive development.

deltaforge-cli

Headless command-line interface. Run queries, scripts, migrations, and health checks. Suited for CI pipelines and servers.

deltaforge-mcp

Model Context Protocol server. Plugs DeltaForge into MCP-compatible AI assistants so they can query your lake, catalog, and pipeline graph.

deltaforge-compute

Headless compute node. Scales query execution horizontally. Run one locally for development, or a fleet in production.

macOS

Homebrew tap

One tap, then install the package you need. The desktop app is a Homebrew cask; the CLI packages are formulae.

# Add the DeltaForge tap (one-time)
brew tap deltaforge-org/tap

# Desktop application
brew install --cask deltaforge

# Command-line tools
brew install deltaforge-cli
brew install deltaforge-mcp
brew install deltaforge-compute

Tap source: github.com/deltaforge-org/homebrew-tap

Windows

winget or Scoop

winget is recommended for the desktop app (MSI installer). Scoop is a good fit for the CLI packages if you prefer portable installs.

winget
winget install DeltaForge.Desktop
winget install DeltaForge.Cli
winget install DeltaForge.Mcp
winget install DeltaForge.Compute
Scoop
# Add the DeltaForge bucket (one-time)
scoop bucket add deltaforge https://github.com/deltaforge-org/scoop-bucket

# Install CLI packages
scoop install deltaforge-cli deltaforge-mcp deltaforge-compute

Bucket source: github.com/deltaforge-org/scoop-bucket

Linux

One-liner installer

Detects your OS and architecture, downloads the matching tarball, and drops the binary on your PATH.

one-liner
# Default: install deltaforge-cli to /usr/local/bin
curl -fsSL https://deltaforge.org/install.sh | sh

# Pick a different package
curl -fsSL https://deltaforge.org/install.sh | sh -s -- --pkg deltaforge-mcp

# Install without sudo by choosing a writable prefix
curl -fsSL https://deltaforge.org/install.sh | sh -s -- --prefix $HOME/.local/bin
manual download
# Grab a tarball from the Releases page and extract where you want
curl -fsSL https://github.com/deltaforge-org/delta-forge/releases/latest/download/deltaforge-cli-linux-x64.tar.gz \
  | sudo tar -xz -C /usr/local/bin

Release tarballs include a .sig detached GPG signature, plus SHA256SUMS and SHA256SUMS.sig. See Verify your download.

Verify

Make sure you got what we shipped

Release artifacts include detached GPG signatures created with the DeltaForge release key. The public key is committed to the release repository so you can pin it in air-gapped environments.

# Import the signing key (one-time)
curl -fsSL https://deltaforge.org/pubkey.asc | gpg --import

# Verify a downloaded artifact
gpg --verify deltaforge-cli-1.0.0-linux-x64.tar.gz.sig \
             deltaforge-cli-1.0.0-linux-x64.tar.gz

Fingerprint

B461 8130 D4B0 3CF5 454E  28F0 A859 0BF7 C3DC E5F3

UID

DeltaForge Releases
releases@deltaforge.org

Algorithm

RSA 4096, created 2026-04-21, valid through 2028-04-20.

Got it installed. What now?

Register a workspace in the console, point it at a Git repo with SQL in it, and run your first query.