Ruflo: Framework Agent AI Cho Claude Code
/ruflo
Ruflo là một agent meta-harness gắn thêm khả năng phối hợp swarm, bộ nhớ bền vững, và federation đa agent lên trên Claude Code và Codex thay vì thay thế chúng. Hãy dùng nếu bạn đã chạy Claude Code hàng ngày và muốn các agent phối hợp với nhau, nhớ lại phiên làm việc trước; bỏ qua nếu bạn chỉ cần một trợ lý code duy nhất hoạt động gọn gàng, vì bề mặt plugin ở đây đủ lớn để làm bạn chậm lại trước khi nó thực sự giúp ích.
Tìm Hiểu Về Agent Meta-Harness Của Ruflo
Ruflo là một agent meta-harness cho Claude Code và Codex, thiết lập chỉ bằng một lệnh `npx ruflo init` để thêm hooks, một MCP server, và một daemon agent vào dự án. Theo README, Ruflo xếp chồng hơn 100 agent chuyên biệt và khả năng phối hợp swarm theo các topology hierarchical, mesh, và adaptive lên trên model bạn dùng, thêm hệ thống bộ nhớ tự học tên AgentDB, và có federation tùy chọn để agent trên các máy khác nhau trao đổi công việc.
Các Tính Năng Cốt Lõi Của Ruflo
- ✓Hơn 100 agent chuyên biệt cho việc code, kiểm thử, bảo mật, viết tài liệu, và kiến trúc, được phối hợp qua các topology swarm hierarchical, mesh, hoặc adaptive có đồng thuận, theo README.
- ✓AgentDB, một kho bộ nhớ vector đánh chỉ mục HNSW mà README nói được đo nhanh hơn khoảng 1.9 lần so với tìm kiếm brute-force ở N=20k và nhanh hơn 3.2-4.7 lần ở N=5k, với recall@10 khoảng 0.99.
- ✓Các mẫu neural SONA và một ReasoningBank tạo nên thứ README gọi là tự học: agent dựa vào các trajectory tác vụ trước đó thay vì bắt đầu lại từ số 0 mỗi phiên.
- ✓12 background worker tự kích hoạt cho các việc như audit và tìm test gap, theo README.
- ✓Federation cho phép agent trên các máy khác nhau tham gia một mạng zero-trust, xác thực bằng mTLS và ed25519, và trao đổi công việc qua một pipeline phát hiện PII gồm 14 loại, loại bỏ dữ liệu nhạy cảm trước.
- ✓Một Web UI bản beta tại flo.ruv.io chạy chat đa model (Qwen, Claude, Gemini, OpenAI) với khoảng 210 MCP tool gọi song song, và được đóng gói dưới dạng Docker image tự host được.
- ✓MetaHarness chấm điểm mức độ sẵn sàng của một setup agent trên thang 1-100 và quét cấu hình tool để tìm vấn đề bảo mật; lệnh `ruflo eject` có thể biến một dự án Ruflo thành một bộ công cụ độc lập.
- ✓Một chợ plugin — README liệt kê 35 plugin trải khắp bộ nhớ, kiểm thử, audit bảo mật, DevOps, và các mảng riêng như quản lý thiết bị IoT và giao dịch tài chính.
Cài Đặt Và Thiết Lập Ruflo
Ruflo có hai cách cài đặt được ghi trong README, và đây không phải cùng một thứ. Cách plugin chạy bên trong Claude Code: thêm marketplace bằng `/plugin marketplace add ruvnet/ruflo`, rồi cài những gì bạn cần, ví dụ `/plugin install ruflo-core@ruflo` hoặc `/plugin install ruflo-swarm@ruflo`. Cách này thêm slash command và định nghĩa agent nhưng, theo README, không ghi file nào vào workspace của bạn, và chỉ đăng ký MCP server nếu `ruflo-core` nằm trong số plugin bạn chọn. Để có đầy đủ vòng lặp — 98 agent, hơn 60 command, 30 skill, một MCP server, hooks, và một daemon, theo bảng so sánh của chính README — chạy `npx ruflo@latest init wizard` để thiết lập tương tác hoặc `npx ruflo@latest init` cho kiểu không tương tác; người dùng macOS, Linux, WSL, và Git-Bash cũng có thể chạy `curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash`. Đường cài CLI này tạo ra `.claude/`, `.claude-flow/`, và một `CLAUDE.md` trong dự án của bạn. Để đăng ký Ruflo như một MCP server độc lập, README đưa ra lệnh `claude mcp add claude-flow -- npx ruflo@latest mcp start`.
Làm Việc Với Agent Và Swarm Của Ruflo
Hàng ngày, README nói bạn không cần đụng trực tiếp vào phần bên trong của Ruflo: sau `npx ruflo init`, bạn cứ dùng Claude Code như bình thường, và một hệ thống hooks sẽ định tuyến tác vụ, học từ những gì đã hiệu quả, và phối hợp agent ở nền. README nói rõ bạn không cần nhớ 314 MCP tool hay 26 CLI command đi kèm. Federation hoạt động khác và cần lệnh tường minh: `federation init` sinh ra một keypair, `federation join wss://<peer>` kết nối tới endpoint của một team khác, và `federation send --to <peer> --type task-request --message "..."` chuyển giao một tác vụ, với PII được loại bỏ tự động trước khi rời khỏi máy bạn. Web UI là một điểm truy cập riêng. Mở flo.ruv.io, chọn một model, và bắt đầu chat — không cần cài đặt hay API key cho bản demo được host sẵn.
Ứng Dụng Thực Tế Của Ruflo
- •Chạy một phiên Claude Code tự sinh ra các sub-agent cho từng phần việc, thay vì bạn tự tay chia việc ra nhiều đoạn chat riêng.
- •Giữ lại ngữ cảnh dự án và kết quả các tác vụ trước qua AgentDB, thay vì phải giải thích lại codebase mỗi lần mở lên.
- •Chia sẻ công việc giữa các agent trên máy hoặc tổ chức khác nhau qua federation, với PII bị loại bỏ trước khi bất cứ thứ gì vượt ranh giới.
- •Kiểm tra bảo mật cho một setup agent AI đang dùng bằng plugin MetaHarness trước khi đưa vào sử dụng thật.
- •Thử nhiều model hàng đầu trên cùng một bộ MCP tool từ một giao diện chat duy nhất qua Web UI, không cần cài đặt gì.
Ruflo Phù Hợp Với Ai?
Ruflo hướng tới nhà phát triển đã dùng Claude Code hoặc Codex hàng ngày và muốn nhiều hơn một trợ lý chỉ hoạt động trong một phiên: các team làm việc agent nhiều bước cần bộ nhớ sống sót qua lần khởi động lại, hoặc muốn nhiều agent cùng giải quyết một vấn đề song song thay vì một agent duy nhất. Nó cũng hợp với ai tò mò về việc agent hợp tác với nhau xuyên nhiều máy, vì federation là một tính năng chính chứ không phải thêm vào cho có. Đây là lựa chọn tệ nếu bạn muốn một setup tối giản — cài CLI đầy đủ đưa hooks, một daemon, và nhiều file cấu hình vào dự án của bạn, còn riêng chợ plugin đã liệt kê 35 plugin để lựa.
Điểm mạnh
- ✓Hai cách cài đặt thay vì một: thử slash command của một plugin duy nhất, không ghi file nào vào workspace, trước khi quyết định cài đầy đủ qua CLI.
- ✓Bộ nhớ và khả năng học không phải là ý tưởng thêm vào cho có — AgentDB, SONA, và ReasoningBank là các cơ chế cụ thể, có tên riêng trong README, chứ không phải lời quảng cáo mơ hồ kiểu "nhớ ngữ cảnh".
- ✓Federation đi kèm cơ chế bảo mật cụ thể trên giấy tờ: định danh bằng mTLS cộng ed25519, một pipeline PII gồm 14 loại, và các chính sách BLOCK/REDACT/HASH/PASS theo từng mức độ tin cậy.
- ✓Giấy phép MIT, nên không có ràng buộc copyleft hay hạn chế nào cản việc dùng cho mục đích thương mại.
- ✓Web UI và Goal Planner tự host được qua Docker thay vì bị khoá vào bản demo host sẵn tại flo.ruv.io và goal.ruv.io.
Những Điều Cần Cân Nhắc Khi Dùng Ruflo
- △README không đưa ra tín hiệu nào về độ trưởng thành ngoài số sao — không có lịch sử phát hành, chính sách versioning, hay cam kết ổn định nào cho một dự án có bề mặt cài đặt lớn thế này (98 agent, hơn 60 command, 30 skill chỉ riêng đường CLI).
- △Cài đặt CLI đầy đủ không hề gọn nhẹ: nó ghi `.claude/`, `.claude-flow/`, một `CLAUDE.md`, hooks, và một daemon vào dự án của bạn — nhiều thứ để áp dụng và sau này gỡ bỏ hơn một dependency đơn lẻ.
- △Một số ví dụ CLI trong README vẫn dùng tên lệnh `claude-flow` (ví dụ `npx claude-flow@latest federation init`) song song với các ví dụ `npx ruflo@latest` mới hơn ở chỗ khác, một dấu vết còn sót lại từ việc dự án đổi tên từ Claude Flow, có thể khiến người đọc không rõ lệnh nào mới là hiện hành.
- △Các con số tốc độ của AgentDB gắn với benchmark cụ thể, đo ở N=20k và N=5k so với brute-force search, và chính README nói cách tiếp cận này 'hoà hoặc thua ở N nhỏ', nên mức tăng tốc không phải lúc nào cũng đúng.
- △Công thức chấm điểm tin cậy và cơ chế phát hiện PII của federation được mô tả trong README nhưng không thể xác minh độc lập chỉ từ các dữ kiện của repo, nên bạn đang tin vào lời kể của chính dự án cho tới khi tự đọc code.
So Sánh Ruflo Với Các Framework Agent Khác
Câu Hỏi Thường Gặp Về Ruflo
Ruflo được phát hành theo giấy phép MIT, theo repository GitHub của dự án.
README mô tả khả năng định tuyến đa nhà cung cấp qua Claude, GPT, Gemini, Cohere, và Ollama, còn Web UI riêng cung cấp model Qwen, Claude, Gemini, và OpenAI qua OpenRouter cùng bất kỳ endpoint tương thích OpenAI nào như vLLM hay LM Studio.
Agent của Ruflo hợp tác được xuyên nhiều máy qua tính năng federation: chúng tham gia một mạng zero-trust, xác thực lẫn nhau bằng mTLS và ed25519, và trao đổi công việc với PII bị loại bỏ trước khi rời khỏi máy gốc, theo README.
Web UI của Ruflo tự host được. README nói nó được đóng gói dưới dạng Docker image với tùy chọn MongoDB nhúng sẵn, triển khai được lên Cloud Run, Fly, Kubernetes, hoặc docker-compose, tách biệt với bản demo host sẵn tại flo.ruv.io.
Ruflo lưu bộ nhớ agent trong AgentDB, một cơ sở dữ liệu vector đánh chỉ mục HNSW, và xếp thêm các mẫu neural SONA cùng một ReasoningBank lên trên để agent dựa vào trajectory tác vụ trước đó thay vì bắt đầu lại từ đầu mỗi phiên.
Ruflo có plugin AIDefence để chặn prompt injection và phát hiện PII, plugin security-audit để quét CVE, và plugin MetaHarness chấm điểm mức độ sẵn sàng bảo mật của một setup agent trên thang 1-100, theo README.
Vấn đề Ruflo giải quyết
Các phiên làm việc của Claude Code và Codex chạy như những vòng lặp tách biệt: mỗi lần bắt đầu lại từ đầu, quên hết những gì đã xảy ra ở lần trước, và không có cách nào sẵn có để chia một tác vụ cho nhiều agent hoặc để agent trên các máy khác nhau trao đổi thông tin mà không cần bạn dán lại ngữ cảnh bằng tay. README của Ruflo đặt dự án quanh khoảng trống đó, tự mô tả mình là nửa "harness" trong công thức "Agent = Model + Harness" — lớp bộ nhớ, định tuyến, và giao tiếp giữa các agent mà một model đơn lẻ không tự có.
Repo liên quan
Vẫn đang phân vân về ruflo?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về ruflo.