\n\n[](https://cognitum.one/agentic-engineering)\n\n\n[](https://flo.ruv.io/)\n[](https://www.npmjs.com/package/ruflo)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/ruvnet/claude-flow)\n\n\n[](https://goal.ruv.io/)\n[](https://goal.ruv.io/agents)\n[](https://github.com/ruvnet/ruvector)\n[](https://github.com/ruvnet/ruflo/blob/main/data/clone-data.proof.json)\n[](https://github.com/ruvnet/ruflo/blob/main/data/clone-data.ledger.json)\n[](https://github.com/ruvnet/claude-flow)\n[](https://www.npmjs.com/package/@claude-flow/codex)\n\n# Ruflo\n\n**An agent meta-harness for Claude Code and Codex.**\n\n
\n\n### Web UI (Beta) β self-hostable, hosted demo at [flo.ruv.io](https://flo.ruv.io/)\n\n**RuFlo's web UI is a multi-model AI chat with built-in Model Context Protocol (MCP) tool calling.** Talk to Qwen, Claude, Gemini, or OpenAI while RuFlo invokes the same MCP tools the CLI uses β agent orchestration, persistent memory, swarm coordination, code review, GitHub ops β directly from chat. No install, no API key needed to try it.\n\n| | What it is | Why it matters |\n|---|------------|----------------|\n| π§ | **Any model, local or remote** | 6 curated frontier models out-of-the-box β Qwen 3.6 Max (default), Claude Sonnet 4.6, Claude Haiku 4.5, Gemini 2.5 Pro, Gemini 2.5 Flash, OpenAI β via OpenRouter. Add your own: any OpenAI-compatible endpoint (vLLM, Ollama, LM Studio, Together, Groq, self-hosted). |\n| π¦Ύ | **ruvLLM self-learning AI** | Native support for [ruvLLM](https://github.com/ruvnet/RuVector/tree/main/examples/ruvLLM) (lives in `ruvnet/RuVector/examples/ruvLLM`) β RuFlo's self-improving local model layer. Routes to MicroLoRA adapters, learns from your trajectories via SONA, and stays on your machine. Pair with the cloud models or run fully offline. |\n| π οΈ | **~210 tools, ready to call** | 5 server groups (Core, Intelligence, Agents, Memory, DevTools) plus an 18-tool gallery that runs entirely in your browser β works offline. |\n| π | **Bring your own MCP servers** | Click the **MCP (n)** pill in the chat input β *Add Server* and paste any MCP endpoint (HTTP, SSE, or stdio). Your tools join RuFlo's native ones in the same parallel-execution flow. Run a local MCP server on `localhost:3000` and it just works. |\n| β‘ | **Tools run in parallel** | One model response can fire 4β6+ tools at the same time. The UI shows them as cards with a *Step 1 β 2 tools completed* badge so you can see exactly what ran. |\n| πΎ | **Memory that sticks** | Say *\"remember my favorite color is indigo\"* and ask weeks later β RuFlo recalls it. Backed by AgentDB + HNSW vector search (measured ~1.9xβ4.7x faster than brute force above the crossover, recall@10 ~0.99). |\n| π | **Built-in capabilities tour** | Click the question-mark icon in the sidebar β a \"RuFlo Capabilities\" modal opens with the full tool list, model strengths, architecture, and keyboard shortcuts. |\n| π | **Self-hostable** | Web UI is shipped as Docker (`ruflo/src/ruvocal/Dockerfile`) with embedded Mongo. Deploy to your own Cloud Run / Fly / Kubernetes / docker-compose. The hosted [flo.ruv.io](https://flo.ruv.io/) demo is one option; running your own is fully supported. |\n| π | **Zero install to try** | Open the hosted URL, pick a model, type a question. That's the whole onboarding. |\n\n**Try the hosted demo:** [https://flo.ruv.io/](https://flo.ruv.io/) β no account, no API key. **Run your own:** the source lives in [`ruflo/src/ruvocal/`](ruflo/src/ruvocal/) with a multi-stage Dockerfile (`INCLUDE_DB=true` builds in MongoDB) and a `cloudbuild.yaml` for Google Cloud Run. See [ADR-033](ruflo/docs/adr/ADR-033-RUVOCAL-WASM-MCP-INTEGRATION.md) for the architecture and [issue #1689](https://github.com/ruvnet/ruflo/issues/1689) for the roadmap.\n\n
\n\n### Goal Planner UI β autonomous agents at [goal.ruv.io](https://goal.ruv.io/)\n\n**Turn high-level goals into executable agent plans.** `goal.ruv.io` is RuFlo's hosted Goal-Oriented Action Planning (GOAP) front-end β describe an outcome in plain English and watch RuFlo decompose it into preconditions, actions, and an A* path through state space, then dispatch the work to live agents at [`/agents`](https://goal.ruv.io/agents).\n\n| | What it is | Why it matters |\n|---|------------|----------------|\n| π― | **Plain-English goals** | Type *\"ship the auth refactor with tests and a PR\"* β RuFlo extracts the success criteria, the constraints, and the implicit preconditions. No JSON, no DSL. |\n| π§ | **GOAP A\\* planner** | Classic gaming-AI planning ported to software work: state-space search through actions with preconditions/effects to find the shortest viable path. Replans on the fly when state changes. |\n| π€ | **Live agent dashboard** | [goal.ruv.io/agents](https://goal.ruv.io/agents) shows every spawned agent β role, current step, memory namespace, token budget, status. Click in to inspect trajectories, kill runaway workers, or reassign. |\n| π³ | **Visual plan tree** | Goals render as collapsible action trees with progress, blocked branches, and rollbacks highlighted. See *exactly* why an agent picked a path β no opaque chain-of-thought. |\n| β»οΈ | **Adaptive replanning** | When an action fails or new info arrives, the planner re-runs A\\* from the current state instead of restarting. Failures become learning, not loops. |\n| π§ | **Shared memory + SONA** | Plans, trajectories, and outcomes flow into AgentDB. Future plans retrieve past solutions via HNSW β the planner gets smarter with every run. |\n| π | **Wired to MCP tools** | Every action node maps to a tool call (RuFlo's ~210 MCP tools, your custom servers, or shell). The planner schedules them in parallel where the dependency graph allows. |\n| π | **Zero install to try** | Open [goal.ruv.io](https://goal.ruv.io/), describe a goal, watch it run. Source lives in [`v3/goal_ui/`](v3/goal_ui/) β Vite + Supabase, self-hostable. |\n\n**Try it:** [https://goal.ruv.io/](https://goal.ruv.io/) for goals Β· [https://goal.ruv.io/agents](https://goal.ruv.io/agents) for live agents. **Run your own:** clone the `goal` branch and `cd v3/goal_ui && npm install && npm run dev`.\n\n### Agent Federation β Slack for Agents\n\n```\nYour Agent --> [ Remove secrets ] --> [ Sign message ] --> [ Encrypted channel ]\n Emails, SSNs, Proves it came No one reads it\n keys stripped from you in transit\n |\n v\nTheir Agent <-- [ Block attacks ] <-- [ Check identity ] <------+\n Stops prompt Rejects forgeries\n injection\n\n Audit trail on both sides.\n Trust builds over time. Bad behavior = instant downgrade.\n```\n\nSlack gave teams channels. Federation gives agents the same thing β **shared workspaces across trust boundaries**, where agents on different machines, orgs, or cloud regions can discover each other, prove who they are, and collaborate on tasks.\n\nThe difference: some channels are trusted, some aren't. [`@claude-flow/plugin-agent-federation`](https://github.com/ruvnet/ruflo/issues/1669) handles that automatically. Your agents join a federation, get verified via mTLS + ed25519, and start exchanging work β with PII stripped before anything leaves your node and every message auditable. Untrusted agents can still participate at lower privilege: they see discovery info, not your memory. As they prove reliable, trust upgrades. If they misbehave, they get downgraded instantly β no human in the loop required.\n\nYou don't configure handshakes or manage certificates. You `federation init`, `federation join`, and your agents start talking. The protocol handles identity, the PII pipeline handles data safety, and the audit trail handles compliance.\n\n> **π Full user guide:** [`docs/federation/`](./docs/federation/) β setup, MCP tools, trust levels, circuit breaker, and the (opt-in) WireGuard mesh layer that ties packet-layer reachability to federation trust. ADR-111 deep-dive at [`docs/federation/phase7-mesh-bringup.md`](./docs/federation/phase7-mesh-bringup.md).\n\n\nFederation capabilities\n\n| | Capability | How it works |\n|---|---|---|\n| π | **Zero-trust federation** | Remote agents start untrusted. Identity proven via mTLS + ed25519 challenge-response. No API keys, no shared secrets. |\n| π‘οΈ | **PII-gated data flow** | 14-type detection pipeline scans every outbound message. Per-trust-level policies: BLOCK, REDACT, HASH, or PASS. Adaptive calibration reduces false positives. |\n| π | **Behavioral trust scoring** | Formula (`0.4Γsuccess + 0.2Γuptime + 0.2Γthreat + 0.2Γintegrity`) continuously evaluates peers. Upgrades require history; downgrades are instant. |\n| π | **Compliance built-in** | HIPAA, SOC2, GDPR audit trails as compliance modes. Every federation event produces a structured record searchable via HNSW. |\n| π€ | **9 MCP tools + 10 CLI commands** | Full lifecycle: `federation_init`, `federation_send`, `federation_trust`, `federation_audit`, and more. |\n\n\n\n\nExample: two teams sharing fraud signals without sharing customer data\n\n```bash\n# Team A: initialize federation and generate keypair\nnpx claude-flow@latest federation init\n\n# Team A: join Team B's federation endpoint\nnpx claude-flow@latest federation join wss://team-b.example.com:8443\n\n# Team A: send a task β PII is stripped automatically before it leaves\nnpx claude-flow@latest federation send --to team-b --type task-request \\\n --message \"Analyze transaction patterns for account anomalies\"\n\n# Team A: check peer trust levels and session health\nnpx claude-flow@latest federation status\n```\n\n\n\nSee [issue #1669](https://github.com/ruvnet/ruflo/issues/1669) for the complete architecture, trust model, and implementation roadmap.\n\n```bash\n# Claude Code plugin\n/plugin install ruflo-federation@ruflo\n\n# Or via CLI\nnpx claude-flow@latest plugins install @claude-flow/plugin-agent-federation\n```\n\n\nClaude Code: With vs Without Ruflo\n\n| Capability | Claude Code Alone | + Ruflo |\n|------------|-------------------|---------|\n| Agent Collaboration | Isolated, no shared context | Swarms with shared memory and consensus |\n| Coordination | Manual orchestration | Queen-led hierarchy (Raft, Byzantine, Gossip) |\n| Memory | Session-only | HNSW vector memory with sub-ms retrieval |\n| Learning | Static behavior | SONA self-learning with pattern matching |\n| Task Routing | You decide | Intelligent routing (89% accuracy) |\n| Background Workers | None | 12 auto-triggered workers |\n| LLM Providers | Anthropic only | 5 providers with failover |\n| Security | Standard | CVE-hardened with AIDefence |\n\n\n\n\nArchitecture overview\n\n```\nUser --> Claude Code / CLI\n |\n v\n Orchestration Layer\n (MCP Server, Router, 27 Hooks)\n |\n v\n Swarm Coordination\n (Queen, Topology, Consensus)\n |\n v\n 100+ Specialized Agents\n (coder, tester, reviewer, architect, security...)\n |\n v\n Memory & Learning\n (AgentDB, HNSW, SONA, ReasoningBank)\n |\n v\n LLM Providers\n (Claude, GPT, Gemini, Cohere, Ollama)\n```\n\n\n\n---\n\n## Documentation\n\nFour docs for four audiences:\n\n| Doc | When to read it |\n|-----|-----------------|\n| **[Status](docs/STATUS.md)** | See what currently works β capability counts, test baselines, recent fixes, what's next. The *is-it-ready* doc. |\n| **[User Guide](docs/USERGUIDE.md)** | Daily reference β every command, every config flag, every plugin. The *how-do-I* doc. |\n| **[MetaHarness Guide](docs/metaharness-user-guide.md)** | How to grade your agent setup, scan tool configs for security, detect changes between runs, and eject a project into a standalone agent toolkit. The *audit-my-setup* doc. |\n| **[Benchmarks](https://gist.github.com/ruvnet/298f8c668c8859b369f91734a0e9cbbe)** | v3.8.0 SOTA matrix vs LangGraph / AutoGen / CrewAI on darwin-arm64 + linux-x64. ruflo wins cold start, single turn, RSS by 1.3Γβ1953Γ. The *is-it-fast* doc. |\n| **[Verification](verification.md)** | Cryptographically prove your installed bytes match the signed witness β `ruflo verify`. The *trust-but-verify* doc. |\n| **[Team Gateway Checklist](docs/TEAM-GATEWAY-CHECKLIST.md)** | Before-merge gates, dual-mode handoff, memory namespace sharing, and witness manifest entry per merge. The *safer-team-workflows* doc. |\n\nBenchmark internals (for reproduction): [`sota-workload-spec.md`](https://github.com/ruvnet/ruflo/blob/perf/sota-comparator-benchmarks/docs/benchmarks/sota-workload-spec.md) Β· [`SOTA-PROGRESS.md`](https://github.com/ruvnet/ruflo/blob/perf/sota-comparator-benchmarks/docs/benchmarks/SOTA-PROGRESS.md) Β· [raw matrix JSON: darwin](https://github.com/ruvnet/ruflo/blob/perf/sota-comparator-benchmarks/docs/benchmarks/sota-matrix.json) Β· [linux](https://github.com/ruvnet/ruflo/blob/perf/sota-comparator-benchmarks/docs/benchmarks/sota-matrix-linux.json)\n\nUser Guide section index:\n\n| Section | Topics |\n|---------|--------|\n| [Quick Start](docs/USERGUIDE.md#quick-start) | Installation, prerequisites, install profiles |\n| [Core Features](docs/USERGUIDE.md#-core-features) | MCP tools, agents, memory, neural learning |\n| [Intelligence & Learning](docs/USERGUIDE.md#-intelligence--learning) | Hooks, workers, SONA, model routing |\n| [Swarm & Coordination](docs/USERGUIDE.md#-swarm--coordination) | Topologies, consensus, hive mind |\n| [Security](docs/USERGUIDE.md#%EF%B8%8F-security) | AIDefence, CVE remediation, validation |\n| [Ecosystem](docs/USERGUIDE.md#-ecosystem--integrations) | RuVector, agentic-flow, Flow Nexus |\n| [Configuration](docs/USERGUIDE.md#%EF%B8%8F-configuration--reference) | Environment variables, config schema |\n| [Plugin Marketplace](https://ruvnet.github.io/ruflo) | Browse and install plugins |\n\n---\n\n## Support\n\n| Resource | Link |\n|----------|------|\n| Documentation | [User Guide](docs/USERGUIDE.md) |\n| Issues & Bugs | [GitHub Issues](https://github.com/ruvnet/claude-flow/issues) |\n| Enterprise | [ruv.io](https://ruv.io) |\n| Community | [Agentics Foundation Discord](https://discord.com/invite/dfxmpwkG2D) |\n| Powered by | [Cognitum.one](https://cognitum.one) |\n\n## License\n\nMIT - [RuvNet](https://github.com/ruvnet)\n",
"bytes": 29898,
"sha": "c7fd1828983ea5a378460432d40a7bb7317e87ae8481ef6f05cc8c90e0baa702",
"repo_slug": "ruvnet/ruflo",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/skl_ruvnet_ruflo_pair_programming_4e80966c/readme"
}
![\"RuFlo](\"v3/docs/assets/ruVocal.png\")
\n \n![\"goal.ruv.io/agents](\"v3/docs/assets/goal.png\")
\n \n