> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geval.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Geval as a single binary — no runtime, no npm, no pip.

Geval ships as **one executable**. Use official **[GitHub Releases](https://github.com/geval-labs/geval/releases)** binaries in CI and locally.

New to Geval? **[Watch the demo on YouTube](https://youtu.be/v6LuxIshgDU)**.

## Download (latest release)

**Linux (x86\_64)**

```bash theme={null}
curl -sSL https://github.com/geval-labs/geval/releases/latest/download/geval-linux-x86_64 -o geval && chmod +x geval
```

**macOS (Apple Silicon)**

```bash theme={null}
curl -sSL https://github.com/geval-labs/geval/releases/latest/download/geval-macos-aarch64 -o geval && chmod +x geval
```

**Windows (x86\_64)** — download `geval-windows-x86_64.exe` from the Releases page. Run `.\geval.exe demo` in PowerShell from the same folder.

Intel macOS: build [from source](#build-from-source) if no release artifact is published for your arch.

## Verify

```bash theme={null}
./geval --version
./geval --help
```

You should see subcommands including **`check`**, **`init`**, **`demo`**, **`explain`**, **`validate-contract`**, **`approve`**, **`reject`**.

## PATH (optional)

To run `geval` without `./`:

```bash theme={null}
sudo mv geval /usr/local/bin/geval
# or
mv geval ~/bin/geval
```

If another tool is also named `geval`, rename this binary (e.g. `geval-gate`) or ensure the release binary is **first** on `PATH`.

## Updating

Re-download from `/releases/latest/download/...` and replace the file. Check `./geval --version` after updating.

## Build from source

Requires [Rust](https://rustup.rs/):

```bash theme={null}
git clone https://github.com/geval-labs/geval.git
cd geval
cargo build --release --manifest-path geval/Cargo.toml
```

Binary: `geval/target/release/geval` (or `geval.exe` on Windows).

## Next

[Quickstart](/quickstart) · [GitHub Actions](/integration/github-actions)