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

Suparagent: đồng nghiệp AI có trí nhớ, lịch chạy, cần bạn duyệt — hướng dẫn cài đặt 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: đồng nghiệp AI có trí nhớ, lịch chạy, cần bạn duyệt — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Suparagent là ứng dụng mã nguồn mở (Apache-2.0) để tạo "đồng nghiệp AI": mỗi agent có tên, nhiệm vụ, thư mục làm việc, trí nhớ và chỉ làm việc nhạy cảm sau khi bạn duyệt. Bạn có thể chạy bản desktop từ mã nguồn hoặc tự dựng máy chủ. Cài không quá khó nếu đã có Node.js 22+, uv và một công cụ AI (engine) đã đăng nhập, nhưng dự án còn đang thử nghiệm.

Suparagent là một không gian làm việc mã nguồn mở cho các "đồng nghiệp AI". Bạn tạo ra những agent có tên riêng, giao cho mỗi agent một công việc và một thư mục làm việc, rồi cho chúng phối hợp để hoàn thành việc thật. Hội thoại, trí nhớ, lịch chạy định kỳ và các yêu cầu duyệt đều nằm chung một chỗ. Bạn có thể dùng bản desktop hoặc tự dựng máy chủ riêng.

Repo này hợp với người đã quen dùng AI để hỏi đáp nhưng muốn tiến thêm một bước: có một "nhân viên ảo" nhớ được bối cảnh, chạy việc đều đặn mỗi tuần, và quan trọng nhất là không tự ý làm gì khi bạn chưa gật đầu. Chủ shop, nhân viên văn phòng cần báo cáo định kỳ, hay lập trình viên muốn một nơi quản lý nhiều agent đều có thể thử. Hiện repo có khoảng 7041 sao và 913 fork.

Điểm đáng giá nhất là bạn tự mang "bộ não" đến. Suparagent không kèm sẵn mô hình AI hay gói thuê bao nào. Bạn nối nó với công cụ bạn đang dùng như Claude Code, Codex CLI, Gemini CLI, Cursor, OpenRouter, hoặc một API tương thích OpenAI như Ollama và LM Studio. Dữ liệu cuộc trò chuyện, ghi chú và lịch chạy nằm trên máy hoặc máy chủ của bạn. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước khi cài.

Ứ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 định kỳ 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à các tính năng chính, kèm lợi ích thực tế 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à chế độ 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, hoặc cho nhiều agent họp chung trong một phòng. README ghi trưởng nhóm cần dùng Claude hoặc Codex. Lợi ích: việc lớn được chia nhỏ, mỗi agent lo một mảng, bạn đỡ phải dán qua dán lại giữa các cuộc chat.
  • Giữ ngữ cảnh. Agent có thể lưu ghi chú, nhớ lại ghi chú và hội thoại liên quan, tìm trong lịch sử. Bạn xem và sửa được những gì nó nhớ. Lợi ích: không phải giải thích lại bối cảnh dự án mỗi lần mở chat mới.
  • Chạy việc theo lịch. Tạo "routine" chạy theo giờ, qua webhook hoặc bấm tay. Mỗi kết quả bạn đều xem lại được, và routine không bao giờ tự duyệt hành động thay bạn. Lợi ích: báo cáo tuần, tổng hợp định kỳ có thể giao cho agent làm.
  • 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 và 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. Lợi ích: người mới nên bắt đầu ở mức "hỏi trước" cho an tâm.
  • Kết nối ứng dụng. Qua khoá Composio của chính bạn, nối vớ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 các việc cần bạn để mắt: yêu cầu duyệt, câu hỏi từ agent, kết quả routine, lỗi engine, việc đến hạn. Có thể hiện thêm thư Gmail và lịch ở chế độ chỉ đọc.
  • Bảng việc và lịch. Giao việc, hẹn chạy một lần, xem lại các lần thử.
  • Skill và mẫu agent. Lưu sẵn các bộ hướng dẫn để tái sử dụng, hoặc tạo agent từ mẫu.
  • Dùng từ điện thoại. Ghép app điện thoại với máy chủ của bạn để chat, dừng câu trả lời, cho phép hoặc từ chối một lệnh gọi công cụ.
  • Làm việc với tệp. Tìm hội thoại, đính kèm văn bản và ảnh, nhập âm thanh để chuyển thành chữ (cần bạn đồng ý và có thông tin tài khoản), 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, bản desktop chạy từ mã nguồn và cần:

  • Node.js 22 trở lên.
  • uv (công cụ quản lý Python, trang chủ docs.astral.sh/uv).
  • Ít nhất một engine 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ở app. Nếu muốn dùng engine qua API, cấu hình trong Settings → Engines.
  • Git để tải mã nguồn (lệnh git clone phổ thông).
  • Docker chỉ cần nếu bạn muốn dùng máy tính cô lập cho agent (tính năng tuỳ chọn, còn thử nghiệm).

Về tài khoản: bạn cần tài khoản hoặc khoá API của nhà cung cấp AI mà bạn chọn, và việc dùng mô hình có thể tốn tiền theo nhà cung cấp đó. Với máy chủ tự dựng, README ghi cần máy chủ Linux, HTTPS, Docker hoặc Node.js cùng uv, và một engine. README không nêu yêu cầu cấu hình phần cứng cụ thể (RAM, GPU), nên mình không đoán.

Suparagent không kèm mô hình hay gói AI nào. Prompt, nội dung bạn đính kèm, ghi chú liên quan và các tệp trong thư mục làm việc mà agent đọc sẽ được gửi cho engine bạn chọn. Nếu engine là dịch vụ trên mạng, dữ liệu đó theo điều khoản của nhà cung cấp. Hãy chỉ giao cho agent những thư mục bạn thấy ổn khi chia sẻ.

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

  1. Chuẩn bị công cụCài Node.js 22+, uv và đăng nhập một engine (ví dụ CLI AI bạn đang dùng)
  2. Tải mã nguồnDùng git clone để lấy repo về máy
  3. Vào thư mục desktopMở terminal tại thư mục suparagent/desktop
  4. Chạy ứng dụngGõ npm run app và chờ app mở
  5. Thiết lập lần đầuChọn engine, thư mục làm việc và chế độ duyệt

A.Chuẩn bị Node.js, uv và engine

Mình không chép lệnh cài Node.js hay uv vì README chỉ nói cần phiên bản nào, không đưa lệnh. Bạn cài theo hướng dẫn chính thức của từng công cụ. Kiểm tra nhanh Node.js bằng lệnh phổ thông sau; kết quả phải là số phiên bản từ 22 trở lên.

Terminal
node --version

Với engine dạng CLI như Claude Code hay Codex, hãy cài và đăng nhập trước, rồi mới mở Suparagent. Đây là chỗ người mới hay vấp: app không đăng nhập hộ bạn vào các CLI đó.

B.Tải mã nguồn về máy

Mở terminal (PowerShell trên Windows, Terminal trên macOS hoặc Linux) ở thư mục bạn muốn đặt dự án, rồi chạy:

Terminal
git clone https://github.com/Anil-matcha/suparagent.git

Lệnh này tạo thư mục suparagent chứa toàn bộ mã nguồn.

C.Vào thư mục desktop và chạy app

README ghi hai lệnh sau, chạy trong terminal vừa mở:

Terminal
cd suparagent/desktop
npm run app

cd suparagent/desktop đưa bạn vào đúng thư mục chứa ứng dụng desktop. Chạy npm run app ở thư mục khác sẽ không đúng. Lần chạy đầu có thể mất thời gian vì phải chuẩn bị mọi thứ.

Trong repo có tệp run-desktop.bat ở thư mục gốc, nhưng README không giải thích nó, nên mình khuyên bạn bám theo lệnh ở trên. Nếu muốn tìm hiểu, xem phần hướng dẫn desktop trong thư mục docs/.

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

Lần mở đầu tiên, app hỏi bạn chọn engine, thư mục làm việc và chế độ duyệt. Sau đó làm theo README:

  1. Vào Settings → Engines và xác nhận có một engine ở trạng thái sẵn sàng.
  2. Tạo agent với tên, một công việc rõ ràng và một thư mục làm việc.
  3. Bắt đầu chat. Chọn Ask first để app dừng lại xin duyệt trước các hành động cần duyệt.
  4. Khi cần chia việc hoặc lặp lại việc, thêm đồng đội hoặc tạo routine.

README cũng nhắc có bản cài đặt desktop ở trang Releases của repo, nhưng ghi rõ các bản cài này còn thử nghiệm và chưa ký số. Nếu muốn chắc tay, hãy theo cách chạy từ mã nguồn ở trên.

Nếu bạn muốn tự dựng máy chủ, repo có Dockerfile, compose.yaml và thư mục deploy/, nhưng README chưa ghi lệnh cụ thể ở phần này. Hãy xem mục Self-hosting trong thư mục docs/ của repo.

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

README không đưa ra một lệnh kiểm tra riêng. Dấu hiệu thành công dựa theo các bước trong tư liệu:

  • Sau npm run app, cửa sổ ứng dụng mở lên và hỏi bạn chọn engine, workspace, chế độ duyệt.
  • Trong Settings → Engines, engine bạn chọn hiện ở trạng thái sẵn sàng.
  • Bạn tạo được một agent, mở chat và nhận được câu trả lời. Với chế độ Ask first, những hành động cần quyền sẽ hiện yêu cầu duyệt cho bạn.

Nếu engine chưa sẵn sàng, quay lại bước đăng nhập CLI hoặc nhập khoá API trong Settings.

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

A.Báo cáo dự án hằng tuần cho người quản lý

Bối cảnh: bạn là quản lý nhóm nhỏ, mỗi tuần phải tổng hợp ghi chú và báo cáo rải rác trong một thư mục. Cách làm theo ví dụ của README: tạo một agent trưởng nhóm, thêm hai chuyên viên (một người nghiên cứu, một biên tập), cho cả ba cùng thư mục dự án, và đặt engine của trưởng nhóm là Claude hoặc Codex. Sau đó nhắn cho trưởng nhóm, ví dụ:

text
Hãy lập bản tổng hợp tuần này từ các ghi chú và báo cáo trong thư mục dự án. Chia việc cho người nghiên cứu và biên tập, rồi gộp lại.

Kết quả: trưởng nhóm tách việc, các chuyên viên làm ở những cuộc hội thoại riêng, rồi trả về để trưởng nhóm ráp thành bản tổng hợp. Bạn theo dõi trong chat và duyệt khi cài đặt yêu cầu.

Chạy ổn một lần thì đừng làm lại bằng tay, hãy biến nó thành routine.

Ô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 ở trên chạy ổn, bạn không muốn mở app mỗi thứ Hai. Tạo một routine cho agent đó, chạy theo lịch (hoặc webhook, hoặc bấm tay). Mỗi lần chạy, kết quả hiện trong app để bạn xem lại; nếu có hành động cần duyệt, routine chờ bạn trả lời chứ không tự duyệt. Lưu ý từ README: routine chạy ở backend nên backend phải luôn chạy. Vì vậy máy cần bật, hoặc bạn đặt trên máy chủ riêng.

C.Sáng nào cũng xem nhanh việc cần xử lý

Bối cảnh: nhân viên văn phòng bận họp, ngại mở từng công cụ. Mở màn hình Today để xem một 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ếu đã nối Composio, có thể hiện thêm thư Gmail và lịch ở chế độ chỉ đọc. Kết quả: bạn biết ngay việc nào cần mình, việc nào agent đã lo xong. Phần kết nối ứng dụng này còn thử nghiệm, và chỉ agent Claude hoặc Codex dùng được.

D.Lập trình viên cho agent làm việc trong một thư mục code

Bối cảnh: bạn là dev, muốn một agent đọc và chỉnh code trong một thư mục. Tạo agent, trỏ thư mục làm việc vào repo của bạn, chọn chế độ Ask first hoặc Accept edits, rồi giao việc cụ thể, ví dụ "đọc thư mục này và liệt kê những chỗ thiếu ghi chú". Bạn xem toàn bộ hoạt động công cụ và quyết định duyệt trong app. Khi quen và tin tưởng, mới cân nhắc các chế độ rộng quyền hơn.

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

  • Engine không hiện sẵn sàng. Thường do chưa cài hoặc chưa đăng nhập CLI trước khi mở app. Hãy cài, đăng nhập ngoài terminal, rồi mở lại app và kiểm tra Settings → Engines. Nếu dùng API, kiểm tra lại khoá bạn đã nhập.
  • npm run app báo lỗi ngay. Kiểm tra bạn đang đứng đúng thư mục suparagent/desktop, Node.js là bản 22 trở lên (node --version) và đã cài uv. README yêu cầu cả ba.
  • Agent không chạy việc theo lịch. Routine chạy ở backend, nên nếu máy tắt hoặc backend dừng thì lịch không chạy. Giữ backend chạy, hoặc dùng máy chủ riêng.
  • Không dùng được một tính năng với engine của bạn. README nói công cụ khác nhau theo engine: nhập ảnh, máy tính cô lập không phải engine nào cũng hỗ trợ; trưởng nhóm cần Claude hoặc Codex; kết nối Composio chỉ cho Claude và Codex. Xem bảng khả năng trong docs/ để chọn engine phù hợp.
  • Cài bằng bản installer gặp cảnh báo hoặc cập nhật không như ý. README ghi installer còn thử nghiệm, chưa ký số, và đường cập nhật giữa các bản chưa được kiểm tra đầu cuối. Cách an toàn là chạy từ mã nguồn như hướng dẫn, hoặc hỏi trên Discord và GitHub Issues của dự án.

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

Điểm mạnh: bạn giữ quyền kiểm soát. Dữ liệu ở máy của bạn, bạn chọn engine, và mọi hành động quan trọng có thể chờ bạn duyệt. Giấy phép Apache-2.0, nhiều loại engine được hỗ trợ, có trí nhớ, routine, nhóm agent và cả app điện thoại. Cách nghĩ "đồng nghiệp AI có tên và việc rõ ràng" cũng dễ hình dung cho người làm kinh doanh.

Giới hạn cần nói thẳng. README ghi dự án đang phát triển nhanh và nhiều phần còn thử nghiệm: máy chủ tự dựng, installer desktop, máy tính Docker, công cụ trình duyệt, bản desktop macOS. Máy chủ tự dựng có một chủ sở hữu, mời được đồng đội, nhưng mọi người dùng chung agent, hội thoại và trí nhớ; nó không phải dịch vụ nhiều tổ chức. App điện thoại mới thử trên Android, chưa có trên iOS, không có thông báo đẩy. Kết nối ứng dụng qua Composio mới được kiểm thử với dịch vụ giả lập, chưa phải dịch vụ thật. Bạn cũng vẫn phải trả tiền cho nhà cung cấp AI, và cần tự cài vài công cụ nền trước.

Nếu bạn chỉ cần hỏi đáp thỉnh thoảng, một công cụ chat thông thường đơn giản hơn. Nếu việc của bạn quan trọng, hãy chạy thử với dữ liệu không nhạy cảm và để chế độ Ask first trước. Còn nếu bạn muốn có "nhân viên ảo" nhớ việc, chạy theo lịch và luôn hỏi ý bạn, Suparagent đáng để thử.

4.6/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?

Phần mã nguồn mở theo giấy phép Apache-2.0, bạn tự chạy bản desktop hoặc máy chủ riêng. Suparagent không kèm mô hình AI, nên bạn vẫn phải có tài khoản, đăng nhập CLI hoặc khoá API của nhà cung cấp, và việc dùng mô hình có thể tốn tiền. Ngoài ra có dịch vụ hosted riêng với gói thử miễn phí và các gói trả phí.

Có cần GPU không?

README không nêu yêu cầu GPU hay cấu hình phần cứng. Yêu cầu được ghi là Node.js 22+, uv và ít nhất một engine. Nếu bạn dùng mô hình chạy cục bộ như Ollama hay LM Studio thì cấu hình máy phụ thuộc vào mô hình đó, tư liệu chưa có thông tin cụ thể.

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

Repo có tệp run-desktop.bat, nhưng README không giải thích và cũng không nói rõ về Windows. README chỉ ghi lệnh chạy từ mã nguồn (git clone, cd suparagent/desktop, npm run app) và cho biết các bản installer desktop còn thử nghiệm, kiểm chứng nền tảng hạn chế. Bạn nên xem hướng dẫn desktop trong thư mục docs của repo.

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

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

Dùng được với những mô hình hay công cụ AI nào?

README liệt kê Claude Code, Codex CLI, Gemini CLI, Google Gemini qua Antigravity, Cursor, các CLI agent dùng giao thức ACP, OpenRouter và API tương thích OpenAI như Ollama, LM Studio. Khả năng khác nhau tuỳ engine: ví dụ nhập ảnh và máy tính cô lập không phải engine nào cũng có.

Agent có tự làm việc mà không hỏi tôi không?

Bạn chọn mức tự do: Ask first, Accept edits, Approve for me (Claude, Codex, Cursor) hoặc Plan only. Với routine, README nói rõ routine không bao giờ tự duyệt hành động thay bạn. Các thay đổi qua ứng dụng kết nối cũng chờ bạn duyệt.

Dự án đã ổn định chưa?

Chưa hoàn toàn. README ghi dự án đang phát triển, nhiều phần như máy chủ tự dựng, installer, Docker computer, công cụ trình duyệt còn thử nghiệm. Bạn nên đọc mục Known limitations trong README trước khi dùng cho việc quan trọ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.Chuẩn bị Node.js, uv và engine
    2. B.Tải mã nguồn về máy
    3. C.Vào thư mục desktop 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.Báo cáo dự án hằng tuần cho người quản lý
    2. B.Biến việc lặp lại thành routine
    3. C.Sáng nào cũng xem nhanh việc cần xử lý
    4. D.Lập trình viên cho agent làm việc trong một thư mục code
  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ỏ.