Installing the Forge CLI
Follow this step-by-step guide to install the Forge optimization CLI runtime on Linux, macOS, and Windows.
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.