## 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

# VAPORA Tutorials

Step-by-step guides to learn VAPORA from basics to advanced workflows.

## Learning Path

Follow these tutorials in order to build comprehensive understanding:

### 1. Getting Started (15 min)

- Build VAPORA from source
- Start backend and frontend services
- Run first agent
- Verify complete stack is operational

Start here: 01-getting-started.md

### 2. Basic Agents (20 min)

- Create an agent registry
- Register agents with capabilities
- Execute simple agent tasks
- Understanding agent metadata

Prerequisites: Complete Getting Started

Start here: 02-basic-agents.md

### 3. LLM Routing (25 min)

- Configure multiple LLM providers
- Route requests to optimal providers
- Understand provider selection logic
- Cost comparison

Prerequisites: Complete Basic Agents

Start here: 03-llm-routing.md

### 4. Learning Profiles (30 min)

- Build expertise profiles from execution history
- Understand recency bias
- Confidence scoring
- Agent improvement over time

Prerequisites: Complete LLM Routing

Start here: 04-learning-profiles.md

### 5. Budget Management (25 min)

- Set per-role budget limits
- Track spending
- Enforce budget tiers
- Automatic fallback to cheaper providers

Prerequisites: Complete Learning Profiles

Start here: 05-budget-management.md

### 6. Swarm Coordination (30 min)

- Register agents in swarm
- Assign tasks with load balancing
- Understand scoring algorithm
- Multi-agent workflows

Prerequisites: Complete Budget Management

Start here: 06-swarm-coordination.md

### 7. Knowledge Graph (25 min)

- Record execution history
- Query similar past tasks
- Generate learning curves
- Recommendation system

Prerequisites: Complete Swarm Coordination

Start here: 07-knowledge-graph.md

### 8. REST API (30 min)

- Create projects and tasks via API
- Manage agents through API
- Real-time WebSocket updates
- Error handling

Prerequisites: Complete Knowledge Graph

Start here: 08-rest-api.md

### 9. Frontend Integration (20 min)

- Leptos UI components
- Connect frontend to backend
- Real-time task updates
- Kanban board usage

Prerequisites: Complete REST API

Start here: 09-frontend-integration.md

### 10. Production Deployment (30 min)

- Kubernetes deployment
- Monitoring with Prometheus
- Scaling agents horizontally
- Production best practices

Prerequisites: Complete Frontend Integration

Start here: 10-production-deployment.md

## Total Learning Time

- Estimated: ~4 hours for complete learning path
- Can be completed individually
- Each tutorial is self-contained with examples

## Quick Reference

### By Topic

Agent Management

- Tutorial 2: Basic Agents
- Tutorial 4: Learning Profiles
- Tutorial 6: Swarm Coordination

LLM & Costs

- Tutorial 3: LLM Routing
- Tutorial 5: Budget Management

Data & Persistence

- Tutorial 7: Knowledge Graph
- Tutorial 8: REST API

User Interfaces

- Tutorial 9: Frontend Integration
- Tutorial 10: Production Deployment

### By Complexity

Beginner (Tutorials 1-3)

- Get VAPORA running
- Understand components
- First agent execution

Intermediate (Tutorials 4-7)

- Multi-agent workflows
- Cost control
- Learning & optimization

Advanced (Tutorials 8-10)

- Full-stack integration
- Production deployment
- Monitoring & scaling

## Examples Directory

For code examples, see `examples/`:

- Basic examples - `crates/*/examples/01-*.rs`
- Intermediate - `crates/*/examples/0[2-3]-*.rs`
- Full-stack - `examples/full-stack/`

Each tutorial references relevant examples you can run.

## Hands-On Practice

Each tutorial includes:

- Prerequisites checklist
- Step-by-step instructions
- Code examples (from examples/ directory)
- Expected output
- Common troubleshooting
- Next steps

## Getting Help

- Check Troubleshooting section in each tutorial
- Review example code in `examples/`
- Run examples with `--verbose` flag
- Check logs: `RUST_LOG=debug cargo run`

## Feedback

Found an issue? Want to suggest improvements?

- Report issues: https://github.com/anthropics/claude-code/issues
- Reference: "VAPORA Tutorial: [number] - [title]"

Estimated completion time: 4 hours

Current progress: Pick a tutorial to start →