Quick Start (5 Minutes)

Get ReasonKit running and perform your first verifiable analysis in under 5 minutes.

1. Install ReasonKit (30 Seconds)

Open your terminal and run the installer for your operating system.

Linux / macOS

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

Windows (PowerShell)

irm https://get.reasonkit.sh/windows | iex

Verify installation by running rk --version. You should see rk v1.0.0.

2. Connect Your “Brain” (1 Minute)

ReasonKit requires an LLM provider to power its reasoning. We recommend Anthropic Claude for the best logic performance.

# Add this to your ~/.bashrc or ~/.zshrc to keep it permanent
export ANTHROPIC_API_KEY="sk-ant-..."

(Alternatively, set OPENAI_API_KEY for GPT-4o models.)

3. Your First Analysis (2 Minutes)

Let’s test ReasonKit’s ability to think critically about a daily decision.

rk think "Should I invest $5,000 in a Bitcoin mining rig today?" --profile balanced

What to Expect:

You will see ReasonKit’s “Glass Box” in action. Instead of a single paragraph, you’ll see the engine cycling through:

1. GigaThink: Exploring hardware costs, electricity, and hash rates.
2. LaserLogic: Checking if your “break-even” math actually adds up.
3. BrutalHonesty: Challenging the assumption that Bitcoin prices will stay high.

4. Try Different “Depth” (1 Minute)

ReasonKit adapts its thinking time based on the Profile you choose.

5. Next Steps

• Integrate: Add ReasonKit to your LangChain workflows.
• Customize: Create your first Custom ThinkTool.
• Audit: View your full Reasoning Traces in JSON.

Need Help? Join our GitHub Discussions or check the Troubleshooting Guide.