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

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 →