Skip to content

Installing the Forge CLI

Follow this step-by-step guide to install the Forge optimization CLI runtime on Linux, macOS, and Windows.

Last updated: 16 Aug 2026Introduction

System Requirements

Forge runs as a lightweight native binary or python tool. Before installing, ensure you have Python 3.10+ installed on your system.

Standard Installation

The fastest way to install Forge is using the uv package manager, which manages dependencies and executes commands in an isolated virtual environment.

uv tool install forgeoptimizer

Alternatively, you can install using pipx or directly from source:

pipx install forgeoptimizer

Verifying Installation

After installation, run the following command to verify that Forge is added to your PATH and functional:

forge --version

Initialization

Navigate to any software project directory and run the init command to set up your configuration file:

forge init

This creates a local Forge.toml file in your repository root, ready for custom behavior rulesets.