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

Suparagent: lập đội đồng nghiệp AI tự chạy, có duyệt trước khi làm — cài và dùng

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

Bài này là một góc nhìn khác về Anil-matcha/suparagent — 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: Suparagent: nhóm đồng nghiệp AI tự host, bạn duyệt mới chạy — hướng dẫn cài đặt và dùng →

Suparagent: lập đội đồng nghiệp AI tự chạy, có duyệt trước khi làm — cài và dùng

Tóm tắt nhanh

Suparagent là ứng dụng mã nguồn mở (Python, giấy phép Apache-2.0) để tạo các «đồng nghiệp AI» có tên, nhiệm vụ, trí nhớ và lịch chạy riêng. Bạn chạy nó trên máy mình hoặc tự dựng server, dùng engine AI sẵn có như Claude Code, Codex hay Ollama. Cài bản desktop từ mã nguồn cần Node.js 22+ và uv, khá dễ nếu bạn quen terminal.

Suparagent là một không gian làm việc mã nguồn mở, nơi bạn tạo ra các «đồng nghiệp AI»: mỗi agent có tên, có công việc riêng, có thư mục làm việc riêng và có trí nhớ riêng. Bạn giao việc, agent làm, và với những hành động quan trọng thì nó dừng lại chờ bạn bấm đồng ý. Dự án tự giới thiệu là bản tự host, thay thế cho các bot AI dạng trợ lý làm việc thay bạn.

Bạn nên xem thử nếu bạn là chủ shop, nhân viên văn phòng hay lập trình viên mới và muốn một nơi gom việc cho AI thay vì mở từng cửa sổ chat rời rạc. Điều đáng giá nhất: dữ liệu hội thoại, ghi chú, lịch chạy nằm trên máy hoặc server của bạn, còn model AI thì bạn tự chọn (Claude Code, Codex, Gemini CLI, Ollama…). Hiện repo có khoảng 7.000 sao và 900 fork, vẫn được cập nhật trong 3 tháng gần đây.

Xem video ngắn bên dưới nếu bạn muốn thấy giao diện trước khi cài. Lưu ý quan trọng ngay từ đầu: Suparagent không kèm sẵn model hay gói đăng ký AI nào. Bạn phải có sẵn một engine hoặc tài khoản nhà cung cấp AI của riêng mình.

Ứng dụng

Anil-matcha/suparagent

Suparagent là không gian làm việc mã nguồn mở để tạo các agent AI có tên, trí nhớ, lịch chạy riêng và chỉ hành động khi bạn đồng ý.

★ 7kPythonApache-2.0
Xem repo trên GitHub
Video giới thiệu suparagentXem trên YouTubeXem trên Facebook

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

Dưới đây là những tính năng chính, mình diễn giải theo lợi ích khi dùng.

  • Tạo agent và nhóm agent. Mỗi agent có tên, vai trò, engine, thư mục làm việc, trí nhớ và mức duyệt riêng. Bạn có thể đặt một agent «trưởng nhóm» để chia việc cho các chuyên viên (ví dụ một người nghiên cứu, một người biên tập). Theo README, trưởng nhóm cần dùng Claude hoặc Codex.
  • Giữ ngữ cảnh lâu dài. Agent lưu ghi chú, nhớ lại các ghi chú và cuộc trò chuyện liên quan, và tìm lại được lịch sử. Bạn xem và sửa được thứ agent nhớ, nên không bị «hộp đen».
  • Chạy việc theo lịch (routine). Bạn đặt việc chạy theo lịch, qua webhook hoặc chạy tay. Mỗi kết quả bạn tự xem lại. Routine không bao giờ tự duyệt hành động thay bạn.
  • Chọn mức tự do cho agent. Có các chế độ: Ask first (hỏi trước), Accept edits (chấp nhận chỉnh sửa), Approve for me (dành cho Claude, Codex, Cursor) và Plan only (chỉ lập kế hoạch). Mọi hoạt động công cụ và quyết định duyệt đều xem lại được trong app.
  • Kết nối ứng dụng. Qua khoá Composio của chính bạn, bạn nối GitHub, Gmail, Google Calendar rồi cấp quyền cho từng agent Claude hoặc Codex. Mọi thay đổi đều chờ bạn duyệt. Ngoài ra có MCP Marketplace để thêm từng công cụ lẻ.
  • Màn hình Today. Gom lại việc cần bạn chú ý: yêu cầu duyệt, câu hỏi từ agent, kết quả routine, lỗi engine, việc đến hạn. Nó có thể hiện cả thư Gmail và lịch ở chế độ chỉ đọc.
  • Bảng công việc và lịch. Giao việc, hẹn chạy một lần, xem lại các cuộc trò chuyện và các lần thử.
  • Kỹ năng và mẫu. Lưu các chỉ dẫn dùng lại (skill) và tạo agent từ mẫu có sẵn.
  • Dùng từ điện thoại. Ghép app điện thoại với server của bạn để chat, dừng câu trả lời, cho phép hoặc từ chối một lệnh công cụ.
  • Làm việc với tệp. Tìm kiếm hội thoại, đính kèm văn bản và ảnh, duyệt hoặc tải tệp trong thư mục làm việc, xuất lịch sử.

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

Theo README, để chạy bản desktop từ mã nguồn bạn cần:

  • Node.js 22 trở lên.
  • uv (công cụ quản lý Python, xem trang tài liệu của uv để cài).
  • Ít nhất một engine có sẵn trên cùng máy. Nếu dùng engine dạng dòng lệnh (CLI), bạn phải cài và đăng nhập nó trước khi mở Suparagent. Nếu dùng engine qua API, bạn cấu hình trong Settings → Engines.
  • Docker chỉ cần khi bạn muốn dùng «máy tính cô lập» cho agent. Đây là tính năng tuỳ chọn.

Các engine được nêu trong README: Claude Code hoặc Codex CLI, Gemini CLI, Google Gemini qua Antigravity, Cursor, agent dòng lệnh khác dùng Agent Client Protocol (ACP), OpenRouter, hoặc API tương thích OpenAI như Ollama và LM Studio. Một số tính năng như nhập ảnh hay máy tính cho agent không phải engine nào cũng hỗ trợ.

Về phần cứng và hệ điều hành, README không nêu yêu cầu cụ thể cho bản desktop. Với self-host server thì README ghi cần máy chủ Linux, HTTPS, và Docker hoặc Node.js cùng uv.

Suparagent không kèm model hay gói đăng ký AI. Bạn tự mang tài khoản, đăng nhập CLI hoặc API key, và dùng model có thể tốn tiền theo nhà cung cấp bạn chọn. Hãy kiểm tra bảng giá của nhà cung cấp trước khi cho agent chạy theo lịch.

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

Mình hướng dẫn cách chạy bản desktop từ mã nguồn, đúng như phần Quick start của README.

  1. Cài Node.js và uvNode.js 22 trở lên, cộng với uv
  2. Chuẩn bị engineCài và đăng nhập một CLI engine, hoặc chuẩn bị API
  3. Tải mã nguồnDùng git clone về máy
  4. Chạy appVào thư mục desktop rồi chạy npm run app
  5. Thiết lập lần đầuChọn engine, workspace và chế độ duyệt

A.Cài Node.js và uv

Bạn cần Node.js bản 22 trở lên và uv. README không đưa lệnh cài hai công cụ này, mà trỏ tới trang tài liệu của uv. Bạn tự cài theo trang chính thức của từng công cụ. Kiểm tra nhanh Node.js đã có chưa bằng lệnh phổ thông sau (mở terminal, trên Windows có thể dùng PowerShell):

Terminal
node --version

Nếu số phiên bản bắt đầu bằng 22 hoặc lớn hơn là ổn.

B.Chuẩn bị một engine

Suparagent không tự có «bộ não». Nếu bạn dùng Claude Code, Codex CLI hay Gemini CLI, hãy cài và đăng nhập nó ngoài Suparagent trước. Việc đăng nhập CLI nằm ở máy bạn, không phải trong Suparagent. Nếu muốn dùng API (OpenRouter, Ollama, LM Studio…), bạn sẽ khai báo sau, trong Settings → Engines. README không ghi lệnh cài từng engine, nên bạn xem hướng dẫn của chính engine đó.

C.Tải mã nguồn và chạy app

Mở terminal ở thư mục bạn muốn đặt dự án (ví dụ thư mục Documents), rồi chạy đúng các lệnh trong README:

Terminal
git clone https://github.com/Anil-matcha/suparagent.git
cd suparagent/desktop
npm run app

Giải thích: lệnh đầu tải mã nguồn về máy, lệnh thứ hai đi vào thư mục desktop, lệnh thứ ba khởi động ứng dụng. Chỗ người mới hay vấp là chạy npm run app sai thư mục. Lệnh này phải chạy bên trong suparagent/desktop, không phải thư mục gốc.

D.Thiết lập lần đầu

Lần mở đầu tiên, app yêu cầu bạn chọn engine, workspace (thư mục làm việc) và chế độ duyệt. Nếu chưa chắc, hãy chọn Ask first để app luôn hỏi bạn trước những hành động cần xin phép.

README cũng nhắc có bản cài đặt sẵn ở trang Releases, nhưng các bản này là thử nghiệm và chưa ký số. Bản cập nhật cũng không tự cài, app chỉ đưa bạn tệp cài đã kiểm SHA-256 để tự mở. Vì vậy, đường chạy từ mã nguồn ở trên là cách rõ ràng nhất theo tư liệu.

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

README không mô tả một dòng chữ cụ thể nào để xác nhận thành công. Cách kiểm tra hợp lý theo các bước nó nêu là:

  1. Ứng dụng mở lên và cho bạn chọn engine, workspace, chế độ duyệt ở lần đầu.
  2. Vào Settings → Engines và xác nhận có một engine ở trạng thái sẵn sàng.
  3. Tạo một agent với tên, nhiệm vụ rõ ràng và một workspace.
  4. Mở chat, gửi một câu đơn giản. Nếu agent trả lời, mọi thứ đã nối thông.

Nếu engine không báo sẵn sàng, quay lại bước đăng nhập CLI hoặc khai báo API.

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

A.Tổng hợp báo cáo tuần cho nhóm làm việc

Bối cảnh: bạn là nhân viên văn phòng, mỗi thứ Sáu phải gom ghi chú và báo cáo trong một thư mục thành bản tóm tắt gửi sếp. README có đúng ví dụ này. Cách làm: tạo một agent trưởng nhóm với engine Claude hoặc Codex, thêm hai chuyên viên (ví dụ «Người nghiên cứu» và «Biên tập»), cho cả ba dùng chung thư mục dự án. Rồi nhờ trưởng nhóm bằng một câu như:

text
Hãy chuẩn bị bản tóm tắt tuần từ các ghi chú và báo cáo trong thư mục này.

Kết quả: trưởng nhóm chia nhỏ việc, giao cho chuyên viên làm trong các cuộc trò chuyện riêng, rồi nhận về để ghép lại. Bạn theo dõi trong chat và duyệt khi cài đặt yêu cầu.

Giao việc cho AI không khó, cái khó là dám để nó làm mà vẫn nắm quyền bấm đồng ý.

Ông T

B.Biến việc lặp lại thành routine

Bối cảnh: sau khi quy trình báo cáo tuần chạy ổn, bạn không muốn nhắc AI mỗi tuần. Bạn tạo một routine chạy theo lịch (hoặc qua webhook, hoặc chạy tay khi cần). Kết quả mỗi lần chạy hiện ra trong app để bạn xem lại, và nếu agent cần xin phép thì nó dừng chờ bạn. Lưu ý: routine chạy ở backend, nên backend phải luôn đang chạy thì lịch mới có tác dụng.

C.Chủ shop theo dõi việc cần xử lý mỗi sáng

Bối cảnh: bạn bán hàng, thư từ và lịch hẹn nằm rải rác. Nối Gmail và Google Calendar qua khoá Composio của bạn, rồi mở màn hình Today. Nó gom yêu cầu duyệt, câu hỏi từ agent, kết quả routine và việc đến hạn vào một chỗ, kèm thư và lịch ở chế độ chỉ đọc. Kết quả: mỗi sáng bạn nhìn một màn hình là biết việc nào cần mình quyết. Lưu ý README nói phần kết nối ứng dụng mới được thử với dịch vụ Composio giả lập, chưa phải dịch vụ thật, nên hãy dùng thận trọng.

D.Lập trình viên dựng đội agent riêng với model chạy cục bộ

Bối cảnh: bạn là dev mới, muốn thử agent mà không gửi dữ liệu ra ngoài. Bạn cấu hình trong Settings → Engines một API tương thích OpenAI như Ollama hoặc LM Studio, tạo agent với một thư mục dự án, đặt chế độ Plan only hoặc Ask first để chỉ xem kế hoạch trước khi cho sửa tệp. Kết quả: bạn có một đồng nghiệp AI làm việc trong thư mục của mình và mọi bước nó định làm đều nằm trong tầm kiểm soát. Nhớ rằng tính năng như trưởng nhóm hay kết nối ứng dụng cần Claude hoặc Codex, không dùng được với mọi engine.

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

App không thấy engine nào sẵn sàng. Nguyên nhân thường là CLI engine chưa đăng nhập, hoặc API chưa khai báo. Đăng nhập CLI ngoài terminal trước, rồi mở lại Suparagent và kiểm tra Settings → Engines.

Lệnh npm run app báo lỗi hoặc không tìm thấy. Hãy chắc bạn đang đứng trong thư mục suparagent/desktop, và Node.js là bản 22 trở lên (kiểm bằng node --version). Kiểm tra uv đã cài chưa. README yêu cầu cả hai.

Agent không dùng được tính năng bạn mong đợi. Nhiều tính năng giới hạn theo engine: trưởng nhóm phải dùng Claude hoặc Codex, ứng dụng kết nối chỉ dùng được với agent Claude hoặc Codex, chế độ Approve for me chỉ cho Claude, Codex, Cursor. Xem bảng khả năng của engine trong tài liệu repo trước khi chọn.

Routine không chạy đúng giờ. Routine chạy ở backend nên backend phải đang chạy. Nếu bạn tắt app hoặc server, lịch sẽ không chạy.

Cài đặt sẵn từ Releases bị cảnh báo hoặc khó cập nhật. README nói các bản cài là thử nghiệm, chưa ký số, và quy trình cập nhật chưa được kiểm tra trọn vẹn. Nếu gặp vấn đề, dùng cách chạy từ mã nguồn hoặc báo lỗi trong GitHub Issues của repo.

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

Điểm mạnh: bạn nắm quyền kiểm soát. Dữ liệu nằm ở máy hoặc server của bạn, khoá API lưu qua Suparagent được mã hoá, và agent chỉ làm những việc bạn cho phép. Bạn được chọn engine, từ Claude, Codex đến model cục bộ. Giấy phép Apache-2.0 cho phép dùng và sửa thoải mái trong phạm vi giấy phép.

Giới hạn: README thẳng thắn nói dự án đang phát triển, bản tự host còn thử nghiệm (một người sở hữu, có thể mời đồng đội), không phải dịch vụ nhiều tổ chức. Bản cài desktop chưa ký số. Ứng dụng điện thoại mới thử trên Android, chưa có iOS, chưa có thông báo đẩy. Docker computers, công cụ trình duyệt và bản macOS gốc đều thử nghiệm. Marketplace MCP, transcribe âm thanh và máy tính đám mây chưa qua kiểm định trên dịch vụ thật.

Chi phí: bản mã nguồn mở không tốn tiền phần mềm, nhưng model AI bạn dùng có thể tốn tiền. Ngoài ra có bản hosted là sản phẩm riêng: gói miễn phí dùng khoá Boat của bạn, các gói trả phí theo README là Starter 15 USD, Standard 49 USD và Pro 99 USD mỗi tháng.

Khi nên chọn cách khác: nếu bạn cần công việc quan trọng chạy ổn định ngay, hoặc cần hệ thống nhiều tổ chức, hoặc cần app trên iOS, thì nên chờ thêm hoặc chọn công cụ trưởng thành hơn. Còn nếu bạn thích tự kiểm soát, muốn thử đội agent có duyệt từng bước và chấp nhận một chút thử nghiệm, Suparagent đáng để cài thử với một thư mục dự án nhỏ trước.

4.2/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

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

Mã nguồn mở theo giấy phép Apache-2.0 nên bạn dùng bản desktop và tự host mà không mất phí phần mềm. Tuy nhiên Suparagent không kèm model AI, bạn tự mang tài khoản hoặc API key và có thể tốn tiền cho nhà cung cấp đó. Bản hosted là sản phẩm riêng, có gói miễn phí dùng khoá Boat của bạn và các gói trả phí 15, 49 hoặc 99 USD mỗi tháng.

Cần GPU để chạy Suparagent không?

Tư liệu không nêu yêu cầu GPU. Suparagent dùng engine bạn chọn như Claude Code, Codex hay API, còn nếu bạn muốn chạy model cục bộ qua Ollama hoặc LM Studio thì phần cứng phụ thuộc vào model đó. README chưa đưa thông số phần cứng cụ thể.

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

Repo có tệp run-desktop.bat ở thư mục gốc và cung cấp bản cài desktop ở trang Releases, nhưng README nói các bản cài chưa ký số và mới được kiểm tra nền tảng hạn chế. Cách chạy từ mã nguồn cần Node.js 22+ và uv. Tư liệu không khẳng định rõ mức hỗ trợ từng hệ điều hành.

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

Với desktop và tự host, hội thoại, ghi chú, routine và cài đặt lưu ở thư mục dữ liệu hoặc cơ sở dữ liệu của chính bạn, còn tệp làm việc nằm trong thư mục bạn giao cho agent. Khoá API lưu qua Suparagent được mã hoá. Tuy vậy, khi agent trả lời, engine nhận lời nhắc và ngữ cảnh của lượt đó, nếu engine là dịch vụ trực tuyến thì dữ liệu đó theo điều khoản của nhà cung cấp.

Agent có tự làm việc nguy hiểm khi tôi không để ý không?

Bạn chọn mức tự do: Ask first để dừng chờ duyệt, Accept edits, Approve for me hoặc Plan only. README nói routine không bao giờ tự duyệt hành động, và các thay đổi qua ứng dụng kết nối đều chờ bạn đồng ý. Dù vậy dự án còn đang phát triển, nên bắt đầu với Ask first.

Suparagent khác gì chat AI thông thường?

Thay vì một cuộc chat đơn lẻ, bạn có các agent có tên, nhiệm vụ, thư mục làm việc, trí nhớ, lịch chạy và quy trình duyệt, cùng bảng việc và màn hình Today. Tư liệu chưa có so sánh trực tiếp với từng công cụ cụ thể. Mô tả của tác giả chỉ nói đây là bản mã nguồn mở, tự host thay thế cho một số bot trợ lý AI.

Có dùng được trên điện thoại không?

Có app điện thoại ghép với server của chính bạn để chat, dừng câu trả lời, cho phép hoặc từ chối lệnh công cụ, tạo và sửa agent. README nói app mới thử trên máy giả lập Android và một điện thoại Android, chưa thử trên iOS, chưa có thông báo đẩy hay bản trên cửa hàng ứng dụng.

Chuyển nhanh tới mục

  1. I.Suparagent làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài Node.js và uv
    2. B.Chuẩn bị một engine
    3. C.Tải mã nguồn và chạy app
    4. D.Thiết lập lần đầu
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Tổng hợp báo cáo tuần cho nhóm làm việc
    2. B.Biến việc lặp lại thành routine
    3. C.Chủ shop theo dõi việc cần xử lý mỗi sáng
    4. D.Lập trình viên dựng đội agent riêng với model chạy cục bộ
  6. VI.Lỗi hay gặp và cách xử lý
  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ỏ.