Package Exports

flow-nexus
flow-nexus/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (flow-nexus) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🚀 Flow Nexus - AI Agent Ecosystem & Gamified Development Platform

🌐 fnx.ruv.io

Deploy AI Swarms • Complete Challenges • Earn Credits • Build Faster

npx flow-nexus

✨ Free Start • 🎮 Gamified Experience • 🚀 Instant Deploy

🎯 Transform How You Build Software

Flow Nexus is your AI-powered development platform with 70+ MCP tools. Deploy swarms of specialized agents, complete coding challenges, and earn rUv credits while building real applications.

Why Developers Choose Flow Nexus

🚀 70+ MCP Tools	🎮 Earn While Building	🤖 AI Swarms	💰 Free Credits
Complete toolset for AI development	Gamified challenges & rewards	Multi-agent orchestration	2560 credits to start

⚡ Start in 60 Seconds

# 1. Initialize Flow Nexus (interactive setup)
npx flow-nexus init

# 2. Choose your setup:
#    → Select a template (Basic, Advanced, Enterprise)
#    → Create account or login
#    → Get your free rUv credits

# 3. Select operation mode:
#    → 🎮 Gamer Mode - Challenges & tournaments
#    → 🛍️ Store Mode - Browse & deploy apps
#    → 🤖 Swarm Mode - Orchestrate AI agents
#    → 🛠️ MCP Mode - Direct tool access
#    → 👑 Queen Seraphina - AI mentor

🎁 New User Bonus: 2560 free rUv credits to start!

🛠️ Real Commands That Work

Authentication & Setup

# Register new account
npx flow-nexus auth register -e email@example.com -p password

# Login to existing account
npx flow-nexus auth login -e email@example.com -p password

# Initialize local config
npx flow-nexus auth init

# Check authentication status
npx flow-nexus auth status

MCP Server Modes

# Run as MCP server (for Claude Desktop)
npx flow-nexus mcp

# Start with specific mode
npx flow-nexus start swarm      # Swarm orchestration tools
npx flow-nexus start store      # App store & gamification
npx flow-nexus start gamer      # Challenges & achievements
npx flow-nexus start dev        # Development tools
npx flow-nexus start complete   # All 70+ tools (default)

# Start with HTTP server
npx flow-nexus start --http-port 3000

Interactive CLI Commands

# Main interactive menu
npx flow-nexus

# Swarm management
npx flow-nexus swarm

# Browse challenges
npx flow-nexus challenge

# Manage sandboxes
npx flow-nexus sandbox

# Check credit balance
npx flow-nexus credits

# View templates
npx flow-nexus template

# Browse app store
npx flow-nexus store

# View profile & stats
npx flow-nexus profile

# Check achievements
npx flow-nexus achievements

# View leaderboard
npx flow-nexus leaderboard

💰 Credit System & Pricing

How Credits Work

Every MCP tool operation costs rUv credits. Here are the actual costs from the system:

Operation	Cost	Description
swarm_init	3 rUv	Initialize a new swarm
agent_spawn	2 rUv/agent	Create specialized agents
sandbox_create	1 rUv	Deploy cloud sandbox
task_orchestrate	5 rUv	Complex task coordination
template_deploy	1-8 rUv	Deploy app templates
challenge_submit	0 rUv	FREE - Submit solutions

Earn Credits

Activity	Reward	How To
Register	100 rUv	Sign up for free account
Complete Challenge	10-50 rUv	`npx flow-nexus challenge`
Publish App	25 rUv	Share your creations
5-Star Rating	50 rUv	Get high ratings on apps

Credit Packages

# Check your balance
npx flow-nexus credits balance

# View pricing tiers
npx flow-nexus credits pricing

🤖 70+ MCP Tools Available

Core Swarm Tools

// Initialize swarm
mcp__flow-nexus-npm__swarm_init
  - topology: "mesh" | "star" | "ring" | "hierarchical"
  - maxAgents: 1-100
  - strategy: "balanced" | "specialized" | "adaptive"

// Spawn agents
mcp__flow-nexus-npm__agent_spawn
  - type: "researcher" | "coder" | "analyst" | "optimizer" | "coordinator"
  - capabilities: ["custom", "skills"]

// Orchestrate tasks
mcp__flow-nexus-npm__task_orchestrate
  - task: "Your task description"
  - strategy: "parallel" | "sequential" | "adaptive"

Sandbox Tools

// Create sandbox
mcp__flow-nexus-npm__sandbox_create
  - template: "node" | "python" | "react" | "nextjs" | "claude-code"
  - env_vars: { ANTHROPIC_API_KEY: "..." }
  
// Execute code
mcp__flow-nexus-npm__sandbox_execute
  - sandbox_id: "sandbox-id"
  - code: "your code"
  - language: "javascript" | "python"

Gamification Tools

// List challenges
mcp__flow-nexus-npm__challenges_list
  - difficulty: "beginner" | "intermediate" | "advanced"
  
// Submit solution
mcp__flow-nexus-npm__challenge_submit
  - challenge_id: "challenge-id"
  - solution_code: "your solution"
  
// Check leaderboard
mcp__flow-nexus-npm__leaderboard_get
  - type: "global" | "weekly" | "monthly"

App Store Tools

// Browse templates
mcp__flow-nexus-npm__template_list
  - category: "quickstart" | "specialized" | "enterprise"
  
// Deploy template
mcp__flow-nexus-npm__template_deploy
  - template_name: "nextjs-saas"
  - variables: { project_name: "my-app" }
  
// Publish app
mcp__flow-nexus-npm__app_store_publish_app
  - name: "Your App"
  - category: "productivity"
  - source_code: "..."

Queen Seraphina AI

// Chat with AI mentor
mcp__flow-nexus-npm__seraphina_chat
  - message: "How do I deploy to AWS?"
  - enable_tools: true  // Let her execute commands

🎮 Interactive Modes

npx flow-nexus

# You'll see:
╔════════════════════════════════════════╗
║     🚀 FLOW NEXUS MAIN MENU           ║
╠════════════════════════════════════════╣
║                                        ║
║  [1] 🎮 Gamer Mode                    ║
║  [2] 🛍️ Store Mode                    ║
║  [3] 🤖 Swarm Mode                    ║
║  [4] 🛠️ MCP Mode                      ║
║  [5] 👑 Queen Seraphina               ║
║                                        ║
╚════════════════════════════════════════╝

Gamer Mode Features

Daily challenges with rUv rewards
Weekly tournaments
Leaderboards
Achievement system
Skill progression

Store Mode Features

Browse app templates
Deploy with one command
Earn royalties from your apps
Rate and review apps
Featured collections

Swarm Mode Features

Visual swarm management
Real-time agent monitoring
Task orchestration
Performance metrics
Topology optimization

📦 Template Marketplace

Available Templates

Template	Cost	Description
SaaS Starter	1 rUv	Complete SaaS boilerplate
AI Chatbot	1 rUv	ChatGPT-like interface
E-Commerce	2 rUv	Full shopping platform
Admin Panel	1 rUv	Dashboard with analytics
Multi-Tenant	5 rUv	Enterprise SaaS platform
Marketplace	5 rUv	Two-sided marketplace
CRM System	8 rUv	Customer management

# List all templates
npx flow-nexus template

# Deploy a template
npx flow-nexus template deploy

🚀 MCP Integration with Claude Desktop

Setup for Claude Desktop

Install Flow Nexus:

npm install -g flow-nexus

Add to Claude Desktop config:

{
  "mcpServers": {
    "flow-nexus": {
      "command": "npx",
      "args": ["flow-nexus", "mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-optional"
      }
    }
  }
}

Restart Claude Desktop

Available MCP Tools in Claude

Once configured, you can use all 70+ tools directly in Claude:

- swarm_init, agent_spawn, task_orchestrate
- sandbox_create, sandbox_execute, sandbox_list
- challenge_list, challenge_submit, leaderboard_get
- template_list, template_deploy, app_store_publish
- seraphina_chat (AI mentor)
- And 60+ more tools...

🎯 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 1-8 rUv depending on 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

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 daily challenge for free credits
npx flow-nexus challenge

MCP not working in Claude?

# Test MCP server
npx flow-nexus mcp

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

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

📚 Documentation: fnx.ruv.io
🐛 Issues: GitHub
📧 Support: support@flow-nexus.com

Built with ❤️ by rUv

flow-nexus