Quick Start
Get ReasonKit running in 30 seconds.
Installation
One-Liner (Recommended)
# 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
| Profile | Time | Best For |
|---|---|---|
--quick | ~10 sec | Daily decisions |
--balanced | ~20 sec | Important choices |
--deep | ~1 min | Major decisions |
--paranoid | ~2-3 min | High-stakes, can’t afford to be wrong |
Next Steps
- Installation — Detailed installation options
- Your First Analysis — Walk through a real example
- ThinkTools Overview — Understand each tool