chore: fix content
This commit is contained in:
Jesús Pérez
parent
46ea1b03a4
commit
d89a2bc26f
187
README.md
187
README.md
@ -2,15 +2,17 @@
|
|||||||
|
|
||||||
<img src="imgs/vapora.svg" alt="Vapora Logo" width="400">
|
<img src="imgs/vapora.svg" alt="Vapora Logo" width="400">
|
||||||
|
|
||||||
- 🌊 Cloud-native project management with AI agents
|
* 🌊 Intelligent Development Orchestration Platform
|
||||||
- 🎯 Kanban workflows with glassmorphism UI
|
* 🎯 Specialized agents orchestrate pipelines for your team
|
||||||
- 🤖 Unified agent runtime powered by MCP
|
* 🤖 Multi-IA router (Claude, OpenAI, Gemini, Ollama)
|
||||||
- ⚡ Built with Rust from backend to frontend
|
* ⚡ Built with Rust from backend to frontend
|
||||||
|
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[](https://www.rust-lang.org)
|
[](https://www.rust-lang.org)
|
||||||
[](https://kubernetes.io)
|
[](https://kubernetes.io)
|
||||||
[](https://istio.io)
|
[](https://istio.io)
|
||||||
|
[](PROJECT_COMPLETION_REPORT.md)
|
||||||
|
[](.coder/summaries/fase-5-deployment.md)
|
||||||
|
|
||||||
[Features](#-features) • [Quick Start](#-quick-start) • [Architecture](#-architecture) • [Docs](docs/) • [Contributing](#-contributing)
|
[Features](#-features) • [Quick Start](#-quick-start) • [Architecture](#-architecture) • [Docs](docs/) • [Contributing](#-contributing)
|
||||||
|
|
||||||
@ -27,19 +29,29 @@
|
|||||||
Where ideas vaporize into reality
|
Where ideas vaporize into reality
|
||||||
```
|
```
|
||||||
|
|
||||||
## 🌟 What is Vapora?
|
## 🌟 What is Vapora v2.0?
|
||||||
|
|
||||||
**Vapora** is a next-generation project management platform that combines elegant Kanban workflows with intelligent AI agents. Built entirely in Rust, it offers a cloud-native
|
**VAPORA** is an **intelligent development orchestration platform** where teams and AI agents collaborate seamlessly to solve the 4 critical problems in parallel:
|
||||||
architecture designed for teams that demand both beauty and performance.
|
|
||||||
|
- ✅ **Context Switching** (Developers unified in one system instead of jumping between tools)
|
||||||
|
- ✅ **Knowledge Fragmentation** (Team decisions, code, and docs discoverable with RAG)
|
||||||
|
- ✅ **Manual Coordination** (Specialized agents orchestrate pipelines automatically)
|
||||||
|
- ✅ **Dev-Ops Friction** (Unified visibility from code changes through deployment)
|
||||||
|
|
||||||
|
Additional capabilities:
|
||||||
|
- 🤖 **Specialized agents** (Architect, Developer, Reviewer, Tester, Documenter, Marketer, Presenter, DevOps, Monitor, Security, ProjectManager, DecisionMaker - customizable & extensible)
|
||||||
|
- 🧠 **Multi-IA intelligent routing** (Claude, OpenAI, Gemini, Ollama selected per task)
|
||||||
|
- ☁️ **Self-hosted on Kubernetes** (no SaaS, complete control, Provisioning-based deployment)
|
||||||
|
|
||||||
### Key Highlights
|
### Key Highlights
|
||||||
|
|
||||||
- **🎨 Tron-Inspired UI**: Glassmorphism design with vaporwave aesthetics powered by UnoCSS
|
- **🎨 Glassmorphism UI**: Vaporwave aesthetics with UnoCSS, Leptos reactive WASM
|
||||||
- **🤖 AI-First**: Unified agent runtime using Model Context Protocol (MCP)
|
- **🤖 Specialized Agent Orchestration**: NATS JetStream coordination, parallel pipeline execution with approval gates
|
||||||
- **🚀 Full-Stack Rust**: From frontend (Leptos WASM) to backend (Axum) to infrastructure
|
- **🧠 Multi-IA Router**: Hybrid routing (rules + dynamic + manual override) for optimal LLM per task
|
||||||
- **☁️ Cloud-Agnostic**: Runs on any Kubernetes cluster with Istio service mesh
|
- **🚀 Full-Stack Rust**: Frontend (Leptos), Backend (Axum), Agents, Infrastructure
|
||||||
- **🔌 Extensible**: Plugin system for custom agents and integrations
|
- **☁️ K8s Native**: Istio service mesh, Rook Ceph storage, Cedar policy engine RBAC
|
||||||
- **🔒 Multi-Tenant**: Enterprise-grade isolation with namespace-level security
|
- **📚 RAG Integration**: Semantic search over Vapora docs, guides, code, and project materials
|
||||||
|
- **🔒 Multi-Tenant**: SurrealDB scope isolation, fine-grained Cedar policies, complete audit trails
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -52,15 +64,29 @@
|
|||||||
- **Smart Organization**: Feature tags, priority levels, task ordering
|
- **Smart Organization**: Feature tags, priority levels, task ordering
|
||||||
- **Responsive Design**: Works seamlessly from mobile to ultra-wide displays
|
- **Responsive Design**: Works seamlessly from mobile to ultra-wide displays
|
||||||
|
|
||||||
### 🤖 AI Agent Runtime
|
### 🤖 Specialized AI Agents (Customizable & Extensible)
|
||||||
|
|
||||||
- **MCP Gateway Integration**: Unified interface for OpenAI, Claude, and custom agents
|
Select, tune, or extend agents for your pipeline orchestration needs. Default agents include:
|
||||||
- **Plugin Architecture**: Extend functionality with MCP-compatible plugins
|
|
||||||
- **Built-in Capabilities**:
|
**Parallel Agent Coordination**:
|
||||||
- 🔍 **Code Analysis**: Tree-sitter parsing + LLM semantic review
|
- 🏗️ **Architect** (Claude Opus): System design & ADRs
|
||||||
- 📚 **RAG Search**: Semantic search over knowledge base with local embeddings
|
- 💻 **Developer** (Claude Sonnet): Code implementation [scales 5-20]
|
||||||
- 📝 **Doc Generation**: Auto-generate technical documentation from code
|
- 👀 **CodeReviewer** (Claude Sonnet): Quality assurance & CR
|
||||||
- ⚙️ **Task Execution**: Automate GitHub PRs, Jira updates, webhooks
|
- 🧪 **Tester** (Claude Sonnet): Tests & benchmarks
|
||||||
|
- 📚 **Documenter** (GPT-4): Docs & root files
|
||||||
|
- 📢 **Marketer** (Claude Sonnet): Marketing content
|
||||||
|
- 🎤 **Presenter** (Claude Sonnet): Presentations & slides
|
||||||
|
- ⚙️ **DevOps** (Claude Sonnet): CI/CD & deployment
|
||||||
|
- 👁️ **Monitor** (Gemini Flash): Health & alerting [real-time]
|
||||||
|
- 🔒 **Security** (Claude Opus): Audit & compliance [can block]
|
||||||
|
- 📊 **ProjectManager** (Claude Sonnet): Roadmap & tracking
|
||||||
|
- 🎯 **DecisionMaker** (Claude Opus): Conflict resolution
|
||||||
|
|
||||||
|
**Multi-IA Router**: Transparent LLM selection per task context
|
||||||
|
- ✅ Automatic selection based on task complexity/latency/cost
|
||||||
|
- ✅ Manual override capability with audit logging
|
||||||
|
- ✅ Fallback chains (e.g., Claude Opus → GPT-4 → Claude Sonnet)
|
||||||
|
- ✅ Cost tracking & budget alerts per agent role
|
||||||
|
|
||||||
### 🏗️ Infrastructure
|
### 🏗️ Infrastructure
|
||||||
|
|
||||||
@ -84,6 +110,7 @@
|
|||||||
SurrealDB Multi-model database with scopes
|
SurrealDB Multi-model database with scopes
|
||||||
NATS JetStream Message queue for agent jobs
|
NATS JetStream Message queue for agent jobs
|
||||||
Rig AI agent framework
|
Rig AI agent framework
|
||||||
|
fastembed Local embeddings for RAG
|
||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
### Frontend
|
### Frontend
|
||||||
@ -107,14 +134,18 @@
|
|||||||
Gitea Self-hosted Git
|
Gitea Self-hosted Git
|
||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
### Agents
|
### Agents & LLM
|
||||||
|
|
||||||
<pre>
|
<pre>
|
||||||
MCP Gateway Docker MCP gateway for unified agents
|
Rig LLM agent framework with tool calling
|
||||||
OpenAI AgentKit OpenAI agent integration
|
fastembed Local embeddings for semantic search (RAG)
|
||||||
Claude Agent SDK Anthropic Claude integration
|
NATS JetStream Message queue for async agent coordination
|
||||||
fastembed Local embeddings (privacy-first)
|
Cedar Policy engine for fine-grained RBAC
|
||||||
tree-sitter Code parsing
|
MCP Gateway Model Context Protocol plugin system
|
||||||
|
Claude API Anthropic Claude (Opus, Sonnet, Haiku)
|
||||||
|
OpenAI API GPT-4, GPT-4o, GPT-3.5-turbo
|
||||||
|
Gemini API Google Gemini (2.0 Pro, Flash, 1.5 Pro)
|
||||||
|
Ollama Local LLMs (Llama 2, Mistral, etc.)
|
||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
---
|
---
|
||||||
@ -165,6 +196,25 @@
|
|||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Production Deployment (Kubernetes)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Build and push Docker images
|
||||||
|
nu scripts/build-docker.nu --registry docker.io --tag v0.2.0 --push
|
||||||
|
|
||||||
|
# Update secrets
|
||||||
|
edit kubernetes/03-secrets.yaml # Add your API keys
|
||||||
|
|
||||||
|
# Deploy to Kubernetes
|
||||||
|
nu scripts/deploy-k8s.nu
|
||||||
|
|
||||||
|
# Or use Provisioning (advanced)
|
||||||
|
cd provisioning/vapora-wrksp
|
||||||
|
provisioning workflow run workflows/deploy-full-stack.yaml
|
||||||
|
```
|
||||||
|
|
||||||
|
**See full deployment guide**: [`DEPLOYMENT.md`](DEPLOYMENT.md)
|
||||||
|
|
||||||
---
|
---
|
||||||
🏗️ Architecture
|
🏗️ Architecture
|
||||||
|
|
||||||
@ -261,10 +311,10 @@
|
|||||||
│ │
|
│ │
|
||||||
│ ┌──────────────────────────────────────────┐ │
|
│ ┌──────────────────────────────────────────┐ │
|
||||||
│ │ 📚 RAG Search Plugin │ │
|
│ │ 📚 RAG Search Plugin │ │
|
||||||
│ │ Semantic search over knowledge base │ │
|
│ │ Semantic search over Vapora docs & code │ │
|
||||||
│ │ • Local embeddings (fastembed) │ │
|
│ │ • Local embeddings (fastembed) │ │
|
||||||
│ │ • Top-k retrieval │ │
|
│ │ • Indexes: guides/, FEATURES, .coder/ │ │
|
||||||
│ │ [Install] │ │
|
│ │ [✓ Installed] │ │
|
||||||
│ └──────────────────────────────────────────┘ │
|
│ └──────────────────────────────────────────┘ │
|
||||||
└─────────────────────────────────────────────────────────┘
|
└─────────────────────────────────────────────────────────┘
|
||||||
|
|
||||||
@ -340,22 +390,38 @@
|
|||||||
See docs/mcp-plugins.md for full guide.
|
See docs/mcp-plugins.md for full guide.
|
||||||
|
|
||||||
---
|
---
|
||||||
🚢 Deployment
|
🚢 Deployment with Provisioning
|
||||||
|
|
||||||
Kubernetes (Production)
|
Using Provisioning (not Helm) for declarative K8s infrastructure:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Setup cluster with Istio + Rook Ceph
|
# Navigate to Provisioning workspace
|
||||||
./scripts/setup-cluster.sh
|
cd provisioning/vapora-wrksp
|
||||||
|
|
||||||
# Deploy platform services (Vault, Gitea, Zot, etc.)
|
# Deploy full VAPORA stack (KCL + Taskservs + Workflows)
|
||||||
./scripts/deploy-platform.sh
|
provisioning workflow run workflows/deploy-full-stack.yaml
|
||||||
|
|
||||||
# Deploy Vapora application
|
# This creates:
|
||||||
kubectl apply -k kubernetes/overlays/production
|
# - K8s cluster (K3s/RKE2) with Cilium CNI
|
||||||
|
# - Istio service mesh with mTLS
|
||||||
|
# - Rook Ceph storage
|
||||||
|
# - SurrealDB (3 replicas, 50Gi storage)
|
||||||
|
# - Redis (3 replicas, 20Gi storage)
|
||||||
|
# - NATS JetStream (3 replicas, 30Gi storage)
|
||||||
|
# - Axum backend (3-10 replicas)
|
||||||
|
# - Leptos frontend (2 replicas)
|
||||||
|
# - Agent runtime (3-50 replicas, HPA enabled)
|
||||||
|
# - LLM Router (2-5 replicas)
|
||||||
|
# - MCP Gateway (2-5 replicas)
|
||||||
|
|
||||||
# Create a tenant
|
# Access UI
|
||||||
./scripts/create-tenant.sh acme
|
open https://vapora.example.com
|
||||||
|
|
||||||
|
# Scale developer agents
|
||||||
|
provisioning taskserv scale vapora-agents --agent developer --replicas 15
|
||||||
|
|
||||||
|
# Monitor health
|
||||||
|
provisioning health-check --services all
|
||||||
|
|
||||||
Environment Variables
|
Environment Variables
|
||||||
|
|
||||||
@ -406,6 +472,47 @@
|
|||||||
- Istio Service Mesh: Traffic flows, mTLS status
|
- Istio Service Mesh: Traffic flows, mTLS status
|
||||||
- Ceph Storage: Capacity, IOPS, health
|
- Ceph Storage: Capacity, IOPS, health
|
||||||
|
|
||||||
|
---
|
||||||
|
📚 Documentation & Specifications
|
||||||
|
|
||||||
|
VAPORA v2.0 is built on comprehensive specifications organized by domain:
|
||||||
|
|
||||||
|
**Core Specifications** (guides/core/):
|
||||||
|
- **VAPORA-ARCHITECTURE-V2.md**: 4-layer architecture (Frontend, API, Service, Data, Infrastructure)
|
||||||
|
- **AGENT-REGISTRY-COORDINATION.md**: 12 agent roles, NATS message patterns, health checking
|
||||||
|
- **MULTI-IA-ROUTER.md**: Hybrid routing system (rules + dynamic + override), cost tracking
|
||||||
|
- **MULTI-AGENT-WORKFLOWS.md**: End-to-end workflows with parallel execution & approval gates
|
||||||
|
- **ROLES-PERMISSIONS-PROFILES.md**: Cedar policy engine, team profiles, fine-grained RBAC
|
||||||
|
- **TASK-AGENT-DOC-MANAGER-V2.md**: Multi-agent task orchestration & decision extraction
|
||||||
|
|
||||||
|
**Integration Specifications** (guides/integration/):
|
||||||
|
- **DOC-LIFECYCLE-INTEGRATION.md**: Dual-mode (plugin + standalone) documentation management
|
||||||
|
- **PROVISIONING-INTEGRATION.md**: KCL schemas, taskservs, workflows for K8s deployment
|
||||||
|
- **RAG-INTEGRATION.md**: Semantic search with hybrid retrieval & embedding strategy
|
||||||
|
|
||||||
|
**Component Specifications** (guides/):
|
||||||
|
- **SESSION-LIFECYCLE-MANAGER.md**: .coder/ organization, metadata extraction, decision capture
|
||||||
|
- **ROOT-FILES-KEEPER.md**: Keep README, CHANGELOG, ROADMAP always updated
|
||||||
|
- **MIGRATION-PLAN.md**: Gradual migration path for existing projects
|
||||||
|
|
||||||
|
**Deployment Guide** (provisioning/vapora-wrksp/):
|
||||||
|
- workspace.toml: Master configuration (agents, LLM, monitoring, backup)
|
||||||
|
- taskservs/: Service definitions for backend, frontend, agents, LLM router, MCP gateway
|
||||||
|
- kcl/: Infrastructure as Code schemas (cluster, services, storage, agents, multi-ia)
|
||||||
|
- workflows/: Batch operations (deploy, scale, upgrade, disaster-recovery)
|
||||||
|
- README.md: Quick start and operation guide
|
||||||
|
|
||||||
|
**Implementation Roadmap**:
|
||||||
|
- Phase 1 (Weeks 1-4): Foundation (Axum backend, SurrealDB, JWT auth, Leptos frontend)
|
||||||
|
- Phase 2 (Weeks 5-8): Agents (Registry, NATS, 12 agent implementations)
|
||||||
|
- Phase 3 (Weeks 9-10): Multi-IA (LLM Router, cost tracking, fallback logic)
|
||||||
|
- Phase 4 (Weeks 11-13): Workflows (Orchestrator, parallel execution, dashboard)
|
||||||
|
- Phase 5 (Weeks 14-16): K8s & Provisioning (KCL, taskservs, CI/CD)
|
||||||
|
|
||||||
|
**References**:
|
||||||
|
- CLAUDE.md: Complete project overview with version history
|
||||||
|
- guides/archive/v1-single-agent/: Legacy v1.0 specifications for historical reference
|
||||||
|
|
||||||
---
|
---
|
||||||
🤝 Contributing
|
🤝 Contributing
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user