Bỏ qua tới nội dung
Ông T.vn

SparkyFitness: theo dõi ăn uống, tập luyện, sức khoẻ cả nhà tự host — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật

Bài này là một góc nhìn khác về CodeWithCJ/SparkyFitness — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: SparkyFitness: theo dõi sức khoẻ cả nhà, tự cài — hướng dẫn cài đặt và dùng →

SparkyFitness: theo dõi ăn uống, tập luyện, sức khoẻ cả nhà tự host — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

SparkyFitness là nền tảng theo dõi sức khoẻ và thể hình tự host, gồm máy chủ, web, app iOS/Android và app cho đồng hồ. Bạn dùng nó thay MyFitnessPal hay Hevy mà dữ liệu vẫn nằm trên máy của mình. Cài bằng Docker Compose theo README, không quá khó nếu bạn đã quen terminal.

SparkyFitness là một nền tảng theo dõi sức khoẻ và thể hình do bạn tự chạy trên máy chủ của mình. Nó gồm máy chủ (API và lưu dữ liệu), giao diện web, app di động cho iOS và Android, cùng app đi kèm cho Apple Watch và Wear OS. README mô tả nó là lựa chọn "ưu tiên quyền riêng tư" thay cho MyFitnessPal, Flo, Hevy, Shotsy và các app tương tự.

Vấn đề nó giải quyết khá quen thuộc. Mỗi mảng sức khoẻ (ăn uống, tập gym, giấc ngủ, chu kỳ, thuốc) thường nằm ở một app riêng, mỗi app một gói trả phí, và dữ liệu thì nằm trên máy chủ của người khác. SparkyFitness gom tất cả vào một chỗ, chạy trên hạ tầng bạn kiểm soát, và cho cả nhà dùng chung.

Ai nên dùng? Người đã quen chạy Docker ở nhà hoặc trên VPS, muốn theo dõi sức khoẻ cho cả gia đình mà không đăng ký nhiều app. Điểm đáng giá nhất là sự gói gọn: một app lo ăn uống, tập luyện, ngủ, nhịn ăn, đồng bộ từ đồng hồ, phân quyền trong gia đình, và có cả chatbot AI (đang beta). Repo hiện có khoảng 6.772 sao và 468 fork, vẫn được cập nhật trong vài tháng gần đây.

Ứng dụng

CodeWithCJ/SparkyFitness

SparkyFitness là ứng dụng tự host để theo dõi ăn uống, tập luyện, giấc ngủ, cân nặng cho cả gia đình, dữ liệu nằm trên máy chủ của bạn.

★ 6.8kTypeScript
Xem repo trên GitHub

I.SparkyFitness làm được gì

Mình tóm các tính năng chính theo kiểu "dùng để làm gì" cho dễ hình dung.

  • Theo dõi nhiều mảng trong một app. Dinh dưỡng, tập luyện, uống nước, giấc ngủ, nhịn ăn, tâm trạng và số đo cơ thể. Bạn không phải mở ba bốn app rồi tự ghép số liệu.
  • Đặt mục tiêu và check-in hằng ngày. Hợp với người cần một thói quen nhỏ mỗi sáng hoặc mỗi tối, ví dụ ghi cân nặng và lượng nước.
  • Biểu đồ tương tác và báo cáo dài hạn. README ghi lịch sử đầy đủ và báo cáo theo khoảng ngày tuỳ chọn đều miễn phí. Bạn nhìn được xu hướng cân nặng hay lượng ăn qua nhiều tháng.
  • Nhiều hồ sơ và chia sẻ trong gia đình. Mỗi người một hồ sơ, có phân quyền chi tiết (bảng so sánh trong README nói có 7 loại quyền). Phần "Family & Friends" hiện vẫn ở dạng beta.
  • App Apple Watch và Wear OS. Xem mục tiêu, ghi nước, cân nặng, nhịn ăn, thuốc, bài tập và có cả complication trên mặt đồng hồ.
  • Đồng bộ từ nhiều dịch vụ. README liệt kê Apple Health, Google Health Connect, Fitbit, Garmin Connect, Withings, Polar Flow, Oura, Hevy, Strava (mới thử nghiệm một phần), COROS và một số dịch vụ khác. Bước, buổi tập, giấc ngủ, cân nặng sẽ tự về máy chủ của bạn.
  • Cơ sở dữ liệu thực phẩm và công thức. Có OpenFoodFacts, USDA, Fatsecret, Nutritionix, Mealie, Tandoor và vài nguồn khác. Bạn tìm món rồi ghi nhanh thay vì tự nhập calo.
  • Đăng nhập an toàn. Hỗ trợ OIDC, TOTP, Passkey, MFA.
  • Nhập CSV và xuất dữ liệu. README ghi có nhập CSV và xuất dữ liệu miễn phí, nên bạn khó bị "nhốt" dữ liệu.
  • SparkyAI (beta). Chat để ghi bữa ăn, bài tập, chỉ số cơ thể, số bước; gửi ảnh món ăn để ghi tự động; giữ lịch sử hội thoại. Bảng so sánh còn nhắc tới MCP server và việc dùng LLM của riêng bạn, nhưng README chính không hướng dẫn chi tiết phần này.

Về giấy phép, README nói rõ đây là "source-available, không phải mã nguồn mở": giấy phép phi thương mại, dùng thương mại cần xin phép. Dùng cá nhân hoặc trong gia đình thì không vướng, còn định đem đi kinh doanh thì bạn nên đọc kỹ file LICENSE trong repo.

II.Cần chuẩn bị gì

README không có mục "yêu cầu hệ thống" riêng, nên mình chỉ nêu những gì cách cài trong README ngầm cần:

  • Docker và Docker Compose. Cách cài chính dùng docker compose. README không ghi phiên bản tối thiểu.
  • Một máy chạy được Docker. Có thể là máy tính cá nhân, máy chủ ở nhà hoặc VPS. README chưa nêu yêu cầu RAM, CPU hay ổ cứng, và cũng không nói cần GPU.
  • Terminal hỗ trợ curl và mkdir. Các lệnh trong README viết theo kiểu bash. Trên Windows, README chưa hướng dẫn riêng. Gợi ý của mình: dùng Git Bash hoặc WSL cho chắc, vì PowerShell có cách gọi curl khác.
  • Công cụ openssl nếu bạn tự sinh khoá bằng lệnh. Còn nếu dùng trình tạo .env trên web thì không cần.
  • Điện thoại iOS hoặc Android nếu muốn dùng app di động. README chỉ dẫn sang trang wiki của repo cho từng hệ điều hành, chưa nói chi tiết cách cài app.
  • Tài khoản bên thứ ba (Garmin, Fitbit, Oura…) chỉ cần khi bạn muốn đồng bộ dữ liệu từ các dịch vụ đó. Muốn dùng SparkyAI thì README chưa nói rõ cần khoá API nào, bạn xem thêm trong trang tài liệu của dự án.

Máy chủ sẽ từ chối khởi động nếu bạn để nguyên các giá trị mẫu trong file .env. Đây là chủ ý của tác giả để tránh việc cơ sở dữ liệu dùng mật khẩu đã công khai. Đừng chia sẻ file .env của bạn cho ai.

III.Cài đặt từng bước

README đưa ra hai hướng: tự host bằng Docker Compose, hoặc dùng bản cloud của bên thứ ba cho người không rành kỹ thuật. Bài này đi theo hướng tự host.

  1. Tạo thư mụcTạo thư mục sparkyfitness và đi vào trong
  2. Tải docker-compose.ymlTải file cấu hình chạy chính thức về
  3. Tạo file .envDùng trình tạo trên web hoặc tải file mẫu
  4. Điền giá trị bảo mậtThay mật khẩu và khoá còn là chỗ trống
  5. Khởi độngKéo image và chạy nền bằng Docker Compose
  6. Mở ứng dụngVào địa chỉ http://localhost:3004

A.Tạo thư mục làm việc

Mở terminal (nhớ là terminal kiểu bash như đã nói ở trên) rồi tạo một thư mục riêng cho SparkyFitness. Mọi file sau đó đều nằm trong thư mục này.

Terminal
mkdir sparkyfitness && cd sparkyfitness

mkdir tạo thư mục, cd đi vào thư mục đó. Chỗ người mới hay vấp: chạy các lệnh sau ở nhầm thư mục thì docker compose sẽ không tìm thấy file cấu hình.

B.Tải file docker-compose.yml

Lệnh dưới tải file cấu hình production từ repo và lưu thành docker-compose.yml.

Terminal
curl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml

C.Tạo file .env

README đưa ba lựa chọn.

Cách A (README khuyên dùng): mở trình tạo .env trên trình duyệt, nó sinh sẵn các khoá bảo mật chỉ bằng một cú bấm: https://codewithcj.github.io/SparkyFitness/install/env-generator. Bạn tải file về và đặt tên là .env trong thư mục sparkyfitness.

Cách B: bản mẫu tối giản, chỉ 5 giá trị, còn lại dùng mặc định mà docker-compose đã áp dụng. README nói đủ cho phần lớn người tự host.

Terminal
curl -L -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.simple.example

Cách C: bản đầy đủ, liệt kê mọi biến hỗ trợ (đang được comment kèm giá trị mặc định). Chọn cách này nếu bạn cần SSO, SMTP, cơ sở dữ liệu ngoài hoặc reverse proxy. Trong README lệnh này đang để dạng comment, bạn bỏ dấu # nếu muốn dùng:

Terminal
curl -L -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.example

D.Điền các giá trị bảo mật

Nếu bạn dùng cách A thì bỏ qua bước này, vì trình tạo đã điền sẵn. Với cách B hoặc C, mở file .env bằng trình soạn thảo và thay các chỗ giữ chỗ. README liệt kê bốn mục:

Terminal
#   SPARKY_FITNESS_DB_PASSWORD        any strong password
#   SPARKY_FITNESS_API_ENCRYPTION_KEY openssl rand -hex 32     (64 hex chars)
#   BETTER_AUTH_SECRET                openssl rand -base64 32  (44 chars)
#   SPARKY_FITNESS_FRONTEND_URL       the URL you will open the app at

Cụ thể:

  • SPARKY_FITNESS_DB_PASSWORD: một mật khẩu mạnh bất kỳ do bạn đặt.
  • SPARKY_FITNESS_API_ENCRYPTION_KEY: chạy openssl rand -hex 32 và dán kết quả (64 ký tự hex).
  • BETTER_AUTH_SECRET: chạy openssl rand -base64 32 và dán kết quả (44 ký tự).
  • SPARKY_FITNESS_FRONTEND_URL: địa chỉ bạn sẽ gõ trên trình duyệt để mở app, ví dụ địa chỉ máy chủ của bạn.

Lưu ý: sinh khoá xong thì giữ lại bản sao ở nơi an toàn. Đổi hoặc mất khoá mã hoá sau này có thể gây rắc rối cho dữ liệu đã lưu (phần này README không nói chi tiết, nên bạn đọc thêm tài liệu trước khi đổi).

E.Khởi động ứng dụng

Terminal
docker compose pull && docker compose up -d

docker compose pull tải các image về. docker compose up -d khởi động các dịch vụ chạy nền. Lần đầu có thể mất một lúc vì phải tải image.

F.Mở ứng dụng

Mở trình duyệt và vào:

Terminal
http://localhost:3004

Nếu bạn cài trên VPS thì thay localhost bằng địa chỉ máy chủ, và nhớ giá trị SPARKY_FITNESS_FRONTEND_URL trong .env nên khớp với địa chỉ này. Muốn đặt sau reverse proxy, README chỉ sang trang tài liệu của dự án.

IV.Kiểm tra đã chạy được chưa

Cách kiểm tra theo README rất đơn giản: sau khi chạy docker compose up -d, mở http://localhost:3004 và thấy giao diện web của SparkyFitness hiện ra là thành công. README không mô tả chi tiết màn hình đầu tiên, nên mình không đoán thêm.

Nếu trang không lên, hai lệnh Docker phổ thông này giúp bạn xem tình hình (không phải lệnh riêng của repo):

Terminal
docker compose ps
docker compose logs

docker compose ps cho biết các container có đang chạy không. docker compose logs in nhật ký, thường nói rõ lý do nếu máy chủ không khởi động, ví dụ vì còn giá trị mẫu chưa thay trong .env.

V.Dùng vào việc thật

Dưới đây là vài tình huống mình thấy hợp với những gì README mô tả. Phần thao tác trong giao diện bạn sẽ tự khám phá khi dùng, vì README chưa hướng dẫn từng màn hình.

A.Gia đình bốn người cùng theo dõi sức khoẻ

Bối cảnh: vợ chồng muốn theo dõi cân nặng và bữa ăn, ông bà muốn ghi thuốc và huyết áp, con muốn ghi buổi tập. Trước đây mỗi người một app, mỗi app một khoản đăng ký.

Cách làm: bạn cài SparkyFitness một lần trên máy chủ ở nhà, tạo hồ sơ cho từng người và dùng tính năng chia sẻ để người lớn xem được hồ sơ của người thân khi cần. Mỗi người cài app di động của mình trỏ về cùng máy chủ. Kết quả: cả nhà có một nơi duy nhất, dữ liệu nằm trên máy của bạn. Phần "Family & Friends" vẫn là beta nên hãy thử trước khi dựa hẳn vào nó.

Một app, một máy chủ của riêng bạn, cả nhà cùng dùng — dữ liệu sức khoẻ không cần đi đâu cả.

Ông T

B.Người tập gym kết hợp đồng hồ thông minh

Bối cảnh: bạn đeo đồng hồ Garmin hoặc Fitbit, ghi buổi tập bằng Hevy, và ăn uống thì ghi ở một app khác. Số liệu rời rạc nên khó nhìn được "tuần này ngủ ít thì tập có kém đi không".

Cách làm: bật các tích hợp (Garmin Connect, Fitbit, Hevy…) trong SparkyFitness để bước chân, giấc ngủ và buổi tập tự đổ về. Ghi thêm bữa ăn bằng cơ sở dữ liệu thực phẩm có sẵn. Kết quả: biểu đồ và báo cáo dài hạn đặt các chỉ số cạnh nhau. Cách thiết lập từng tích hợp nằm ở trang tài liệu của dự án, README chưa viết chi tiết.

C.Chủ shop bận rộn muốn ghi bữa ăn nhanh bằng chat

Bối cảnh: bạn bận bán hàng cả ngày, không có thời gian mở app nhập từng món. Bạn chỉ muốn chụp ảnh đĩa cơm rồi xong.

Cách làm: dùng SparkyAI (đang beta). Theo README, bạn có thể ghi món ăn, bài tập, chỉ số cơ thể, số bước bằng cách chat, và tải ảnh món ăn lên để ghi tự động. Bạn có thể thử một câu như "Trưa nay mình ăn một đĩa cơm gà và một ly trà đá, ghi giúp mình". Kết quả mong đợi là bữa ăn được ghi vào nhật ký. Vì là beta nên bạn nên kiểm tra lại số liệu do AI ghi. README cũng chưa nói rõ cần cấu hình nhà cung cấp AI nào.

D.Dev hoặc người mê dữ liệu muốn sở hữu dữ liệu của mình

Bối cảnh: bạn từng bị khoá dữ liệu ở một app trả phí và không xuất ra được lịch sử.

Cách làm: chuyển sang SparkyFitness, nhập dữ liệu cũ bằng CSV (README ghi có hỗ trợ) và xuất ra khi cần. Repo còn có sẵn script sao lưu cơ sở dữ liệu (db_backup.sh ở thư mục gốc), nhưng README chưa hướng dẫn cách dùng, nên bạn đọc nội dung file trước khi chạy. Kết quả: dữ liệu của bạn nằm trong tay bạn, sao lưu và di chuyển được.

VI.Lỗi hay gặp và cách xử lý

A.Máy chủ không chịu khởi động

Nguyên nhân hay gặp nhất, theo chính README: bạn chưa thay các giá trị giữ chỗ trong .env. Máy chủ cố tình từ chối chạy. Cách xử lý: mở .env, điền đủ mật khẩu cơ sở dữ liệu, SPARKY_FITNESS_API_ENCRYPTION_KEY, BETTER_AUTH_SECRET và SPARKY_FITNESS_FRONTEND_URL, rồi chạy lại docker compose up -d. Xem docker compose logs để chắc chắn.

B.Không mở được http://localhost:3004

Kiểm tra bằng docker compose ps xem container có chạy không. Nếu bạn cài trên VPS, localhost sẽ không đúng, hãy dùng địa chỉ của máy chủ. Cũng cần xem cổng 3004 có bị app khác chiếm hoặc bị tường lửa chặn không (đây là suy luận chung, README không nói riêng về lỗi này).

C.Lệnh curl không chạy trên Windows

Nhiều người dùng PowerShell gặp lỗi vì curl ở đó là bí danh của lệnh khác. Cách an toàn là chạy các lệnh trong Git Bash hoặc WSL, hoặc tải thẳng hai file về bằng trình duyệt rồi đặt đúng tên docker-compose.yml và .env trong thư mục làm việc.

D.Nâng cấp xong bị lỗi

README cảnh báo rõ: dự án đang phát triển tích cực và có thể có thay đổi phá vỡ tương thích giữa các bản phát hành. Vì vậy README khuyên không nên tự động cập nhật container, và luôn đọc ghi chú phát hành trước khi nâng cấp. Mình khuyên bạn sao lưu dữ liệu trước mỗi lần nâng cấp.

E.Tính năng beta chạy chưa ổn

Chatbot AI, Family & Friends và tài liệu API được README liệt vào nhóm beta, có thể còn lỗi hoặc chưa đầy đủ. Đừng giao việc quan trọng cho các tính năng này. Gặp lỗi thì báo ở phần issues/discussion của repo, hoặc vào Discord của dự án như README gợi ý.

VII.Có nên dùng không

Điểm mạnh. Gói gọn nhiều mảng trong một app. Dữ liệu nằm trên máy chủ bạn kiểm soát. Hỗ trợ nhiều dịch vụ đồng bộ, có app di động và app đồng hồ, có nhập/xuất dữ liệu, có đăng nhập an toàn nhiều lớp. Cài đặt tương đối nhanh nếu bạn đã quen Docker. Repo vẫn được cập nhật đều.

Giới hạn. Bạn phải tự vận hành máy chủ, tự sao lưu và tự nâng cấp. Dự án đang phát triển nhanh nên có thể có thay đổi phá vỡ tương thích. Một số tính năng quan trọng (chatbot AI, chia sẻ gia đình) còn beta. Giấy phép là phi thương mại, nên đừng dùng nó cho dịch vụ kinh doanh nếu chưa xin phép tác giả. README cũng chưa nêu yêu cầu phần cứng cụ thể. Một lưu ý nữa: bảng so sánh trong README do chính dự án viết, nên hãy đọc nó với con mắt tỉnh táo, tác giả cũng nói vậy.

Khi nào chọn cách khác. Nếu bạn không muốn đụng tới Docker và máy chủ, hãy chọn một app có sẵn trên cửa hàng ứng dụng, hoặc xem tuỳ chọn cloud do bên thứ ba cung cấp mà README nhắc tới (README không nêu tên cụ thể nên bạn cần tự tìm hiểu kỹ). Nếu bạn chỉ cần một mảng, như ghi calo hoặc ghi buổi tập, một app chuyên dụng có thể gọn hơn. Còn nếu bạn muốn dữ liệu sức khoẻ của cả nhà nằm trong tay mình, SparkyFitness đáng để thử.

4.8/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

SparkyFitness có miễn phí không?

README nói không có đăng ký trả phí và không có quảng cáo, báo cáo lịch sử đầy đủ cũng miễn phí. Giấy phép là phi thương mại: dùng thương mại cần xin phép tác giả. Chi phí máy chủ để chạy nó (nếu bạn thuê VPS) thì README không đề cập.

Có cần GPU không?

README không nêu yêu cầu GPU hay phần cứng nào. Cách cài chính chỉ là Docker Compose. Nếu bạn muốn dùng tính năng AI thì cần xem thêm tài liệu của dự án để biết cách cấu hình, vì README chưa nói rõ.

Chạy được trên Windows không?

README chưa có hướng dẫn riêng cho Windows. Các lệnh cài đặt viết theo kiểu bash và dùng Docker Compose. Cách an toàn là dùng Git Bash hoặc WSL để chạy các lệnh đó. Phần này là gợi ý của mình, không phải khẳng định từ README.

Dữ liệu của tôi có an toàn không?

Theo README, dữ liệu sức khoẻ được lưu trên hạ tầng bạn kiểm soát, không phụ thuộc dịch vụ bên thứ ba. Dự án hỗ trợ OIDC, TOTP, Passkey và MFA, và bắt buộc bạn đặt khoá, mật khẩu riêng trước khi chạy. Độ an toàn thực tế vẫn phụ thuộc vào cách bạn vận hành máy chủ và sao lưu.

SparkyFitness khác gì MyFitnessPal hay Hevy?

Điểm khác chính là tự host và gom nhiều mảng (ăn uống, tập luyện, ngủ, nhịn ăn, thuốc) vào một app cho cả gia đình. Bảng so sánh trong README cho thấy nhiều app kia là dịch vụ trả phí và dữ liệu nằm ở máy chủ của họ. Cần lưu ý bảng này do chính dự án viết, nên nên đối chiếu thêm.

Có app trên điện thoại và đồng hồ không?

Có. README nói dự án có app di động cho iOS và Android, cùng app đi kèm cho Apple Watch và Wear OS. README dẫn sang trang wiki của repo để xem hướng dẫn cho iOS và Android. Chi tiết cách cài app trên điện thoại chưa có trong README chính.

Tôi không rành kỹ thuật thì làm sao?

README có nhắc một lựa chọn cloud cho người không rành kỹ thuật, do các nhà cung cấp bên thứ ba triển khai. README không nêu tên và nói rõ đó là dịch vụ độc lập, bạn nên tự tìm hiểu kỹ. Bạn cũng có thể hỏi trong Discord hoặc phần issues của dự án.

Chuyển nhanh tới mục

  1. I.SparkyFitness làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Tạo thư mục làm việc
    2. B.Tải file docker-compose.yml
    3. C.Tạo file .env
    4. D.Điền các giá trị bảo mật
    5. E.Khởi động ứng dụng
    6. F.Mở ứng dụng
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Gia đình bốn người cùng theo dõi sức khoẻ
    2. B.Người tập gym kết hợp đồng hồ thông minh
    3. C.Chủ shop bận rộn muốn ghi bữa ăn nhanh bằng chat
    4. D.Dev hoặc người mê dữ liệu muốn sở hữu dữ liệu của mình
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Máy chủ không chịu khởi động
    2. B.Không mở được http://localhost:3004
    3. C.Lệnh curl không chạy trên Windows
    4. D.Nâng cấp xong bị lỗi
    5. E.Tính năng beta chạy chưa ổn
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.