npx flow-nexus✨ Free Start • 🎮 Gamified Experience • 🚀 Instant Deploy
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.
| 🚀 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 |
# 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# Register new account
npx flow-nexus auth register -e [email protected] -p password
# Login to existing account
npx flow-nexus auth login -e [email protected] -p password
# Initialize local config
npx flow-nexus auth init
# Check authentication status
npx flow-nexus auth status# 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# 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 leaderboardEvery 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 |
| 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 |
# Check your balance
npx flow-nexus credits balance
# View pricing tiers
npx flow-nexus credits pricing// 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"// 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"// 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"// 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: "..."// Chat with AI mentor
mcp__flow-nexus-npm__seraphina_chat
- message: "How do I deploy to AWS?"
- enable_tools: true // Let her execute commandsnpx flow-nexus
# You'll see:
╔════════════════════════════════════════╗
║ 🚀 FLOW NEXUS MAIN MENU ║
╠════════════════════════════════════════╣
║ ║
║ [1] 🎮 Gamer Mode ║
║ [2] 🛍️ Store Mode ║
║ [3] 🤖 Swarm Mode ║
║ [4] 🛠️ MCP Mode ║
║ [5] 👑 Queen Seraphina ║
║ ║
╚════════════════════════════════════════╝- Daily challenges with rUv rewards
- Weekly tournaments
- Leaderboards
- Achievement system
- Skill progression
- Browse app templates
- Deploy with one command
- Earn royalties from your apps
- Rate and review apps
- Featured collections
- Visual swarm management
- Real-time agent monitoring
- Task orchestration
- Performance metrics
- Topology optimization
| 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- 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
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...
# 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# Interactive CLI:
npx flow-nexus challenge
# Select a challenge, write solution, earn credits# Browse available templates
npx flow-nexus template
# Deploy your choice
# Costs 1-8 rUv depending on templatenpx flow-nexus profile
# Shows:
- Developer level
- rUv credit balance
- Challenges completed
- Apps published
- Achievement badges
- Global rankingnpx flow-nexus achievements
# Unlock badges for:
- First swarm deployed
- 10 challenges completed
- App with 5-star rating
- 1000 rUv earned
- Top 10 leaderboard# General help
npx flow-nexus help
# Command-specific help
npx flow-nexus swarm --help
npx flow-nexus challenge --help# Ask the AI mentor anything
npx flow-nexus chat
# Or use in MCP:
seraphina_chat with message "How do I create a swarm?"Not enough credits?
# Check balance
npx flow-nexus credits balance
# Complete daily challenge for free credits
npx flow-nexus challengeMCP 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 [email protected] -p passwordnpx flow-nexusOne Command. Real Tools. Actual Results.
- 📚 Documentation: fnx.ruv.io
- 🐛 Issues: GitHub
- 📧 Support: [email protected]
Built with ❤️ by rUv