Vapora/docs/src/intro.md

Welcome to VAPORA Documentation

VAPORA is an intelligent development orchestration platform built entirely in Rust. It combines multi-agent coordination, cost-aware LLM routing, and knowledge graph learning to automate complex development workflows.

Quick Links

• Getting Started — New to VAPORA? Start here
• Quickstart Guide — Get up and running in minutes
• Examples & Tutorials — Learn through practical examples
• Architecture — Understand the design

Core Features

🤖 Learning-Based Agent Orchestration

• Multi-agent coordination with learning profiles
• Per-task-type expertise tracking from execution history
• Recency bias: recent 7 days weighted 3× higher
• Confidence scoring prevents overfitting on small samples

💰 Cost-Aware LLM Routing

• Multi-provider support: Claude, OpenAI, Gemini, Ollama
• Per-role budget enforcement (monthly/weekly limits)
• Three-tier enforcement: normal → caution → exceeded
• Automatic fallback to cheaper providers under budget pressure

📊 Knowledge Graph

• Temporal execution history with causal relationships
• Learning curves computed from daily aggregations
• Semantic similarity search for solution recommendations
• Pattern matching for problem solving

🐝 Swarm Coordination

• Agent registration with capability-based filtering
• Load-balanced task assignment
• Prometheus metrics for real-time monitoring
• NATS JetStream optional (graceful fallback)

🔌 Full-Stack Rust

• Backend: Axum REST API (40+ endpoints)
• Frontend: Leptos WASM UI (Kanban board, glassmorphism)
• Database: SurrealDB multi-tenant persistence
• Async: Tokio runtime for high-performance I/O

Platform Architecture

User UI (Leptos WASM)
    ↓
REST API (Axum, 40+ endpoints)
    ↓
SurrealDB (Multi-tenant scopes)
    ↓
Agent Job Queue (NATS JetStream)
    ↓
Agent Runtime
    ↓
LLM Router (Multi-provider)
    ↓
Provider APIs + MCP Gateway

Documentation Structure

• Setup & Deployment — Installation and configuration
• Features — Platform capabilities
• Architecture — Design and patterns
• ADRs — Architecture decision records
• Integrations — Integration guides
• Operations — Runbooks and procedures
• Disaster Recovery — Recovery procedures

Learning Paths

30 minutes: Quick Overview

1. Getting Started
2. Quick Start
3. Platform Capabilities

90 minutes: System Integration

1. Setup & Deployment
2. Multi-Agent Workflows
3. LLM Routing Examples
4. Learning Profiles

2-3 hours: Production Ready

1. Complete Architecture
2. All Integration Guides
3. Operations Runbooks
4. Disaster Recovery Procedures

Key Resources

Resource	Purpose
Architecture	Understand system design and components
ADRs	Learn decision rationale for each component
Examples	Copy working code patterns
Runbooks	Handle operational scenarios
Integration Guides	Connect with external systems

Community & Support

• Repository: github.com/vapora-platform/vapora
• Issues: Report bugs and request features
• Discussions: Ask questions and share ideas

---

Platform Version: 1.2.0 (Production Ready) Documentation Version: 1.2.0 Last Updated: 2026-01-12