# Installation and prerequisites Install the `rad` CLI on macOS or Linux. Release archives support Apple silicon/ARM64 and x86-64/AMD64. On Windows, use a supported Linux environment. ## Before you install Before installing Radforge, confirm that you have Git and a Git working tree. Your project must use one of these supported setups: - TypeScript/JavaScript with Vitest and exactly one supported lockfile at the repository root: `package-lock.json`, `pnpm-lock.yaml`, `bun.lock`, or `bun.lockb`. - Python with pytest, `pyproject.toml`, and `uv.lock` in the workspace Radforge will analyze. ## Install the CLI 1. Download the archive and matching `.sha256` file from [Radforge releases](https://github.com/Radforge-Dev/radforge/releases). 2. Replace the archive name in the commands below with the file for your platform. 3. Verify the checksum, extract the archive, and place `rad` on your `PATH`. ```bash shasum -a 256 -c radforge-darwin-arm64.tar.gz.sha256 tar -xzf radforge-darwin-arm64.tar.gz install -m 0755 radforge-darwin-arm64/rad "$HOME/.local/bin/rad" rad --version ``` The final command prints the installed version. Each release also includes an SBOM, build provenance, and a Sigstore bundle. ## Set up a repository Run [`rad init --dry-run`](/setup/init/) in the repository, review the proposed changes, and apply them. Then run [`rad doctor`](/setup/doctor/) to check the setup.