Tutorials

Quick-start guides to get you up and running.

---

Getting Started

Your First Loop

15-minute introduction to AI loops. Build a working loop from scratch.

Understanding Verification

Why verification matters and how to implement it.

Setting Up MCP

Configure MCP servers for Claude Desktop.

---

By Tier

Tier 0: Hello World

• Run the Hello World example
• Understand the code

Tier 1: Full Loop

• CLI usage guide
• Task management
• Circuit breakers

Tier 2: Claude Code Skill

• Install the skill
• Using /ralph commands

Tier 3: MCP Server

• Install the server
• Configure in Claude Desktop
• Available resources & tools

---

Quick Reference

Installation

# Clone the repository
git clone https://github.com/fbratten/8me.git
cd 8me

# Set up environment
python -m venv .venv
source .venv/bin/activate
pip install anthropic

# Set API key
export ANTHROPIC_API_KEY="your-key"

Running Each Tier

# Tier 0
cd src/tier0-hello-world
python ralph_hello_world.py

# Tier 1
cd src/tier1-ralph-loop
python ralph_loop.py --help

# Tier 2 (Claude Code)
/ralph add "Your task here"
/ralph

# Tier 3 (MCP Server)
cd src/tier3-mcp-server
pip install -e .
ralph-mcp

---

Start with Your First Loop →

---

Table of contents

• Understanding Verification
• Setting Up MCP
• Tier 0 Quickstart
• Tier 0 Explained
• Tier 1 CLI Usage
• Tier 1 Task Management
• Tier 1 Safety Features
• Tier 2 Install
• Tier 2 Commands
• Tier 3 Install
• Tier 3 Config
• Tier 3 API