Installation
Get ReasonKit’s five ThinkTools for structured AI reasoning:
| Tool | Purpose | Use When |
|---|---|---|
| GigaThink | Expansive thinking, 10+ perspectives | Need creative solutions, brainstorming |
| LaserLogic | Precision reasoning, fallacy detection | Validating arguments, logical analysis |
| BedRock | First principles decomposition | Foundational decisions, axiom building |
| ProofGuard | Multi-source verification | Fact-checking, claim validation |
| BrutalHonesty | Adversarial self-critique | Reality checks, finding flaws |
Quick Install
Universal One-Liner (All Platforms)
Works on: Linux, macOS, Windows (WSL), FreeBSD
curl -fsSL https://get.reasonkit.sh | bash
The installer automatically:
- ✅ Detects your platform (Linux/macOS/Windows/WSL)
- ✅ Detects your shell (Bash/Zsh/Fish/Nu/PowerShell/Elvish)
- ✅ Chooses optimal installation path
- ✅ Configures PATH for your shell
- ✅ Installs Rust if needed
- ✅ Provides beautiful progress visualization
Windows (Native PowerShell)
irm https://get.reasonkit.sh/windows | iex
Shell-Specific Installation
The installer supports all major shells:
| Shell | Detection | PATH Setup | Completion |
|---|---|---|---|
| Bash | ✅ Auto | ✅ Auto | ✅ Available |
| Zsh | ✅ Auto | ✅ Auto | ✅ Available |
| Fish | ✅ Auto | ✅ Auto | ✅ Available |
| Nu (Nushell) | ✅ Auto | ✅ Auto | ⚠️ Manual |
| PowerShell | ✅ Auto | ✅ Auto | ⚠️ Manual |
| Elvish | ✅ Auto | ✅ Auto | ⚠️ Manual |
| tcsh/csh | ✅ Auto | ✅ Auto | ❌ None |
| ksh | ✅ Auto | ✅ Auto | ❌ None |
Prerequisites
- Git (for building from source)
- Rust 1.70+ (auto-installed if missing)
- An LLM API key (Anthropic, OpenAI, OpenRouter, or local Ollama)
Installation Methods
One-Liner (Recommended)
The installer auto-detects your OS and architecture:
# Linux/macOS
curl -fsSL https://get.reasonkit.sh | bash
# Windows PowerShell
irm https://get.reasonkit.sh/windows | iex
This will:
- Detect your platform (Linux/macOS/Windows/WSL/FreeBSD)
- Detect your shell (Bash/Zsh/Fish/Nu/PowerShell/Elvish)
- Install Rust if not present (via rustup)
- Build ReasonKit with beautiful progress visualization
- Configure PATH automatically for your shell
- Verify installation and show quick start guide
Installation paths:
- macOS:
~/bin(or Homebrew path if available) - Linux:
~/.local/bin - Windows (WSL):
~/.local/bin(works with Windows PATH integration) - Windows (Native):
%LOCALAPPDATA%\ReasonKit\bin
Cargo
For Rust developers:
cargo install reasonkit-core
From Source
For development or customization:
git clone https://github.com/reasonkit/reasonkit-core
cd reasonkit-core
cargo build --release
./target/release/rk --help
Verify Installation
rk --version
# reasonkit-core 0.1.5
rk --help
LLM Provider Setup
ReasonKit requires an LLM provider. Choose one:
Anthropic Claude (Recommended)
Best quality reasoning:
export ANTHROPIC_API_KEY="sk-ant-..."
OpenAI
export OPENAI_API_KEY="sk-..."
OpenRouter (300+ Models)
Access to many models through one API:
export OPENROUTER_API_KEY="sk-or-..."
# Specify a model
rk think "question" --model anthropic/claude-3-opus
Google Gemini
export GOOGLE_API_KEY="..."
Groq (Fast Inference)
export GROQ_API_KEY="..."
Local Models (Ollama)
For privacy-sensitive use cases:
ollama serve
rk think "question" --provider ollama --model llama3
Quick Test
Try each ThinkTool:
# GigaThink - Get 10+ perspectives
rk think "Should I start a business?" --tool gigathink
# LaserLogic - Check reasoning
rk think "This investment guarantees 50% returns" --tool laserlogic
# BedRock - Find first principles
rk think "What makes a good leader?" --tool bedrock
# ProofGuard - Verify claims
rk think "Coffee causes cancer" --tool proofguard
# BrutalHonesty - Reality check
rk think "My startup idea is perfect" --tool brutalhonesty
Configuration File
Create ~/.config/reasonkit/config.toml:
[default]
provider = "anthropic"
model = "claude-3-sonnet-20240229"
profile = "balanced"
[providers.anthropic]
api_key_env = "ANTHROPIC_API_KEY"
[providers.openai]
api_key_env = "OPENAI_API_KEY"
model = "gpt-4-turbo-preview"
[output]
format = "pretty"
color = true
Docker
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
ghcr.io/reasonkit/reasonkit-core \
think "Should I buy a house?"
Troubleshooting
“API key not found”
Make sure your API key is exported:
echo $ANTHROPIC_API_KEY # Should print your key
“Rate limited”
Use a different provider or wait. Consider OpenRouter for high volume.
“Model not available”
Check that your provider supports the requested model:
rk models list # Show available models
Next Steps
- Your First Analysis - Run your first ThinkTool
- Configuration - Customize behavior
- ThinkTools Overview - Deep dive into each tool