Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Quick Start

Get ReasonKit running in 30 seconds.

Installation

# Linux / macOS
curl -fsSL https://get.reasonkit.sh | bash

# Windows PowerShell
irm https://get.reasonkit.sh/windows | iex

Using Cargo

cargo install reasonkit-core

Using pip (with uv)

uv pip install reasonkit

From Source

git clone https://github.com/reasonkit/reasonkit-core
cd reasonkit-core
cargo build --release

Set Up Your LLM Provider

ReasonKit needs an LLM to power its reasoning. Set your API key:

# Anthropic Claude (Recommended)
export ANTHROPIC_API_KEY="your-key-here"

# Or OpenAI
export OPENAI_API_KEY="your-key-here"

# Or use OpenRouter for 300+ models
export OPENROUTER_API_KEY="your-key-here"

Your First Analysis

# Ask a simple question
rk-core think "Should I buy this $200 gadget?"

# Use a specific profile
rk-core think "Should I take this job offer?" --profile balanced

# See the difference ReasonKit makes
rk-compare "Is renting really throwing money away?" --profile balanced

Understanding the Output

ReasonKit shows structured analysis:

╔══════════════════════════════════════════════════════════════╗
║  GIGATHINK: Exploring Perspectives                           ║
╠══════════════════════════════════════════════════════════════╣
│  1. FINANCIAL: What's the total comp? 401k match? Equity?   │
│  2. CAREER: Where do people go after 2-3 years?             │
│  3. MANAGER: Your manager = 80% of job satisfaction         │
│  ...                                                         │
╚══════════════════════════════════════════════════════════════╝

╔══════════════════════════════════════════════════════════════╗
║  LASERLOGIC: Checking Reasoning                              ║
╠══════════════════════════════════════════════════════════════╣
│  ASSUMPTION DETECTED: "Higher salary = better"              │
│  HIDDEN VARIABLE: Cost of living in new location            │
│  ...                                                         │
╚══════════════════════════════════════════════════════════════╝

Choosing a Profile

ProfileTimeBest For
--quick~10 secDaily decisions
--balanced~20 secImportant choices
--deep~1 minMajor decisions
--paranoid~2-3 minHigh-stakes, can’t afford to be wrong

Next Steps