Skip to content
Reasons Forge

Installation

Requirements

Section titled “Requirements”
  • Python 3.10+
  • An LLM API key (Anthropic, OpenAI, or Google) for derive/review stages

Install from PyPI

Section titled “Install from PyPI”
Terminal window
pip install reasonsforge

Or with uv:

Terminal window
uv tool install reasonsforge

Install from source

Section titled “Install from source”
Terminal window
git clone https://github.com/reasonsforge/reasonsforge.git
cd reasonsforge
pip install -e .

API key configuration

Section titled “API key configuration”

Reasons Forge needs an LLM API key for the derive, review, and repair stages. Set it as an environment variable:

Terminal window
# Anthropic (recommended)
export ANTHROPIC_API_KEY=sk-ant-...


# OpenAI
export OPENAI_API_KEY=sk-...


# Google
export GOOGLE_API_KEY=...

Verify installation

Section titled “Verify installation”
Terminal window
reasonsforge --version
reasonsforge --help

What’s installed

Section titled “What’s installed”

The reasonsforge package includes:

  • The reasonsforge CLI
  • The core TMS engine (add, retract, derive, review, challenge, defend, nogood)
  • All built-in forge modules (code, project, product, paper, document)
  • Export to SQLite, JSON, markdown, and static wiki formats