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를 위한 에이전트 메타하네스

무엇인가요 – Ruf Flo는 대규모 언어 모델 기반 코딩 어시스턴트(Claude Code, Codex) 주변에 위치하는 하네스로, 단일 모델을 완전 기능형 자율 조직 AI 팀으로 전환합니다. CLI, 플러그인 마켓플레이스, 웹 UI를 제공하여 100개 이상의 전문 에이전트, 지속적 벡터 메모리, 스웜 협업, 기계 간 페더레이션, 보안 가드레일을 제공합니다.

작동 방식 – 핵심 루프는 다음과 같습니다:

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

이 하네스는 도구, 루프, 샌드박스, 학습 계층을 추가하여 에이전트가 계획, 기억, 테스트, 개선, 협업할 수 있도록 하며, 사용자는 이러한 세부 사항을 관리할 필요가 없습니다.

주요 기능 (README에 기재된 내용)

기능	제공되는 기능
100개 이상의 에이전트	코딩, 테스트, 보안, 문서화, 아키텍처, 거래, IoT 등에 사용 가능한 미리 만들어진 에이전트
스웜 협업	계층형/메시 구조, 합의, 적응형 라우팅
자기학습 루프	에이전트가 성공 사례를 기록하고 행동을 업데이트 (SONA 패턴, ReasoningBank)
벡터 메모리 (AgentDB)	HNSW 인덱싱 메모리, ~~0.99 recall@10, 5~~20k 항목에서 브루트포스보다 1.9~4.7배 빠름
페더레이션	서로 다른 기계나 조직 간에 제로트러스트, 인증된 통신
다중 제공자 라우팅	Claude, GPT, Gemini, Cohere, Ollama, 사용자 정의 OpenAI 호환 엔드포인트
보안 및 준수	프롬프트 인젝션 가드, PII 탐지, CVE 스캔, 입력 검증
메타하네스 감사	에이전트 설정 평가(1~100), 스냅샷 설정, 회귀 검출 도구
웹 UI (베타)	다중 모델 채팅, 병렬 MCP 도구 호출, 지속적 메모리, Docker 호환 자가 호스팅 배포
목표 계획자 UI	GOAP 스타일의 평이한 영어 목표 분해 → A* 계획 → 실시간 에이전트 실행
플러그인 마켓플레이스	코어, 메모리, 지능, DevOps, 도메인 특화 사용 사례를 커버하는 33개의 Claude Code 플러그인 + 21개의 npm 플러그인

설치 경로

경로	설치 내용	사용 시기
Claude Code 플러그인 (경량)	슬래시 명령어와 소수의 에이전트 정의만 포함. 리포지토리에 파일 추가 없음.	전체 스택에 투자하지 않고 단일 플러그인을 빠르게 시도할 때
풀 CLI 설치 (`npx ruflo init`)	모든 98개 에이전트, 60개 이상의 명령어, MCP 서버, 훅, 데몬, `.claude/` 및 `.claude‑flow/` 설정 파일
	완전한 오케스트레이션 레이어가 필요한 생산 환경에서

CLI 빠른 시작 (macOS/Linux/WSL/PowerShell):

# 단일 명령어 (POSIX 쉘)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
# 또는 크로스 플랫폼
npx ruflo@latest init wizard   # 인터랙티브 위저드
# 비인터랙티브
npx ruflo@latest init

또한 npm i -g ruflo로 전역 설치도 가능합니다.

MCP 서버 등록 (Claude Code용):

claude mcp add claude-flow -- npx ruflo@latest mcp start

생태계 및 플러그인 (선택적 카테고리)

코어 및 오케스트레이션 – ruflo-core, ruflo-swarm, ruflo-autopilot, ruflo-federation.
메모리 및 지식 – ruflo-agentdb, ruflo-rag-memory, ruflo-ruvector (GPU 가속 벡터 검색), ruflo-knowledge-graph.
지능 및 학습 – ruflo-intelligence, ruflic‑graph-intelligence, ruflo-ruvllm (로컬 LLM 라우팅), ruflo-goals.
코드 품질 – ruflo-testgen, ruflo-browser (Playwright), ruflo-jujutsu (git-diff 리스크 스코어링), ruflo-docs.
보안 – ruflo-security-audit, ruflo-aidefence.
메소드론 – ruflo-adr, ruflo-ddd, ruflo-sparc, ruflo-metaharness, ruflo-arena.
DevOps – ruflo-migrations, ruflo-observability, ruflo-cost-tracker.
도메인 특화 – ruflo-iot-cognitum, ruflo-neural-trader, ruflo-market-data.

일반적인 사용 사례

AI 지원 소프트웨어 개발 – 코드 작성, 자동으로 누락된 테스트 생성, 브라우저 기반 통합 테스트 실행, 보안 감사 등 모든 작업을 에이전트가 오케스트레이션.
목표 중심 자동화 – 고수준 목표(예: 새로운 마이크로서비스 출시)를 선언; 목표 계획기가 분해하고, 작업을 에이전트에 할당, 진행 상황 추적.
기업 규모의 에이전트 페더레이션 – 여러 팀이 Ruflo 인스턴스를 운영; 데이터 유출 없이 안전하게 작업을 공유.
자체 호스팅 AI 스택 – 방화벽 뒤에서 웹 UI와 ruvLLM 로컬 모델 스택을 실행하여 완전 오프라인 개발 가능.
금융 기술 또는 IoT 운영 – 도메인 특화 플러그인(neural-trader, iot‑cognitum)을 사용해 자율 거래 봇 또는 플릿 관리 에이전트 구축.

라이선스 및 커뮤니티

라이선스: MIT (배지 참조).
스타 / 다운로드 수: 생태계 다운로드 수 810만 이상, 최근 14일간 약 10.6만 건의 Git 클론 (README에 기재).
문서화: 14장 구성의 "Ruflo Explained" 가이드, ADR, 벤치마크 스크립트, 플러그인 제작용 스크래프트.

결론

Ruflo는 풀스택 플러그인 기반 메타하네스로, Claude Code / Codex를 기억력, 학습 능력, 보안, 기계 간 페더레이션을 갖춘 협업형 AI 팀으로 전환합니다. 호스팅된 UI를 통해 즉시 시도하거나, 단일 npx ruflo init 명령어로 로컬에 설치할 수 있어, 에이전트 소프트웨어 엔지니어링 및 그 이상을 위한 실용적이고 생산 준비 완료된 플랫폼입니다.