ruvnet/ruflo

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

Ruflo – Claude Code 및 Codex를 위한 "에이전트 메타하네스"

Ruflo는 대규모 언어 모델(LLM) 에이전트(특히 Claude Code 플러그인을 통해 Anthropic의 Claude) 주변에 위치하는 프레임워크이며, 완전 기능의 실행 환경을 제공합니다. CLI, 플러그인 집합, 웹 UI, 페더레이션 계층을 통합하여 다양한 전문 에이전트들이 협업하고, 과거 작업을 기억하며, 다른 머신의 에이전트와 안전하게 소통할 수 있도록 합니다.

기본 제공 기능

기능	당신에게 의미하는 바
100개 이상의 사전 구축 에이전트	코딩, 테스팅, 보안 스캔, 문서화, 아키텍처, 거래, IoT 등에 사용 가능한 사전 구축 에이전트
스웜 협조	계층적 또는 메시 구조의 "스웜"으로 에이전트를 조직하여 합의 도출 및 작업 공유 가능
자기학습 루프	에이전트는 성공/실패를 기록하고, 시스템은 내부 모델(SONA 신경 패턴, ReasoningBank)을 업데이트하여 미래 행동을 개선
벡터 메모리 (AgentDB)	지속적이고 HNSW 인덱스가 적용된 임베딩을 통해 세션 간 사실을 기억 가능 (예: "내가 좋아하는 색깔 기억해")
페더레이션	제로 트러스트, 인증된 통신을 통해 다른 머신이나 조직의 에이전트가 데이터 유출 없이 협업 가능
다중 제공자 라우팅	Claude, GPT, Gemini, Cohere, Ollama, OpenAI 호환 엔드포인트를 지원하며, 라우터가 각 도구 호출에 가장 적합한 모델을 선택
보안 가드레일	AIDefence, 프롬프트 인젝션 탐지, CVE 스캔, 경로 탐색 보호, "MetaHarness" 감사(전체 에이전트 설정 평가)
플러그인 마켓플레이스	35개 이상의 플러그인(코어, 메모리, 지능, DevOps, 도메인 전용)을 개별 또는 전체 추가 가능
웹 UI (베타)	호스팅된 채팅 UI(`flo.ruv.io`)로, Ruflo가 CLI와 동일한 MCP 도구를 실행합니다. Docker를 통해 자체 호스팅도 가능
목표 계획자 UI	GOAP 스타일의 플래너(`goal.ruv.io`)로 자연어 목표를 A* 탐색 기반 에이전트 계획으로 변환하고 실시간 에이전트 텔레메트리 시각화

시작 방법

라이트 경로 – Claude Code 플러그인
```
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo ruflo-swarm@ruflo …
```
리포지토리에 파일을 생성하지 않고 슬래시 명령어와 몇몇 에이전트 정의를 추가합니다.
풀 경로 – CLI 설치
```
npx ruflo@latest init   # 또는 인터랙티브 워즈드
```
.claude/, .claude-flow/, CLAUDE.md 가이드를 생성하고, CLI와 UI가 통신하는 MCP 서버를 시작합니다.
웹 UI – https://flo.ruv.io/ 열기 (API 키 필요 없음) 또는 ruflo/src/ruvocal/의 Dockerfile을 실행해 자체 호스팅.

일반적인 워크플로우

사용자 → Ruflo CLI (또는 UI) → 라우터 → 스웜 → 개별 에이전트
          ↑                                 │
          └───── 메모리 ↔ 벡터 DB ↔ 지식 그래프
          ↑                                 │
          └───── 학습 루프 (에이전트 정책 업데이트)

"새 기능을 작성하고 테스트를 추가"라고 요청하면, 라우터는 코딩 에이전트, 테스트 생성 에이전트, 보안 감사 에이전트를 생성합니다. 에이전트는 병렬로 실행되며 결과는 벡터 메모리에 저장되고, 학습 루프는 무엇이 효과적이었는지 기록하여 다음 요청이 더 빠르고 저렴해집니다.

누구에게 적합한가

LLM 지원 코딩, 자동 테스팅, 지속적 보안 검사가 필요한 개발 팀 (맞춤형 프롬프트 작성 불필요)
서로 다른 부서나 자회사가 안전하게 AI 작업을 공유할 수 있는 기업 (제로 트러스트 페더레이션 필요)
다중 에이전트 협업, GOAP 계획, 또는 로컬 LLM의 자가 개선(플러그인 ruflo-ruvllm을 통해)을 탐구하는 연구자/애호가

더 많은 정보 찾기

완전 가이드 – RuFlo Explained (14장 구성의 마크다운 워크스루) – docs/ruflo-explained.md.
플러그인 문서 – 각 플러그인은 plugins/에 있으며, 각각 독자적인 README를 보유.
벤치마크 및 감사 – docs/reviews/intelligence-system-audit-2026-05-29.md 및 scripts/ 내 벤치마크 스크립트 참조.
소스 코드 – 리포지토리는 CLI(bin/), MCP 서버, 웹 UI(src/ruvocal/), 플러그인 구현 포함.

요약하면, Ruflo는 CLI와 웹 기반 인터페이스를 갖춘 포괄적이고 확장 가능한 플랫폼으로, LLM을 협업 가능하고 기억 능력이 있으며, 자기 최적화하는 AI 에이전트로 전환합니다.