ruvnet/ruflo

🌊 The leading agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

GitHub에서 열기 ↗ agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-codingai-skillsautonomous-agentsclaude-codecodexharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript

63,769

GitHub 스타

7,529

포크

TypeScript

언어

MIT

라이선스

2026.07.10

최근 푸시

2026.05.14

별표한 날

AI 분석

설치 난이도: 보통

큐레이터 노트

Ruflo는 복잡한 다중 에이전트 시스템을 구축하려는 개발자에게 강력한 도구입니다. 특히 Claude Code를 사용하는 팀이나 자율 워크플로우가 필요한 프로젝트에 적합합니다. 그러나 단순한 챗봇이나 소규모 프로젝트에는 과도할 수 있습니다.

강점

100개 이상의 특화 에이전트와 35개 이상의 플러그인을 제공하여 매우 풍부한 기능 세트를 자랑합니다.
자가 학습 메모리, 스웜 조정, 에이전트 연합 등 고급 기능을 통해 복잡한 AI 워크플로우를 구축할 수 있습니다.
Claude Code 플러그인과 CLI 설치 두 가지 경로를 제공하여 사용자 유연성을 높였습니다.
MIT 라이선스로 오픈소스이며, 활발한 개발과 커뮤니티 참여가 이루어지고 있습니다.

약점

README가 매우 길고 복잡하여 초보자가 진입 장벽을 느낄 수 있습니다.
일부 기능(예: 웹 UI)이 베타 상태로 표시되어 안정성이 완전히 보장되지 않을 수 있습니다.
의존성이 많고 설정이 복잡하여 경량 프로젝트에는 과도할 수 있습니다.

주의사항

Claude Code 플러그인 경로는 MCP 서버를 등록하지 않으므로 전체 기능을 사용하려면 CLI 설치가 필요합니다.
Windows 사용자는 curl | bash 설치 시 POSIX 셸이 필요하며, npx 명령어를 권장합니다.
프로젝트가 빠르게 발전 중이므로 문서와 실제 동작이 일치하지 않을 수 있습니다.

시작 가이드

README의 빠른 시작 섹션을 따라 Claude Code 플러그인 또는 CLI 설치를 시도해보세요.
제공된 35개 플러그인 목록을 검토하여 프로젝트에 필요한 기능을 파악하세요.
웹 UI 베타(flo.ruv.io)를 탐색하여 다중 모델 채팅 및 MCP 도구 호출을 경험해보세요.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Ruflo Banner

Ruflo

Claude Code 및 Codex를 위한 에이전트 메타-하네스.

</div>

에이전트 = 모델 + 하네스. 모델은 코드를 작성하고, 하네스는 도구, 메모리, 루프, 샌드박스, 제어 기능을 제공하여 실제로 작업할 수 있게 합니다. Ruflo는 하네스입니다 — Claude Code와 Codex 주변의 실행 계층으로, 100개 이상의 특화 에이전트, 조정된 스웜, 자가 학습 메모리, 기계 간 연합 통신, 엔터프라이즈 보안 가드레일을 추가합니다. 따라서 에이전트는 단순히 실행되는 것을 넘어 협업합니다.

npx ruflo init 한 번으로 Claude Code에 신경계를 부여합니다: 에이전트가 스스로 조직화하여 스웜을 형성하고, 모든 작업에서 학습하며, 세션 간에 기억하고, 연합을 통해 데이터 유출 없이 다른 기계의 에이전트와 안전하게 통신합니다. 코드 작성은 계속하고, Ruflo가 조정을 처리합니다.

자가 학습 / 자가 최적화 에이전트 아키텍처

사용자 --> Ruflo (CLI/MCP) --> 라우터 --> 스웜 --> 에이전트 --> 메모리 --> LLM 제공자
                          ^                           |
                          +---- 학습 루프 <-----------+

Ruflo가 처음이신가요? 314개의 MCP 도구나 26개의 CLI 명령어를 배울 필요가 없습니다. init 후에는 평소처럼 Claude Code를 사용하기만 하면 됩니다 — 후크 시스템이 자동으로 작업을 라우팅하고, 성공적인 패턴에서 학습하며, 백그라운드에서 에이전트를 조정합니다.

Claude Flow는 이제 Ruflo입니다 — Rust, 플로우 상태, 그리고 불가피하게 느껴지는 것을 구축하는 것을 좋아하는 rUv가 이름을 지었습니다. "Ru"는 rUv입니다. "flo"는 오전 3시까지 작업하는 것입니다. 내부적으로는 Cognitum.One 에이전틱 아키텍처로 구동되며, 초강력 Rust 기반 AI 엔진, 임베딩, 메모리, 플러그인 시스템을 실행합니다.

</details>

!Ruflo Plugins

빠른 시작

표면 영역이 매우 다른 두 가지 설치 경로가 있습니다. 필요에 따라 선택하세요 (#1744):

	Claude Code 플러그인	CLI 설치 (`npx ruflo init`)
제공하는 것	슬래시 명령어 + 몇 가지 스킬 + 플러그인별 에이전트 정의	전체 Ruflo 루프 — 98개 에이전트, 60개 이상의 명령어, 30개 스킬, MCP 서버, 후크, 데몬
워크스페이스 파일	0개	`.claude/`, `.claude-flow/`, `CLAUDE.md`, 헬퍼, 설정
MCP 서버 등록	아니요 (`memorystore`, `swarm``init` 등 Claude에서 사용 불가)	예
후크 설치	아니요	예
최적 대상	전체 설치를 약속하지 않고 단일 플러그인의 명령어를 시도해보려는 경우	프로덕션 사용 — 문서화된 모든 기능이 작동

경로 A — Claude Code 플러그인 (라이트, 슬래시 명령어만)

# 마켓플레이스 추가
/plugin marketplace add ruvnet/ruflo

# 코어 및 필요한 플러그인 설치
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo

이것은 슬래시 명령어와 에이전트 정의만 추가합니다. Ruflo MCP 서버는 등록되지 않으므로 memorystore, swarminit, agent_spawn 등을 Claude에서 호출할 수 없습니다. 전체 루프를 사용하려면 아래 경로 B를 사용하세요.

코어 및 오케스트레이션

	플러그인	기능
	ruflo-core	기반 — 서버, 상태 확인, 플러그인 검색
	ruflo-swarm	여러 에이전트를 팀으로 조정
	ruflo-autopilot	에이전트가 루프에서 자율적으로 실행되도록 함
	ruflo-loop-workers	타이머로 백그라운드 작업 예약
	ruflo-workflows	재사용 가능한 다단계 작업 템플릿
	ruflo-federation	다른 기계의 에이전트가 안전하게 협업

메모리 및 지식

	플러그인	기능
	ruflo-agentdb	에이전트 메모리를 위한 빠른 벡터 데이터베이스
	ruflo-rag-memory	스마트 검색 — 하이브리드 검색, 그래프 홉, 다양성 순위
	ruflo-rvf	세션 간 에이전트 메모리 저장 및 복원
	ruflo-ruvector	`ruvector` — GPU 가속 검색, Graph RAG, 103개 도구
	ruflo-knowledge-graph	엔터티 관계 맵 구축 및 탐색

지능 및 학습

	플러그인	기능
	ruflo-intelligence	에이전트가 과거 성공에서 학습하고 더 똑똑해짐
	ruflo-graph-intelligence	서브선형 그래프 추론 — PageRank, 델타 업데이트, 복잡성 인식 실행 (ADR-123)
	ruflo-daa	동적 에이전트 행동 및 인지 패턴
	ruflo-ruvllm	로컬 LLM 실행 (Ollama 등) 스마트 라우팅 포함
	ruflo-goals	큰 목표를 계획으로 분해하고 진행 상황 추적

코드 품질 및 테스팅

	플러그인	기능
	ruflo-testgen	누락된 테스트를 찾아 자동 생성
	ruflo-browser	Playwright로 브라우저 테스트 자동화
	ruflo-jujutsu	git diff 분석, 위험 점수, 리뷰어 추천
	ruflo-docs	문서 자동 생성 및 유지 관리

보안 및 규정 준수

	플러그인	기능
	ruflo-security-audit	취약점 및 CVE 스캔
	ruflo-aidefence	프롬프트 인젝션 차단, PII 감지, 안전 스캐닝

아키텍처 및 방법론

	플러그인	기능
	ruflo-adr	아키텍처 결정을 라이브 기록으로 추적
	ruflo-ddd	도메인 주도 설계 스캐폴딩 — 컨텍스트, 애그리게이트, 이벤트
	ruflo-sparc	품질 게이트가 있는 5단계 개발 방법론 가이드
	ruflo-metaharness	에이전트 설정 평가, 도구 구성 보안 위험 스캔, 시간 경과에 따른 변경 사항 추적 (가이드)
	ruflo-arena	경쟁 룰리올로지 — 토너먼트에서 에이전트 전략을 겨루고, 승자를 언덕 오르기 및 공진화 (ADR-147/148)

DevOps 및 관찰 가능성

	플러그인	기능
	ruflo-migrations	데이터베이스 스키마 변경을 안전하게 관리
	ruflo-observability	구조화된 로그, 트레이스, 메트릭을 한 곳에
	ruflo-cost-tracker	토큰 사용량 추적, 예산 설정, 비용 알림

확장성

	플러그인	기능
	ruflo-agent	에이전트 실행 — 로컬 WASM 샌드박스 (rvagent) + Anthropic Claude Managed Agents (클라우드)
	ruflo-plugin-creator	자체 플러그인 스캐폴딩, 검증, 게시

도메인 특화

	플러그인	기능
	ruflo-iot-cognitum	IoT 장치 관리 — 신뢰 점수, 이상 탐지, 플릿
	ruflo-neural-trader	`neural-trader` — 4개 에이전트, 백테스팅, 112개 이상의 도구를 갖춘 AI 트레이딩
	ruflo-market-data	시장 데이터 수집, OHLCV 벡터화, 패턴 감지

</details>

CLI 설치

macOS / Linux / WSL / Git-Bash:

# 한 줄 설치 (POSIX 셸 전용 — Windows 참고 사항 아래 참조)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

모든 플랫폼 (네이티브 Windows PowerShell / cmd 포함):

# 대화형 설정 마법사 — 모든 플랫폼에서 동일하게 실행
npx ruflo@latest init wizard

# 빠른 비대화형 초기화
# npx ruflo@latest init

# 또는 전역 설치
npm install -g ruflo@latest

💡 Windows 사용자: curl... | bash 형식은 POSIX 셸 (Git-Bash, WSL, MSYS)이 필요합니다. npx ruflo@latest init wizard 줄은 PowerShell과 cmd에서 기본적으로 작동합니다. 'bash' is not recognized 오류가 발생하면 대신 npx 줄을 사용하세요 — 둘 다 동일한 init 흐름을 실행합니다.

MCP 서버

# Claude Code에서 Ruflo를 MCP 서버로 추가 (정식 형식, USERGUIDE.md와 일치)
claude mcp add ruflo -- npx ruflo@latest mcp start

제공 기능

	기능	설명
	🤖 100개 이상의 에이전트	코딩, 테스팅, 보안, 문서, 아키텍처를 위한 특화 에이전트
	📡 통신 계층	제로 트러스트 연합 — 기계/조직 간 에이전트가 안전하게 검색, 인증, 작업 교환
	🐝 스웜 조정	계층형, 메시형, 적응형 토폴로지와 합의
	🧠 자가 학습	SONA 신경 패턴, ReasoningBank, 궤적 학습
	💾 벡터 메모리	HNSW 인덱스 AgentDB — N=20k에서 약 1.9배 빠름, N=5k에서 약 3.2–4.7배 빠름 (recall@10 ~0.99); ANN은 교차점 이상에서 우세, 작은 N에서는 동률/패배. 감사 + `scripts/benchmark-intelligence.mjs` 참조
	⚡ 백그라운드 워커	12개의 자동 트리거 워커 (감사, 최적화, 테스트 갭 등)
	🧩 플러그인 마켓플레이스	33개의 네이티브 Claude Code 플러그인 + 21개의 npm 플러그인
	🔌 다중 제공자	Claude, GPT, Gemini, Cohere, Ollama 스마트 라우팅 포함
	🛡️ 보안	AIDefence, 입력 검증, CVE 수정, 경로 탐색 방지
	🌐 에이전트 연합	제로 트러스트 보안을 통한 교차 설치 에이전트 협업
	🔬 MetaHarness	배포 전 AI 에이전트 설정 감사. 준비 상태 등급 (1-100), 도구 구성 보안 문제 스캔, 전체 프로젝트 스냅샷 생성하여 시간 경과에 따른 회귀 포착, 저장소와 일치하는 템플릿 찾기. `ruflo eject`는 ruflo 프로젝트를 자체 이름을 가진 독립형 에이전트 도구 키트로 변환합니다. 전체 가이드.
	💬 웹 UI 베타	flo.ruv.io에서 다중 모델 채팅, 병렬 MCP 도구 호출 및 브라우저 내 WASM 도구 갤러리
	🎯 RuFlo Research	goal.ruv.io의 GOAP A* 플래너 — 일반 영어 목표 → 실행 가능한 에이전트 계획, /agents에서 라이브 에이전트 대시보드

웹 UI (베타) — 자체 호스팅 가능, 호스팅 데모 at flo.ruv.io

RuFlo의 웹 UI는 내장된 Model Context Protocol (MCP) 지원을 갖춘 다중 모델 AI 채팅입니다.

원본 저장소: ruvnet/ruflo

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.