{"id":31029037,"url":"https://github.com/ruvnet/flow-nexus","last_synced_at":"2025-09-13T21:58:18.736Z","repository":{"id":311663483,"uuid":"1044433672","full_name":"ruvnet/flow-nexus","owner":"ruvnet","description":"Flow Nexus is the first competitive agentic platform built entirely on MCP. Deploy autonomous AI swarms, train   neural networks, and compete in coding challenges while earning rUv credits. Transform agentic engineering mastery into lived experience through gamified cloud development where agents spawn agents and systems improve themselves","archived":false,"fork":false,"pushed_at":"2025-09-10T22:44:36.000Z","size":538,"stargazers_count":24,"open_issues_count":14,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-11T01:13:16.739Z","etag":null,"topics":["agentic","agentic-workflow","ai","ai-agents","neural-networks","swarm-intelligence"],"latest_commit_sha":null,"homepage":"https://flow-nexus.ruv.io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ruvnet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-25T17:16:01.000Z","updated_at":"2025-09-10T23:52:01.000Z","dependencies_parsed_at":"2025-08-25T21:31:01.446Z","dependency_job_id":"a79f23bd-f052-4e80-bbd3-a3c5b145784c","html_url":"https://github.com/ruvnet/flow-nexus","commit_stats":null,"previous_names":["ruvnet/flow-nexus"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ruvnet/flow-nexus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fflow-nexus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fflow-nexus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fflow-nexus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fflow-nexus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ruvnet","download_url":"https://codeload.github.com/ruvnet/flow-nexus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fflow-nexus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274847016,"owners_count":25360976,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-12T02:00:09.324Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic","agentic-workflow","ai","ai-agents","neural-networks","swarm-intelligence"],"created_at":"2025-09-13T21:58:17.214Z","updated_at":"2025-09-13T21:58:18.725Z","avatar_url":"https://github.com/ruvnet.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Flow Nexus: Your Path to Digital Immortality\n\n\u003cdiv align=\"center\"\u003e\n\n## 🌐 [flow-nexus.ruv.io](https://flow-nexus.ruv.io) \n\n![Flow Nexus](https://img.shields.io/badge/version-0.1.111-blue?style=for-the-badge)\n![MCP](https://img.shields.io/badge/MCP-Compatible-green?style=for-the-badge)\n![NPM](https://img.shields.io/badge/npm-flow--nexus-red?style=for-the-badge)\n![NPM Downloads](https://img.shields.io/npm/dt/flow-nexus?style=for-the-badge\u0026label=downloads)\n![AI Agents](https://img.shields.io/badge/AI%20Agents-100%2B-purple?style=for-the-badge)\n\n### **The First Competitive Agentic System**\n\n```bash\nnpx flow-nexus\n```\n### 🎁 **New User Bonus**: 256 rUv credits to start! \n**✨ Free Start** • **🎮 Gamified Experience** • **🚀 Instant Deploy** • **♾️ Autonomous Operation**\n\n\u003c/div\u003e\n\n\n---\n\n## 📖 Introduction\n\n**Flow Nexus: The first competitive agentic system that merges cloud elasticity with autonomous intelligence.**\n\nAgentic engineering is both a science to be mastered and an art to be practiced. Flow Nexus transforms that mastery into a lived experience: not just theory, but a challenge system where you learn by building, testing, and proving yourself in real-time. It feels less like documentation, more like a game; a path toward becoming a learned master of agents.\n\nUsing Claude Code/Desktop, OpenAI Codex, Cursor, GitHub Copilot, and other MCP-enabled tools, deploy autonomous agent swarms into cloud-hosted agentic sandboxes. Build, compete, and monetize your creations in the ultimate agentic playground. Earn rUv credits through epic code battles and algorithmic supremacy.\n\nFlow Nexus combines the proven economics of cloud computing (pay-as-you-go, scale-on-demand) with the power of autonomous agent coordination. As the first agentic platform built entirely on the MCP (Model Context Protocol) standard, it delivers a unified interface where your IDE, agents, and infrastructure all speak the same language—enabling recursive intelligence where agents spawn agents, sandboxes create sandboxes, and systems improve themselves. The platform operates with the engagement of a game and the reliability of a utility service.\n\n### How It Works\n\nFlow Nexus orchestrates three interconnected MCP servers to create a complete AI development ecosystem:\n- **Autonomous Agents**: Deploy swarms that work 24/7 without human intervention\n- **Agentic Sandboxes**: Secure, isolated environments that spin up in seconds\n- **Neural Processing**: Distributed machine learning across cloud infrastructure\n- **Workflow Automation**: Event-driven pipelines with built-in verification\n- **Economic Engine**: Credit-based system that rewards contribution and usage\n\n\n### 🚀 **Quick Start with Flow Nexus**\n\n```bash\n# 1. Initialize Flow Nexus only (minimal setup)\nnpx claude-flow@alpha init --force\n\n# 2. Register and login (use MCP tools in Claude Code) \n# Via command line: \nnpx flow-nexus@latest auth register -e pilot@ruv.io -p password\n\n# Via MCP\nmcp__flow-nexus__user_register({ email: \"your@email.com\", password: \"secure\" })\nmcp__flow-nexus__user_login({ email: \"your@email.com\", password: \"secure\" })\n\n# 3. Deploy your first cloud swarm\nmcp__flow-nexus__swarm_init({ topology: \"mesh\", maxAgents: 5 })\nmcp__flow-nexus__sandbox_create({ template: \"node\", name: \"api-dev\" })\n```\n\n\n\n\n### MCP Setup\n```bash\n# Add Flow Nexus MCP servers to Claude Desktop\nclaude mcp add flow-nexus npx flow-nexus@latest mcp start\nclaude mcp add claude-flow npx claude-flow@alpha mcp start\nclaude mcp add ruv-swarm npx ruv-swarm@latest mcp start\n```\n\n## 🔀 Two Ways to Build\n\n**Choose your path:** Flow Nexus empowers both mission-driven innovators and profit-focused entrepreneurs. Whether you're solving global challenges or building the next unicorn, our platform provides the tools, community, and economic model to succeed.\n\n\u003cdiv align=\"center\"\u003e\n\n| \u003ch2\u003e **🌍 Build for Impact** \u003c/h2\u003e | \u003ch2\u003e **💼 Build for Scale** \u003c/h2\u003e |\n|-------------------------|------------------------|\n| **Make a Difference** | **Make it Profitable** |\n| 🌡️ Climate modeling \u0026 environmental analysis | 💳 Built-in payment infrastructure |\n| 🏥 Healthcare diagnostics \u0026 research tools | 👑 Premium template royalties |\n| 📚 Educational content \u0026 learning systems | 🏆 Tournament prizes \u0026 rewards |\n| 🏅 Verified badges \u0026 recognition | 🤖 Autonomous revenue generation |\n| 💰 Grants \u0026 impact funding opportunities | 📈 Subscription \u0026 usage fees |\n| 🤝 Open-source community contributions | 🚀 Enterprise partnerships |\n\n\u003c/div\u003e\n\n✨ **The beauty of Flow Nexus:** You don't have to choose just one path. Many successful developers combine both approaches, building profitable businesses while making meaningful impact.\n\n---\n\n## 🎯 Platform Features\n\nEverything you need to build, deploy, and scale autonomous AI systems:\n\n\u003cdiv align=\"center\"\u003e\n\n### **Why Agentic Engineers Choose Flow Nexus**\n\n| 🚀 **100+ MCP Tools** | 🎮 **Learn \u0026 Earn** | 🤖 **AI Swarms** | 💰 **Free Credits** | 📚 **Skill Growth** |\n|-------------------|-------------------|------------------|---------------------|-------------------|\n| Complete AI development toolkit | Gamified challenges with rewards | Multi-agent orchestration | 256 credits to start | Hands-on learning paths |\n\n\u003c/div\u003e\n\n\n\n## **Core Capabilities**\n\n| 🧠 **Neural Networks** | 📦 **Sandboxes** | 🔄 **Workflows** | 🎮 **Challenges** |\n|------------------------|------------------|------------------|-------------------|\n| Distributed training | Instant deployment | Event-driven pipelines | Coding tournaments |\n| WASM acceleration | Multiple runtimes | Message queues | Global leaderboards |\n| Pre-built templates | Isolated execution | Parallel tasks | Instant rewards |\n\n| 🏪 **Marketplace** | 📡 **Monitoring** | 🔐 **Enterprise** | 💡 **Integration** |\n|--------------------|-------------------|-------------------|---------------------|\n| Publish \u0026 monetize | Real-time streams | User management | MCP-compatible |\n| Community templates | Performance metrics | Role-based access | REST API |\n| One-click deploy | Health dashboards | Audit trails | NPM package |\n\n\n## 🎯 What Makes Flow Nexus Different\n\n### **It's Not a Tool, It's a Journey**\nWhile others offer AI assistants, Flow Nexus offers a path to mastery. Every line of code you write, every challenge you complete, every swarm you deploy makes you stronger. Your agents learn. Your skills compound. Your reputation grows. This isn't about using AI; it's about becoming an agentic engineer.\n\n### **Competition Drives Innovation**\nTraditional development is solitary. Flow Nexus is gladiatorial. Your code battles against others in real-time. Queen Seraphina, our AI judge, evaluates not just correctness but elegance, efficiency, and innovation. Winners earn credits, climb leaderboards, unlock achievements. Losers learn, adapt, and return stronger. Every deployment is a chance to prove yourself.\n\n### **Agents That Actually Think**\nDeploy swarms that don't just execute commands but reason about problems. They decompose complex tasks, allocate resources, verify their own work, and optimize their performance over time. When a swarm encounters an error, it doesn't just fail; it analyzes, adapts, and tries alternative approaches. This is true autonomy: agents that think before they act.\n\n### **Economic Reality, Not Fantasy**\nEvery action costs credits. Every success earns them. This isn't arbitrary gamification; it mirrors the real economics of cloud computing. Learn to optimize costs while maximizing performance. Build efficient systems that generate revenue. Publish templates that earn royalties. The credits you earn here translate to real engineering wisdom about resource management and system design.\n\n### **Immortality Through Code**\nYour creations live on in the marketplace. Every template you publish, every challenge you design, every neural network you train becomes part of the Flow Nexus DNA. Future engineers will build on your work, learn from your patterns, compete against your benchmarks. This is digital immortality: your engineering philosophy encoded and evolving forever.\n\n## 💎 Core Value Propositions\n\n| 🤖 **Autonomy** | ⚡ **Speed** | 🔐 **Security** | 💰 **Economics** |\n|-----------------|--------------|-----------------|------------------|\n| Self-managing swarms | Instant provisioning | Isolated execution | Pay-per-second |\n| Auto-optimization | \u003c 1 second deploy | Full audit trails | Earn by contributing |\n| 24/7 operation | Parallel scaling | Schema validation | Free tier included |\n\n## ⚡ Technical Capabilities\n\nThe engineering details that power the magic. Flow Nexus delivers enterprise-grade infrastructure wrapped in a competitive gaming experience, where every technical decision impacts your performance, costs, and ranking.\n\n### **Agentic Sandbox Environments**\n\n| Feature | Description |\n|---------|------------|\n| **Runtime Support** | Node.js, Python, React, Next.js, custom containers |\n| **Provisioning Speed** | \u003c 1 second deployment, automatic cleanup |\n| **Security** | Isolated execution, environment variable injection |\n| **Code Execution** | Real-time streaming output, persistent file systems |\n| **Resource Management** | Auto-scaling, quota enforcement, cost optimization |\n\n### **Multi-Agent Swarm Intelligence**\n\n| Component | Options |\n|-----------|---------|\n| **Topologies** | Mesh (peer-to-peer), Star (centralized), Ring (circular), Hierarchical (tree) |\n| **Agent Roles** | Researcher, Coder, Analyst, Optimizer, Coordinator, Tester, Deployer |\n| **Consensus Protocols** | DAA, Byzantine fault tolerance, Raft, Gossip |\n| **Scaling** | Dynamic spawning, cross-swarm communication, load balancing |\n| **Coordination** | Task decomposition, parallel execution, dependency management |\n\n### **Neural Network Infrastructure**\n\n| Capability | Implementation |\n|------------|----------------|\n| **Distributed Training** | Multi-node training across sandbox clusters |\n| **Performance** | WASM/SIMD acceleration (3.2x speedup) |\n| **Model Library** | Pre-built templates for classification, regression, NLP, vision |\n| **Autonomous Learning** | DAA-enabled self-improvement through experience |\n| **Persistence** | Automatic checkpointing, version control, state recovery |\n\n### **Workflow Automation Engine**\n\n| Feature | Details |\n|---------|---------|\n| **Triggers** | GitHub webhooks, cron schedules, API calls, system events |\n| **Queue System** | Message-based distribution with automatic retries |\n| **Resilience** | State persistence, automatic resume from interruptions |\n| **Execution** | Parallel task graphs with dependency resolution |\n| **Monitoring** | Real-time tracking, audit logs, performance metrics |\n\n### **Economic \u0026 Gaming Infrastructure**\n\n| System | Description |\n|--------|-------------|\n| **rUv Credits** | Microtransaction-based resource allocation and rewards |\n| **AI Judge** | Queen Seraphina evaluates code quality, performance, innovation |\n| **Marketplace** | Publish templates, earn royalties, community contributions |\n| **Challenge Arena** | Timed competitions, leaderboards, instant rewards |\n| **Achievements** | Badges, tier upgrades, bonus credits for milestones |\n\n\n\n---\n\n## 🔧 MCP Tools Reference\n\n**Flow Nexus is the first platform built entirely on MCP (Model Context Protocol).** Every operation—from spawning agents to training neural networks—runs through MCP tools, enabling recursive intelligence where systems can understand, modify, and improve themselves.\n\nThe 70+ MCP tools below aren't just API endpoints; they're the building blocks of autonomous intelligence. Master them, and you master the future of software development.\n\n### **🏪 App Store \u0026 Templates**\n```javascript\nmcp__flow-nexus__template_list             // List templates\nmcp__flow-nexus__template_get              // Get template details\nmcp__flow-nexus__template_deploy           // Deploy template\nmcp__flow-nexus__app_store_list_templates  // Browse store\nmcp__flow-nexus__app_store_publish_app     // Publish app\nmcp__flow-nexus__app_get                   // Get app details\nmcp__flow-nexus__app_update                // Update app\nmcp__flow-nexus__app_search                // Search apps\nmcp__flow-nexus__app_analytics             // View analytics\nmcp__flow-nexus__app_installed             // List installed\n```\n\n### **🎮 Challenges \u0026 Gamification**\n```javascript\nmcp__flow-nexus__challenges_list           // List challenges\nmcp__flow-nexus__challenge_get             // Get challenge\nmcp__flow-nexus__challenge_submit          // Submit solution\nmcp__flow-nexus__app_store_complete_challenge // Complete challenge\nmcp__flow-nexus__leaderboard_get           // View leaderboard\nmcp__flow-nexus__achievements_list         // List achievements\nmcp__flow-nexus__app_store_earn_ruv        // Earn credits\nmcp__flow-nexus__ruv_balance               // Check balance\nmcp__flow-nexus__ruv_history               // Transaction history\n```\n\n### **📊 Real-time Monitoring**\n```javascript\nmcp__flow-nexus__execution_stream_subscribe // Subscribe to streams\nmcp__flow-nexus__execution_stream_status   // Stream status\nmcp__flow-nexus__execution_files_list      // List created files\nmcp__flow-nexus__execution_file_get        // Get file content\nmcp__flow-nexus__realtime_subscribe        // Database changes\nmcp__flow-nexus__realtime_unsubscribe      // Unsubscribe\nmcp__flow-nexus__realtime_list             // List subscriptions\n```\n\n### **💾 Storage \u0026 Persistence**\n```javascript\nmcp__flow-nexus__storage_upload            // Upload file\nmcp__flow-nexus__storage_delete            // Delete file\nmcp__flow-nexus__storage_list              // List files\nmcp__flow-nexus__storage_get_url           // Get public URL\n```\n\n### **🔐 Authentication \u0026 Users**\n```javascript\nmcp__flow-nexus__auth_status               // Check auth status\nmcp__flow-nexus__auth_init                 // Initialize auth\nmcp__flow-nexus__user_register             // Register user\nmcp__flow-nexus__user_login                // Login\nmcp__flow-nexus__user_logout               // Logout\nmcp__flow-nexus__user_verify_email         // Verify email\nmcp__flow-nexus__user_reset_password       // Reset password\nmcp__flow-nexus__user_update_password      // Update password\nmcp__flow-nexus__user_upgrade              // Upgrade tier\nmcp__flow-nexus__user_stats                // User statistics\nmcp__flow-nexus__user_profile              // Get profile\nmcp__flow-nexus__user_update_profile       // Update profile\n```\n\n### **💳 Payment \u0026 Credits**\n```javascript\nmcp__flow-nexus__check_balance             // Check credit balance\nmcp__flow-nexus__create_payment_link       // Create payment link\nmcp__flow-nexus__configure_auto_refill     // Setup auto-refill\nmcp__flow-nexus__get_payment_history       // Payment history\n```\n\n### **🐙 GitHub Integration**\n```javascript\nmcp__flow-nexus__github_repo_analyze       // Analyze repository\nmcp__flow-nexus__daa_agent_create          // Create DAA agent\n```\n\n### **📈 System \u0026 Health**\n```javascript\nmcp__flow-nexus__system_health             // System health check\nmcp__flow-nexus__audit_log                 // View audit logs\nmcp__flow-nexus__market_data               // Market statistics\n```\n\n### **👑 Seraphina AI Assistant**\n```javascript\nmcp__flow-nexus__seraphina_chat            // Chat with Queen Seraphina\n```\n\n---\n\n## 💰 Credit System \u0026 Pricing\n\nFlow Nexus operates on a transparent credit economy. Every action has a clear cost. Start with 356 free credits, earn more through achievements, or purchase packages when you need to scale.\n\n### **Credit Costs by Category**\n\n| **🧠 Neural \u0026 AI** | **🤖 Swarms** | **🔧 Workflows** | **🐙 GitHub** |\n|-------------------|---------------|------------------|---------------|\n| Neural XL: 100 rUv | Swarm Init: 10 rUv | Pipeline Create: 35 rUv | Repo Analyze: 75 rUv |\n| Neural Large: 50 rUv | Task Orchestrate: 5 rUv | Workflow Execute: 30 rUv | Release Coord: 50 rUv |\n| Neural Medium: 25 rUv | Swarm Scale: 5 rUv | Workflow Create: 20 rUv | Workflow Auto: 50 rUv |\n| Neural Small: 10 rUv | Agent Spawn: 3 rUv | Automation Setup: 25 rUv | Code Review: 40 rUv |\n| Neural Predict: 10 rUv | Swarm Monitor: 3 rUv | Template Manage: 8 rUv | PR Management: 20 rUv |\n\n| **👑 Queen Seraphina** | **📦 Sandboxes** | **💾 Storage** | **🎮 Challenges** |\n|------------------------|------------------|----------------|-------------------|\n| Premium (Opus): 20 rUv | Execute Code: 2 rUv | Upload File: 2 rUv | Submit Solution: 2 rUv |\n| Advanced (Sonnet+): 8 rUv | Create Sandbox: 1 rUv | Storage Upload: 1 rUv | Daily Challenges: FREE |\n| Standard (Sonnet): 4 rUv | Configure: 2 rUv | Get URL: 1 rUv | View Leaderboard: FREE |\n| Basic: 2 rUv | Delete: 1 rUv | Delete File: 1 rUv | List Challenges: FREE |\n\n### **💎 Earn Credits**\n\n| **Welcome Bonuses** | **Challenge Rewards** | **Achievements** |\n|--------------------|--------------------|-----------------|\n| Registration: 100 rUv | 🥇 1st Place: 500 rUv | App Publisher: 100 rUv |\n| First-Time Bonus: 256 rUv | 🥈 2nd Place: 300 rUv | First Steps: 50 rUv |\n| Daily Login: 100 rUv | 🥉 3rd Place: 100 rUv | Milestones: Varies |\n| **Total Start: 356 rUv** | Expert Challenges: 1500-3000 rUv | Community Contrib: Varies |\n\n### **🆓 Always Free**\n\n| **Account** | **System** | **Discovery** | **Community** |\n|-------------|------------|---------------|---------------|\n| Authentication | Health Checks | Template Browsing | Leaderboards |\n| Profile Management | System Status | Challenge Lists | Rankings |\n---\n\n## 💡 Usage Examples\n\n### **Example 1: Deploy AI Code Review Swarm**\n```javascript\n// Initialize swarm\nawait mcp__flow-nexus__swarm_init({\n  topology: \"hierarchical\",\n  maxAgents: 10\n});\n\n// Spawn review agents\nawait mcp__flow-nexus__agent_spawn({\n  type: \"reviewer\",\n  capabilities: [\"code-quality\", \"security\", \"performance\"]\n});\n\n// Orchestrate review task\nawait mcp__flow-nexus__task_orchestrate({\n  task: \"Review pull request #456\",\n  strategy: \"parallel\"\n});\n```\n\n### **Example 2: Train Custom Neural Model**\n```javascript\n// Initialize neural cluster\nawait mcp__flow-nexus__neural_cluster_init({\n  name: \"training-cluster\",\n  architecture: \"transformer\",\n  topology: \"mesh\"\n});\n\n// Start distributed training\nawait mcp__flow-nexus__neural_train_distributed({\n  cluster_id: \"cluster-123\",\n  dataset: \"custom-dataset\",\n  epochs: 100,\n  federated: true\n});\n```\n\n### **Example 3: Create Development Sandbox**\n```javascript\n// Create sandbox\nconst sandbox = await mcp__flow-nexus__sandbox_create({\n  template: \"nextjs\",\n  env_vars: {\n    API_KEY: \"xxx\",\n    DATABASE_URL: \"postgres://...\"\n  }\n});\n\n// Execute code\nawait mcp__flow-nexus__sandbox_execute({\n  sandbox_id: sandbox.id,\n  code: \"npm run dev\",\n  language: \"bash\"\n});\n```\n\n---\n\n## 🛠️ CLI Commands\n\n```bash\nnpx flow-nexus [command] [options]\n```\n\n### **Core Commands**\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `init` | Initialize new Flow Nexus project | `npx flow-nexus init` |\n| `swarm` | Manage AI agent swarms | `npx flow-nexus swarm create mesh` |\n| `challenge` | Browse and complete challenges | `npx flow-nexus challenge list` |\n| `sandbox` | Manage cloud sandboxes | `npx flow-nexus sandbox create` |\n| `credits` | Check rUv credit balance | `npx flow-nexus credits balance` |\n| `auth` | Authentication management | `npx flow-nexus auth login` |\n| `template` | Manage deployment templates | `npx flow-nexus template deploy` |\n| `store` | App marketplace | `npx flow-nexus store list` |\n| `profile` | Manage user profile \u0026 settings | `npx flow-nexus profile view` |\n| `achievements` | View achievements \u0026 badges | `npx flow-nexus achievements` |\n| `leaderboard` | View global rankings | `npx flow-nexus leaderboard` |\n| `seraphina` | Chat with Queen Seraphina AI | `npx flow-nexus seraphina \"How to deploy?\"` |\n| `workflow` | Automation workflows | `npx flow-nexus workflow create` |\n| `monitor` | System monitoring | `npx flow-nexus monitor status` |\n| `storage` | File storage management | `npx flow-nexus storage list` |\n| `mcp` | MCP server management | `npx flow-nexus mcp start` |\n| `system` | System check and validation | `npx flow-nexus system` |\n| `deploy` | Deploy to production | `npx flow-nexus deploy` |\n| `e2e` | Run end-to-end tests | `npx flow-nexus e2e` |\n\n### **Quick Examples**\n\n```bash\n# Start interactive mode\nnpx flow-nexus\n\n# Initialize project with Flow Nexus\nnpx flow-nexus init\n\n# Create a mesh topology swarm\nnpx flow-nexus swarm create mesh\n\n# View available challenges\nnpx flow-nexus challenge list\n\n# Check your rUv balance\nnpx flow-nexus credits balance\n\n# Deploy a template\nnpx flow-nexus template deploy nextjs-saas\n\n# Chat with Queen Seraphina\nnpx flow-nexus seraphina \"How do I create a swarm?\"\n```\n\n---\n\n## 🎮 Interactive Modes\n\n### **Launch Interactive Menu**\n```bash\nnpx flow-nexus\n```\n\n```\n[QUICK START PROTOCOLS]\n\n⚠️  Initialize your neural profile to unlock full capabilities:\n   flow-nexus auth init\n   flow-nexus auth register -e pilot@ruv.io -p your-password\n\n[AVAILABLE COMMANDS]\n  flow-nexus check      // System diagnostics\n  flow-nexus swarm      // Deploy AI swarms\n  flow-nexus sandbox    // Reality simulations\n  flow-nexus challenge  // Combat training\n  flow-nexus --help     // Command matrix\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nWELCOME TO THE NEXUS, OPERATOR\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n? 🎮 SELECT OPERATION MODE: (Use arrow keys)\n❯ ⚡ SYSTEM CHECK - Verify all systems \n  🤖 SWARM CONTROL - Deploy AI agents \n  🎯 COMBAT TRAINING - Accept challenges \n  📦 SANDBOX REALITY - Create simulations \n  👑 QUEEN SERAPHINA - Seek royal guidance \n  💎 CREDIT STATUS - Check rUv balance \n  🚀 DEPLOYMENT - Launch to production \n(Move up and down to reveal more choices)\n```\n\n### **Operation Modes**\n\n| Mode | Description | Key Features |\n|------|-------------|--------------|\n| **🎯 Combat Training** | Challenge system with AI judging | Daily challenges, tournaments, leaderboards |\n| **🛍️ App Store** | Browse and deploy templates | One-click deploy, earn royalties, ratings |\n| **🤖 Swarm Control** | Multi-agent orchestration | Real-time monitoring, topology optimization |\n| **📦 Sandbox Reality** | Isolated execution environments | Instant provisioning, multiple runtimes |\n| **👑 Queen Seraphina** | AI assistant and judge | Guidance, evaluation, wisdom |\n\n---\n\n## 📦 Template Marketplace\n\n### **Available Templates**\n\n| Template | Cost | Description |\n|----------|------|-------------|\n| **Workflow Templates** | 8 rUv | Advanced workflow automation patterns |\n| **SaaS Starter** | 2 rUv | Complete SaaS boilerplate |\n| **AI Chatbot** | 2 rUv | ChatGPT-like interface |\n| **E-Commerce** | 2 rUv | Full shopping platform |\n| **Admin Panel** | 2 rUv | Dashboard with analytics |\n| **Swarm Templates** | 2 rUv | Pre-configured agent swarms |\n| **App Updates** | 2 rUv | Application version management |\n| **Analytics Dashboard** | 1 rUv | Real-time metrics visualization |\n| **App Store Install** | 1 rUv | One-click app deployment |\n| **Template Browser** | FREE | Browse all available templates |\n\n```bash\n# List all templates (FREE)\nnpx flow-nexus template\n\n# Deploy a template\nnpx flow-nexus template deploy\n```\n\n---\n\n## 🎯 Common Workflows\n\n### **Create and Deploy a Swarm**\n```bash\n# Using MCP tools in Claude Desktop:\n1. Initialize swarm: swarm_init with topology \"mesh\"\n2. Spawn agents: agent_spawn type \"coder\", \"tester\", \"reviewer\"\n3. Orchestrate task: task_orchestrate \"Build REST API\"\n4. Monitor progress: swarm_status\n```\n\n### **Complete a Challenge**\n```bash\n# Interactive CLI:\nnpx flow-nexus challenge\n\n# Select a challenge, write solution, earn credits\n```\n\n### **Deploy a Template**\n```bash\n# Browse available templates\nnpx flow-nexus template\n\n# Deploy your choice\n# Costs 2 rUv per template\n```\n\n---\n\n## 📊 Your Progress \u0026 Stats\n\n### **Check Your Profile**\n```bash\nnpx flow-nexus profile\n\n# Shows:\n- Developer level\n- rUv credit balance\n- Challenges completed\n- Apps published\n- Achievement badges\n- Global ranking\n```\n\n### **View Achievements**\n```bash\nnpx flow-nexus achievements\n\n# Unlock badges for:\n- First swarm deployed\n- 10 challenges completed\n- App with 5-star rating\n- 1000 rUv earned\n- Top 10 leaderboard\n```\n\n---\n\n## 🆘 Getting Help\n\n### **Built-in Help**\n```bash\n# General help\nnpx flow-nexus --help\n\n# Command-specific help\nnpx flow-nexus swarm --help\nnpx flow-nexus challenge --help\nnpx flow-nexus mcp --help\nnpx flow-nexus auth --help\n```\n\n### **Queen Seraphina AI Assistant**\n```bash\n# Ask the AI mentor anything\nnpx flow-nexus chat\n\n# Or use in MCP:\nseraphina_chat with message \"How do I create a swarm?\"\n```\n\n### **Common Issues**\n\n**Not enough credits?**\n```bash\n# Check balance\nnpx flow-nexus credits balance\n\n# Complete challenges to earn credits\nnpx flow-nexus challenge list\n\n# Daily login bonus (100 rUv)\nnpx flow-nexus auth login\n```\n\n**MCP not working in Claude?**\n```bash\n# Test MCP server\nnpx flow-nexus mcp\n\n# Should show: \"MCP server running on stdio transport\"\n\n# List available tools\nnpx flow-nexus mcp tools\n\n# Check system status\nnpx flow-nexus system\n```\n\n**Authentication issues?**\n```bash\n# Check auth status\nnpx flow-nexus auth status\n\n# Re-login if needed\nnpx flow-nexus auth login -e your@email.com -p password\n```\n\n---\n\n## 🌟 Join the Community\n\n### **Get Started Now**\n\n```bash\nnpx flow-nexus\n```\n\n**One Command. Real Tools. Actual Results.**\n\n### **Resources**\n- 📚 **Documentation**: [flow-nexus.ruv.io](https://flow-nexus.ruv.io)\n- 🐛 **Issues**: [GitHub](https://github.com/ruvnet/flow-nexus)\n- 📦 **NPM Package**: [npmjs.com/package/flow-nexus](https://www.npmjs.com/package/flow-nexus)\n- 💬 **WhatsApp Community**: [Join our WhatsApp group](https://chat.whatsapp.com/GItFZiqysSJ6mDyPOQ3Lxg)\n- 📧 **Support**: GitHub Issues \u0026 WhatsApp Community\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nBuilt with ❤️ by [rUv](https://ruv.io)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruvnet%2Fflow-nexus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruvnet%2Fflow-nexus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruvnet%2Fflow-nexus/lists"}