Resources | The AI Surfer

What is Ruflo?

Ruflo is the #1 ranked project on GitHub right now. It's completely free, open source, and it deploys 60+ AI agents that work together, share memory, and get smarter after every run. The full setup guide is below — it's easier than you think.

→ GitHub Repo: github.com/ruvnet/ruflo

🏄 Lost Before You Even Started?

⚡ Before You Run a Single Command

No terminal. No Claude Code. No idea what npm install does — and that's completely fine.

That's exactly what The AI Surfer is built for.

We train people to become Agent Commanders — people who don't just use AI tools, they deploy and direct them. Terminal basics, Claude Code setup, multi-agent swarms — all of it, step by step, from zero.

Once you have the foundation, setting this up takes under 5 minutes.

→ Join us at theaisurfer.com and become an Agent Commander.

Install Ruflo (Pick One — All Work)

Option 1: Claude Code Plugin (Recommended if you're in Claude Code)

Paste these directly into your Claude Code session:

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-autopilot@ruflo

Option 2: One-Line Install (Terminal)

curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

Option 3: NPX (Quickest way to try it)

npx ruflo@latest init --wizard

Option 4: Global Install

npm install -g ruflo@latest

Option 5: Add as MCP Server in Claude Code

claude mcp add ruflo -- npx -y @claude-flow/cli@latest

After Install — First Run Best Practices

✅ Run the wizard first — npx ruflo@latest init --wizard walks you through your first swarm setup
✅ Start with a real task — don't test with toy prompts. Give it something with actual complexity (a full feature, a codebase audit, a multi-step research task)
✅ Let it run a few times — the collective memory compounds. Run 1 is good. Run 5 is significantly better.
✅ Check your API keys are set — Ruflo routes between models automatically. Make sure your Claude/OpenAI keys are configured so the routing actually works
✅ Install ruflo-intelligence for the self-learning layer: /plugin install ruflo-intelligence@ruflo
✅ Install ruflo-cost-tracker to monitor token usage: /plugin install ruflo-cost-tracker@ruflo
⚠️ Don't install all 32 plugins at once — start with core + swarm, add as needed

What's Actually Happening When You Run It

Queen agents manage the teams and break your task into workstreams
8 tactical worker types handle execution: Researcher, Coder, Analyst, Tester, Architect, Reviewer, Optimizer, Documenter
5 consensus protocols (Raft, BFT, Gossip, CRDT) — agents check each other's work before output moves forward
Shared collective memory — every agent writes back what it learns. The swarm gets smarter across every session
Automatic model routing — simple tasks go to cheap models, complex ones escalate. Up to 50% token reduction, up to 250% more effective Claude usage

You're Now Ready

Paste the commands, run the wizard, give it a real task, and let the swarm work.

The repo: github.com/ruvnet/ruflo The community: theaisurfer.com