LibreAI / AI Agents / ruflo
// agents · ruvnet/ruflo

ruflo

Agent harness for multi-agent swarms: deploy, coordinate and federate autonomous workflows

★ 74.1k stars⑂ 8.8k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

ruflo is an open-source ai agents project by ruvnet (ruvnet/ruflo on GitHub). It has 74,132 GitHub stars and 8,810 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

Repository
ruvnet/ruflo
GitHub stars
74,132
Forks
8,810
License
MIT
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want from ruflo and check the README and requirements to confirm it fits your setup and TypeScript environment.

  2. Get the code

    Clone the repository from GitHub (github.com/ruvnet/ruflo) or use the documented install channel if you do not need the source.

  3. Install and configure

    Follow the README quickstart to install dependencies and set any required configuration or credentials.

  4. Run your first task

    Work through the README's first example end to end, then adapt it to your own project or data.

// features

Why people love it

Multi-agent swarms

Deploy intelligent multi-player swarms that coordinate autonomous workflows.

Adaptive memory

Agents learn from experience with adaptive, persistent memory across sessions.

Federation

Agents on different machines can securely coordinate, described as federation in the README.

Vector RAG integration

Integrates vector retrieval so agents can search project knowledge.

Claude Code and Codex native

Ships as Claude Code plugins, a CLI install, and an MCP server (98 agents, 60+ commands per the README).

Console

A console to inspect runs, search logs, triage failures and replay agent work.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Start by getting the source and entering the project directory.

    git clone https://github.com/ruvnet/ruflo.git
    cd ruflo
  2. Set up with the wizard

    Run the setup wizard in your project terminal.

    npx ruflo@latest init wizard
  3. Or connect as an MCP server

    Configure your MCP client with command npx and args -y ruflo@latest mcp start.

    npx -y ruflo@latest mcp start
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains ruflo?

It is maintained by ruvnet and contributors on GitHub, where the repository github.com/ruvnet/ruflo is the canonical home for code, issues and releases.

Is ruflo free to use?

Yes — it is open source under the MIT license. Read the license in the repository for what is permitted, including any conditions on redistribution or commercial use.

Does it need a paid API key?

No Ruflo key — agents run through Claude Code or your MCP client using your own account or keys.

How does ruflo compare to alternatives?

Compared with single-agent Claude Code: Ruflo adds swarm coordination, shared memory and federation on top of a single-agent harness.

How do I get started?

Clone github.com/ruvnet/ruflo, follow the README quickstart to install it, and run the documented first example before adapting it to your own work.

// keep exploring

Similar tools

AI Agents

astron-agent

iFLYTEK's enterprise agentic workflow platform — SuperAgents with workflows, RPA and one-click deploy.

★ 8.9k starsApache-2.0
View guide →
AI Agents

fastagency

Take multi-agent AutoGen workflows to production, fast.

★ 547 starsApache-2.0
View guide →
AI Agents

Raven

The harness of harnesses: a persistent, self-evolving multi-agent ecosystem built for RSI.

★ 5.3k starsApache-2.0
View guide →
Agents

lime

Full-stack AI agent for coding, research, content, and multi-agent workflows.

★ 1.5k starsCustom
View guide →
AI Agents

prime-agent

A self-improving agent for coding workflows and long-running autonomous tasks

★ 21.6k starsNOASSERTION
View guide →
AI Agents

pentagi

Autonomous AI agents for penetration testing — self-hosted, multi-agent, with a full web UI

★ 25.3k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if ruflo is not the right fit.

Get ruflo

Free and open — grab the source, star the repo, and start creating.