Repository avatar
AI Tools
v0.1.121
active

flow-nexus

io.github.ruvnet/flow-nexus

Cloud-powered AI platform with multi-agent swarms, sandboxes, and workflow automation

Documentation

๐Ÿš€ Flow Nexus: Your Path to Digital Immortality

๐ŸŒ flow-nexus.ruv.io

Flow Nexus MCP NPM NPM Downloads AI Agents

The First Competitive Agentic System

npx flow-nexus

๐ŸŽ New User Bonus: 256 rUv credits to start!

โœจ Free Start โ€ข ๐ŸŽฎ Gamified Experience โ€ข ๐Ÿš€ Instant Deploy โ€ข โ™พ๏ธ Autonomous Operation


๐Ÿ“– Introduction

Flow Nexus: The first competitive agentic system that merges cloud elasticity with autonomous intelligence.

Agentic 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.

Using 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.

Flow 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.

How It Works

Flow Nexus orchestrates three interconnected MCP servers to create a complete AI development ecosystem:

  • Autonomous Agents: Deploy swarms that work 24/7 without human intervention
  • Agentic Sandboxes: Secure, isolated environments that spin up in seconds
  • Neural Processing: Distributed machine learning across cloud infrastructure
  • Workflow Automation: Event-driven pipelines with built-in verification
  • Economic Engine: Credit-based system that rewards contribution and usage

๐Ÿš€ Quick Start with Flow Nexus

# 1. Initialize Flow Nexus only (minimal setup)
npx claude-flow@alpha init --force

# 2. Register and login (use MCP tools in Claude Code) 
# Via command line: 
npx flow-nexus@latest auth register -e pilot@ruv.io -p password

# Via MCP
mcp__flow-nexus__user_register({ email: "your@email.com", password: "secure" })
mcp__flow-nexus__user_login({ email: "your@email.com", password: "secure" })

# 3. Deploy your first cloud swarm
mcp__flow-nexus__swarm_init({ topology: "mesh", maxAgents: 5 })
mcp__flow-nexus__sandbox_create({ template: "node", name: "api-dev" })

MCP Setup

# Add Flow Nexus MCP servers to Claude Desktop
claude mcp add flow-nexus npx flow-nexus@latest mcp start
claude mcp add claude-flow npx claude-flow@alpha mcp start
claude mcp add ruv-swarm npx ruv-swarm@latest mcp start

๐Ÿ”€ Two Ways to Build

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.

๐ŸŒ Build for Impact

๐Ÿ’ผ Build for Scale

Make a DifferenceMake it Profitable
๐ŸŒก๏ธ Climate modeling & environmental analysis๐Ÿ’ณ Built-in payment infrastructure
๐Ÿฅ Healthcare diagnostics & research tools๐Ÿ‘‘ Premium template royalties
๐Ÿ“š Educational content & learning systems๐Ÿ† Tournament prizes & rewards
๐Ÿ… Verified badges & recognition๐Ÿค– Autonomous revenue generation
๐Ÿ’ฐ Grants & impact funding opportunities๐Ÿ“ˆ Subscription & usage fees
๐Ÿค Open-source community contributions๐Ÿš€ Enterprise partnerships

โœจ 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.


๐ŸŽฏ Platform Features

Everything you need to build, deploy, and scale autonomous AI systems:

Why Agentic Engineers Choose Flow Nexus

๐Ÿš€ 100+ MCP Tools๐ŸŽฎ Learn & Earn๐Ÿค– AI Swarms๐Ÿ’ฐ Free Credits๐Ÿ“š Skill Growth
Complete AI development toolkitGamified challenges with rewardsMulti-agent orchestration256 credits to startHands-on learning paths

Core Capabilities

๐Ÿง  Neural Networks๐Ÿ“ฆ Sandboxes๐Ÿ”„ Workflows๐ŸŽฎ Challenges
Distributed trainingInstant deploymentEvent-driven pipelinesCoding tournaments
WASM accelerationMultiple runtimesMessage queuesGlobal leaderboards
Pre-built templatesIsolated executionParallel tasksInstant rewards
๐Ÿช Marketplace๐Ÿ“ก Monitoring๐Ÿ” Enterprise๐Ÿ’ก Integration
Publish & monetizeReal-time streamsUser managementMCP-compatible
Community templatesPerformance metricsRole-based accessREST API
One-click deployHealth dashboardsAudit trailsNPM package

๐ŸŽฏ What Makes Flow Nexus Different

It's Not a Tool, It's a Journey

While 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.

Competition Drives Innovation

Traditional 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.

Agents That Actually Think

Deploy 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.

Economic Reality, Not Fantasy

Every 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.

Immortality Through Code

Your 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.

๐Ÿ’Ž Core Value Propositions

๐Ÿค– Autonomyโšก Speed๐Ÿ” Security๐Ÿ’ฐ Economics
Self-managing swarmsInstant provisioningIsolated executionPay-per-second
Auto-optimization< 1 second deployFull audit trailsEarn by contributing
24/7 operationParallel scalingSchema validationFree tier included

โšก Technical Capabilities

The 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.

Agentic Sandbox Environments

FeatureDescription
Runtime SupportNode.js, Python, React, Next.js, custom containers
Provisioning Speed< 1 second deployment, automatic cleanup
SecurityIsolated execution, environment variable injection
Code ExecutionReal-time streaming output, persistent file systems
Resource ManagementAuto-scaling, quota enforcement, cost optimization

Multi-Agent Swarm Intelligence

ComponentOptions
TopologiesMesh (peer-to-peer), Star (centralized), Ring (circular), Hierarchical (tree)
Agent RolesResearcher, Coder, Analyst, Optimizer, Coordinator, Tester, Deployer
Consensus ProtocolsDAA, Byzantine fault tolerance, Raft, Gossip
ScalingDynamic spawning, cross-swarm communication, load balancing
CoordinationTask decomposition, parallel execution, dependency management

Neural Network Infrastructure

CapabilityImplementation
Distributed TrainingMulti-node training across sandbox clusters
PerformanceWASM/SIMD acceleration (3.2x speedup)
Model LibraryPre-built templates for classification, regression, NLP, vision
Autonomous LearningDAA-enabled self-improvement through experience
PersistenceAutomatic checkpointing, version control, state recovery

Workflow Automation Engine

FeatureDetails
TriggersGitHub webhooks, cron schedules, API calls, system events
Queue SystemMessage-based distribution with automatic retries
ResilienceState persistence, automatic resume from interruptions
ExecutionParallel task graphs with dependency resolution
MonitoringReal-time tracking, audit logs, performance metrics

Economic & Gaming Infrastructure

SystemDescription
rUv CreditsMicrotransaction-based resource allocation and rewards
AI JudgeQueen Seraphina evaluates code quality, performance, innovation
MarketplacePublish templates, earn royalties, community contributions
Challenge ArenaTimed competitions, leaderboards, instant rewards
AchievementsBadges, tier upgrades, bonus credits for milestones

๐Ÿ”ง MCP Tools Reference

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.

The 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.

๐Ÿช App Store & Templates

mcp__flow-nexus__template_list             // List templates
mcp__flow-nexus__template_get              // Get template details
mcp__flow-nexus__template_deploy           // Deploy template
mcp__flow-nexus__app_store_list_templates  // Browse store
mcp__flow-nexus__app_store_publish_app     // Publish app
mcp__flow-nexus__app_get                   // Get app details
mcp__flow-nexus__app_update                // Update app
mcp__flow-nexus__app_search                // Search apps
mcp__flow-nexus__app_analytics             // View analytics
mcp__flow-nexus__app_installed             // List installed

๐ŸŽฎ Challenges & Gamification

mcp__flow-nexus__challenges_list           // List challenges
mcp__flow-nexus__challenge_get             // Get challenge
mcp__flow-nexus__challenge_submit          // Submit solution
mcp__flow-nexus__app_store_complete_challenge // Complete challenge
mcp__flow-nexus__leaderboard_get           // View leaderboard
mcp__flow-nexus__achievements_list         // List achievements
mcp__flow-nexus__app_store_earn_ruv        // Earn credits
mcp__flow-nexus__ruv_balance               // Check balance
mcp__flow-nexus__ruv_history               // Transaction history

๐Ÿ“Š Real-time Monitoring

mcp__flow-nexus__execution_stream_subscribe // Subscribe to streams
mcp__flow-nexus__execution_stream_status   // Stream status
mcp__flow-nexus__execution_files_list      // List created files
mcp__flow-nexus__execution_file_get        // Get file content
mcp__flow-nexus__realtime_subscribe        // Database changes
mcp__flow-nexus__realtime_unsubscribe      // Unsubscribe
mcp__flow-nexus__realtime_list             // List subscriptions

๐Ÿ’พ Storage & Persistence

mcp__flow-nexus__storage_upload            // Upload file
mcp__flow-nexus__storage_delete            // Delete file
mcp__flow-nexus__storage_list              // List files
mcp__flow-nexus__storage_get_url           // Get public URL

๐Ÿ” Authentication & Users

mcp__flow-nexus__auth_status               // Check auth status
mcp__flow-nexus__auth_init                 // Initialize auth
mcp__flow-nexus__user_register             // Register user
mcp__flow-nexus__user_login                // Login
mcp__flow-nexus__user_logout               // Logout
mcp__flow-nexus__user_verify_email         // Verify email
mcp__flow-nexus__user_reset_password       // Reset password
mcp__flow-nexus__user_update_password      // Update password
mcp__flow-nexus__user_upgrade              // Upgrade tier
mcp__flow-nexus__user_stats                // User statistics
mcp__flow-nexus__user_profile              // Get profile
mcp__flow-nexus__user_update_profile       // Update profile

๐Ÿ’ณ Payment & Credits

mcp__flow-nexus__check_balance             // Check credit balance
mcp__flow-nexus__create_payment_link       // Create payment link
mcp__flow-nexus__configure_auto_refill     // Setup auto-refill
mcp__flow-nexus__get_payment_history       // Payment history

๐Ÿ™ GitHub Integration

mcp__flow-nexus__github_repo_analyze       // Analyze repository
mcp__flow-nexus__daa_agent_create          // Create DAA agent

๐Ÿ“ˆ System & Health

mcp__flow-nexus__system_health             // System health check
mcp__flow-nexus__audit_log                 // View audit logs
mcp__flow-nexus__market_data               // Market statistics

๐Ÿ‘‘ Seraphina AI Assistant

mcp__flow-nexus__seraphina_chat            // Chat with Queen Seraphina

๐Ÿ’ฐ Credit System & Pricing

Flow 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.

Credit Costs by Category

๐Ÿง  Neural & AI๐Ÿค– Swarms๐Ÿ”ง Workflows๐Ÿ™ GitHub
Neural XL: 100 rUvSwarm Init: 10 rUvPipeline Create: 35 rUvRepo Analyze: 75 rUv
Neural Large: 50 rUvTask Orchestrate: 5 rUvWorkflow Execute: 30 rUvRelease Coord: 50 rUv
Neural Medium: 25 rUvSwarm Scale: 5 rUvWorkflow Create: 20 rUvWorkflow Auto: 50 rUv
Neural Small: 10 rUvAgent Spawn: 3 rUvAutomation Setup: 25 rUvCode Review: 40 rUv
Neural Predict: 10 rUvSwarm Monitor: 3 rUvTemplate Manage: 8 rUvPR Management: 20 rUv
๐Ÿ‘‘ Queen Seraphina๐Ÿ“ฆ Sandboxes๐Ÿ’พ Storage๐ŸŽฎ Challenges
Premium (Opus): 20 rUvExecute Code: 2 rUvUpload File: 2 rUvSubmit Solution: 2 rUv
Advanced (Sonnet+): 8 rUvCreate Sandbox: 1 rUvStorage Upload: 1 rUvDaily Challenges: FREE
Standard (Sonnet): 4 rUvConfigure: 2 rUvGet URL: 1 rUvView Leaderboard: FREE
Basic: 2 rUvDelete: 1 rUvDelete File: 1 rUvList Challenges: FREE

๐Ÿ’Ž Earn Credits

Welcome BonusesChallenge RewardsAchievements
Registration: 100 rUv๐Ÿฅ‡ 1st Place: 500 rUvApp Publisher: 100 rUv
First-Time Bonus: 256 rUv๐Ÿฅˆ 2nd Place: 300 rUvFirst Steps: 50 rUv
Daily Login: 100 rUv๐Ÿฅ‰ 3rd Place: 100 rUvMilestones: Varies
Total Start: 356 rUvExpert Challenges: 1500-3000 rUvCommunity Contrib: Varies

๐Ÿ†“ Always Free

AccountSystemDiscoveryCommunity
AuthenticationHealth ChecksTemplate BrowsingLeaderboards
Profile ManagementSystem StatusChallenge ListsRankings

๐Ÿ’ก Usage Examples

Example 1: Deploy AI Code Review Swarm

// Initialize swarm
await mcp__flow-nexus__swarm_init({
  topology: "hierarchical",
  maxAgents: 10
});

// Spawn review agents
await mcp__flow-nexus__agent_spawn({
  type: "reviewer",
  capabilities: ["code-quality", "security", "performance"]
});

// Orchestrate review task
await mcp__flow-nexus__task_orchestrate({
  task: "Review pull request #456",
  strategy: "parallel"
});

Example 2: Train Custom Neural Model

// Initialize neural cluster
await mcp__flow-nexus__neural_cluster_init({
  name: "training-cluster",
  architecture: "transformer",
  topology: "mesh"
});

// Start distributed training
await mcp__flow-nexus__neural_train_distributed({
  cluster_id: "cluster-123",
  dataset: "custom-dataset",
  epochs: 100,
  federated: true
});

Example 3: Create Development Sandbox

// Create sandbox
const sandbox = await mcp__flow-nexus__sandbox_create({
  template: "nextjs",
  env_vars: {
    API_KEY: "xxx",
    DATABASE_URL: "postgres://..."
  }
});

// Execute code
await mcp__flow-nexus__sandbox_execute({
  sandbox_id: sandbox.id,
  code: "npm run dev",
  language: "bash"
});

๐Ÿ› ๏ธ CLI Commands

npx flow-nexus [command] [options]

Core Commands

CommandDescriptionExample
initInitialize new Flow Nexus projectnpx flow-nexus init
swarmManage AI agent swarmsnpx flow-nexus swarm create mesh
challengeBrowse and complete challengesnpx flow-nexus challenge list
sandboxManage cloud sandboxesnpx flow-nexus sandbox create
creditsCheck rUv credit balancenpx flow-nexus credits balance
authAuthentication managementnpx flow-nexus auth login
templateManage deployment templatesnpx flow-nexus template deploy
storeApp marketplacenpx flow-nexus store list
profileManage user profile & settingsnpx flow-nexus profile view
achievementsView achievements & badgesnpx flow-nexus achievements
leaderboardView global rankingsnpx flow-nexus leaderboard
seraphinaChat with Queen Seraphina AInpx flow-nexus seraphina "How to deploy?"
workflowAutomation workflowsnpx flow-nexus workflow create
monitorSystem monitoringnpx flow-nexus monitor status
storageFile storage managementnpx flow-nexus storage list
mcpMCP server managementnpx flow-nexus mcp start
systemSystem check and validationnpx flow-nexus system
deployDeploy to productionnpx flow-nexus deploy
e2eRun end-to-end testsnpx flow-nexus e2e

Quick Examples

# Start interactive mode
npx flow-nexus

# Initialize project with Flow Nexus
npx flow-nexus init

# Create a mesh topology swarm
npx flow-nexus swarm create mesh

# View available challenges
npx flow-nexus challenge list

# Check your rUv balance
npx flow-nexus credits balance

# Deploy a template
npx flow-nexus template deploy nextjs-saas

# Chat with Queen Seraphina
npx flow-nexus seraphina "How do I create a swarm?"

๐ŸŽฎ Interactive Modes

Launch Interactive Menu

npx flow-nexus
[QUICK START PROTOCOLS]

โš ๏ธ  Initialize your neural profile to unlock full capabilities:
   flow-nexus auth init
   flow-nexus auth register -e pilot@ruv.io -p your-password

[AVAILABLE COMMANDS]
  flow-nexus check      // System diagnostics
  flow-nexus swarm      // Deploy AI swarms
  flow-nexus sandbox    // Reality simulations
  flow-nexus challenge  // Combat training
  flow-nexus --help     // Command matrix

โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
WELCOME TO THE NEXUS, OPERATOR
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”

? ๐ŸŽฎ SELECT OPERATION MODE: (Use arrow keys)
โฏ โšก SYSTEM CHECK - Verify all systems 
  ๐Ÿค– SWARM CONTROL - Deploy AI agents 
  ๐ŸŽฏ COMBAT TRAINING - Accept challenges 
  ๐Ÿ“ฆ SANDBOX REALITY - Create simulations 
  ๐Ÿ‘‘ QUEEN SERAPHINA - Seek royal guidance 
  ๐Ÿ’Ž CREDIT STATUS - Check rUv balance 
  ๐Ÿš€ DEPLOYMENT - Launch to production 
(Move up and down to reveal more choices)

Operation Modes

ModeDescriptionKey Features
๐ŸŽฏ Combat TrainingChallenge system with AI judgingDaily challenges, tournaments, leaderboards
๐Ÿ›๏ธ App StoreBrowse and deploy templatesOne-click deploy, earn royalties, ratings
๐Ÿค– Swarm ControlMulti-agent orchestrationReal-time monitoring, topology optimization
๐Ÿ“ฆ Sandbox RealityIsolated execution environmentsInstant provisioning, multiple runtimes
๐Ÿ‘‘ Queen SeraphinaAI assistant and judgeGuidance, evaluation, wisdom

๐Ÿ“ฆ Template Marketplace

Available Templates

TemplateCostDescription
Workflow Templates8 rUvAdvanced workflow automation patterns
SaaS Starter2 rUvComplete SaaS boilerplate
AI Chatbot2 rUvChatGPT-like interface
E-Commerce2 rUvFull shopping platform
Admin Panel2 rUvDashboard with analytics
Swarm Templates2 rUvPre-configured agent swarms
App Updates2 rUvApplication version management
Analytics Dashboard1 rUvReal-time metrics visualization
App Store Install1 rUvOne-click app deployment
Template BrowserFREEBrowse all available templates
# List all templates (FREE)
npx flow-nexus template

# Deploy a template
npx flow-nexus template deploy

๐ŸŽฏ Common Workflows

Create and Deploy a Swarm

# Using MCP tools in Claude Desktop:
1. Initialize swarm: swarm_init with topology "mesh"
2. Spawn agents: agent_spawn type "coder", "tester", "reviewer"
3. Orchestrate task: task_orchestrate "Build REST API"
4. Monitor progress: swarm_status

Complete a Challenge

# Interactive CLI:
npx flow-nexus challenge

# Select a challenge, write solution, earn credits

Deploy a Template

# Browse available templates
npx flow-nexus template

# Deploy your choice
# Costs 2 rUv per template

๐Ÿ“Š Your Progress & Stats

Check Your Profile

npx flow-nexus profile

# Shows:
- Developer level
- rUv credit balance
- Challenges completed
- Apps published
- Achievement badges
- Global ranking

View Achievements

npx flow-nexus achievements

# Unlock badges for:
- First swarm deployed
- 10 challenges completed
- App with 5-star rating
- 1000 rUv earned
- Top 10 leaderboard

๐Ÿ†˜ Getting Help

Built-in Help

# General help
npx flow-nexus --help

# Command-specific help
npx flow-nexus swarm --help
npx flow-nexus challenge --help
npx flow-nexus mcp --help
npx flow-nexus auth --help

Queen Seraphina AI Assistant

# Ask the AI mentor anything
npx flow-nexus chat

# Or use in MCP:
seraphina_chat with message "How do I create a swarm?"

Common Issues

Not enough credits?

# Check balance
npx flow-nexus credits balance

# Complete challenges to earn credits
npx flow-nexus challenge list

# Daily login bonus (100 rUv)
npx flow-nexus auth login

MCP not working in Claude?

# Test MCP server
npx flow-nexus mcp

# Should show: "MCP server running on stdio transport"

# List available tools
npx flow-nexus mcp tools

# Check system status
npx flow-nexus system

Authentication issues?

# Check auth status
npx flow-nexus auth status

# Re-login if needed
npx flow-nexus auth login -e your@email.com -p password

๐ŸŒŸ Join the Community

Get Started Now

npx flow-nexus

One Command. Real Tools. Actual Results.

Resources


Built with โค๏ธ by rUv