Installation

Standalone Installers (Recommended)

Fastest way to install pre-compiled, release-optimized binaries on Linux, macOS, or Windows.

Linux / macOS (Shell Script)

curl -fsSL https://raw.githubusercontent.com/symtrace/symtrace/main/install.sh | bash

Windows (PowerShell Script)

iwr -useb https://raw.githubusercontent.com/symtrace/symtrace/main/install.ps1 | iex

Pre-Compiled Release Binaries (GitHub Releases)

You can download signed standalone production binaries directly from GitHub Releases (v0.5.0):

Platform / Target	Asset Name	Format
Windows x86_64	symtrace-x86_64-pc-windows-msvc.zip	ZIP Archive
Windows Standalone	symtrace.exe	Portable Executable
Linux x86_64	symtrace-x86_64-unknown-linux-gnu.tar.gz	Gzip Tarball
Integrity Hashes	SHA256SUMS.txt	SHA-256 Checksums
Supply Chain SBOM	symtrace.spdx.json	SPDX JSON SBOM

# Verify checksums on Linux / macOS
sha256sum -c SHA256SUMS.txt

# Verify checksums on Windows PowerShell
Get-FileHash symtrace.exe -Algorithm SHA256

Build from Source

Prerequisites

• Rust (toolchain edition 2021+)
• A C compiler (gcc, clang, or MSVC) for libgit2 and tree-sitter native bindings

Clone & Build

git clone https://github.com/symtrace/symtrace.git
cd symtrace

# Production release build
cargo build --release

Binary location: target/release/symtrace (.exe on Windows).

Production Build Scripts

Runs clean, formatting, clippy linting (warnings-as-errors), full test suite (332 tests), and release build:

./build.sh production          # macOS / Linux
.\build.ps1 -Target production # Windows
make production                # GNU Make

Verify Installation

symtrace --version
# Output: symtrace 0.5.0