Vapora/docs/tutorials/README.md

# 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](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](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](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](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](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](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](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](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](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](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 →