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

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

Tóm tắt nhanh

Suparagent là một không gian làm việc mã nguồn mở (Apache-2.0) để tạo các "đồng nghiệp AI": mỗi agent có tên, nhiệm vụ, thư mục làm việc, trí nhớ và lịch chạy riêng. Bạn dùng bản desktop hoặc tự host server. Cài cần Node.js 22+, uv và một engine AI có sẵn, nên người mới sẽ hơi vất vả một chút nhưng chỉ cần ba lệnh để mở app.

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" có tên riêng. Mỗi agent có một nhiệm vụ, một thư mục làm việc, trí nhớ riêng, và chỉ hành động khi bạn cho phép. Nó chạy trên máy của bạn (bản desktop) hoặc trên server bạn tự quản lý. Hiện repo có khoảng 7041 sao và 913 fork trên GitHub.

Nếu bạn từng dùng ChatGPT hay Claude và thấy mỗi lần mở lại phải giải thích từ đầu, Suparagent giải quyết đúng chỗ đó. Agent nhớ ghi chú, lặp lại việc theo lịch, và các agent có thể chia việc cho nhau. Người làm văn phòng, chủ shop thích tự động hoá, hay lập trình viên mới đều dùng được, miễn là bạn đã có sẵn một tài khoản AI.

Điểm đáng giá nhất là kiểm soát. Bạn chọn mức tự do cho agent, từ "hỏi trước khi làm" đến "chỉ lập kế hoạch". Việc chạy theo lịch cũng không tự duyệt thay bạn. Xem video ngắn bên dưới để thấy giao diện trước khi cài.

Ứng dụng

Anil-matcha/suparagent

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, giải thích theo lợi ích thực tế.

  • 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à cài đặt duyệt việc. Một agent "trưởng nhóm" có thể giao việc cho các agent chuyên môn, ví dụ một người nghiên cứu và một người biên tập. Trưởng nhóm cần dùng Claude hoặc Codex.
  • Giữ ngữ cảnh lâu dài. Agent có thể lưu ghi chú, nhớ lại ghi chú và cuộc trò chuyện liên quan, và tìm trong lịch sử. Bạn xem và sửa được những gì agent đang nhớ, nên không sợ nó "nhớ sai" mà bạn không biết.
  • Chạy việc theo lịch (routine). Bạn tạo routine chạy theo lịch, qua webhook, hoặc chạy tay. Kết quả mỗi lần chạy bạn tự xem lại. Routine không bao giờ tự duyệt một hành động nào.
  • 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 được trong app.
  • Kết nối ứng dụng. Bạn nối GitHub, Gmail, Google Calendar qua khoá Composio của chính bạn, rồi cấp quyền cho một số agent Claude hoặc Codex. Mọi thay đổi vẫn chờ bạn duyệt. Ngoài ra có MCP Marketplace để thêm từng công cụ.
  • Màn hình Today. Gom lại các 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 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 cuộc trò chuyện và các lần thử.
  • Dùng lại hướng dẫn. Bạn lưu skill (hướng dẫn bạn chọn cho một tin nhắn) 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 gọi công cụ.
  • Làm việc với tệp và lịch sử. 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ử.

Suparagent không kèm sẵn mô hình AI hay gói đăng ký mô hình. Bạn mang engine của mình đến: Claude Code, Codex CLI, Gemini CLI, Google Gemini qua Antigravity, Cursor, agent dòng lệnh dùng giao thức ACP, OpenRouter, hoặc API tương thích OpenAI như Ollama hay LM Studio. Công cụ khả dụng tuỳ engine; chẳng hạn không phải engine nào cũng nhận ảnh hay dùng được máy tính riêng của agent.

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

Theo README, bản desktop chạy từ một thư mục mã nguồn tải về (source checkout). Bạn cần:

  • Node.js 22 trở lên.
  • uv (công cụ Python, README dẫn tới trang docs.astral.sh/uv).
  • Ít nhất một engine có sẵn trên cùng máy. Với engine dạng CLI (ví dụ Claude Code hay Codex), bạn cài và đăng nhập nó trước khi mở Suparagent. Hoặc bạn cấu hình engine dạng API trong Settings → Engines.
  • Docker chỉ cần nếu muốn dùng máy tính cô lập cho agent. Đây là tuỳ chọn.
  • Git để chạy lệnh clone.

Về hệ điều hành, README không liệt kê cụ thể cho bản desktop. Trong repo có file run-desktop.bat, gợi ý là có hỗ trợ chạy trên Windows, nhưng README không khẳng định. Phần giới hạn cũng nói rõ bộ cài desktop chưa được kiểm chứng nhiều nền tảng.

Nếu bạn tự host server, README ghi yêu cầu chính là máy chủ Linux, HTTPS, Docker hoặc Node.js và uv, và một engine.

Suparagent không kèm mô hình AI. Dùng engine nào thì bạn trả tiền cho nhà cung cấp đó theo cách của họ. Prompt, văn bản bạn đính kèm, ghi chú liên quan và nội dung trong thư mục làm việc mà engine đọc sẽ được gửi cho engine đó. Nếu engine là dịch vụ trên mạng, dữ liệu này nằm dưới điều khoản của nhà cung cấp. Đừng cho agent truy cập thư mục chứa dữ liệu nhạy cảm nếu bạn chưa yên tâm.

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

Dưới đây là đường nhanh nhất: chạy bản desktop từ mã nguồn.

  1. Cài điều kiệnCó Node.js 22+, uv và ít nhất một engine đã đăng nhập
  2. Tải mã nguồnDùng git clone để lấy repo về máy
  3. Vào thư mục desktopcd vào suparagent/desktop
  4. Chạy appGõ npm run app
  5. Cấu hình lần đầuChọn engine, thư mục làm việc, chế độ duyệt việc

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

Trước khi chạy lệnh nào, hãy chắc là máy bạn đã có Node.js bản 22 trở lên và uv. Bạn có thể kiểm tra bằng cách mở terminal rồi gõ node --version; kết quả phải bắt đầu bằng 22 hoặc lớn hơn.

Với engine, ví dụ bạn dùng Claude Code hay Codex CLI, hãy cài và đăng nhập nó trước. Người mới hay quên bước này, rồi app mở lên nhưng báo không có engine nào sẵn sàng. README chưa ghi lệnh cài từng engine; bạn xem hướng dẫn của chính engine đó, hoặc mục engine setup trong thư mục docs của repo.

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

Mở terminal (PowerShell hoặc Git Bash trên Windows) ở thư mục mà bạn muốn đặt dự án, ví dụ thư mục Documents. 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

Hai lệnh dưới đây lấy đúng từ README:

Terminal
cd suparagent/desktop
npm run app

Lệnh cd đưa terminal vào thư mục desktop bên trong repo. Lệnh npm run app khởi động ứng dụng. Chỗ hay vấp: phải chạy npm run app trong thư mục desktop, không phải thư mục gốc suparagent. README không ghi thêm bước cài gói nào khác; nếu lần đầu chạy báo thiếu gói, bạn xem hướng dẫn desktop setup trong thư mục docs.

D.Cấu hình lần mở đầu tiên

Lần đầu mở, app hỏi bạn chọn engine, thư mục làm việc (workspace) và chế độ duyệt (approval mode). Sau đó README gợi ý làm theo thứ tự:

  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 một cái tên, một nhiệm vụ 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 hỏi bạn trước các hành động cần duyệt.
  4. Thêm đồng đội hoặc tạo routine khi muốn chia việc hay lặp lại việc.

Nếu bạn không muốn chạy từ mã nguồn, trang Releases của repo có bộ cài desktop. README nói rõ các bộ cài này còn thử nghiệm và chưa được ký số, nên Windows có thể cảnh báo khi mở.

E.Muốn tự host server thì sao

Trong repo có Dockerfile và compose.yaml. Tuy nhiên README chưa ghi lệnh cụ thể để chạy server bằng Docker; phần này nằm ở hướng dẫn Self-hosting trong thư mục docs của repo. Bạn nên đọc ở đó rồi làm theo, thay vì tự đoán lệnh.

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

Bạn biết cài thành công khi cửa sổ Suparagent hiện lên sau lệnh npm run app và hỏi bạn chọn engine, workspace, chế độ duyệt. Sau đó làm theo các bước sau:

  • Vào Settings → Engines: engine của bạn phải ở trạng thái sẵn sàng.
  • Tạo một agent thử, ví dụ tên "Trợ lý thử", nhiệm vụ "trả lời ngắn gọn bằng tiếng Việt".
  • Chat một câu đơn giản như "Chào bạn, bạn là ai?" với chế độ Ask first. Nếu agent trả lời, tức là engine đã nối thông.

README không đưa ra một dòng chữ cụ thể để so sánh. Dấu hiệu duy nhất là app mở được, engine sẵn sàng, và agent trả lời được.

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

Dưới đây là vài tình huống bám đúng khả năng README mô tả. Prompt là mẫu để bạn chỉnh theo việc của mình.

A.Chuẩn bị bản tóm tắt dự án mỗi tuần

Bạn là quản lý một dự án nhỏ, mỗi thứ Sáu phải gom ghi chú và báo cáo thành một bản tóm tắt. Đây chính là ví dụ trong README. Tạo một agent trưởng nhóm với engine Claude hoặc Codex, cộng hai agent chuyên môn: một người nghiên cứu, một người biên tập. Cho cả ba dùng chung một thư mục dự án chứa ghi chú và báo cáo.

Prompt mẫu cho trưởng nhóm:

text
Hãy đọc các ghi chú và báo cáo trong thư mục dự án, rồi soạn bản tóm tắt tuần này. Giao người nghiên cứu gom số liệu, giao người biên tập viết lại cho gọn.

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

Khi quy trình đã chạy tốt, hãy biến nó thành routine hàng tuần và chỉ cần duyệt kết quả.

Ông T

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

Bạn là chủ shop, mỗi sáng muốn có một bản nhắc việc từ ghi chú đã lưu. Sau khi thử tay thấy ổn, tạo routine cho agent đó, chọn chạy theo lịch (hoặc qua webhook, hoặc chạy tay khi cần). Mỗi lần chạy, bạn vào xem kết quả và trả lời các yêu cầu duyệt nếu có.

Lưu ý: routine chạy ở backend, nên backend phải đang chạy thì lịch mới hoạt động. Nếu bạn tắt máy hay tắt app, routine sẽ không chạy.

C.Gom việc cần chú ý bằng màn hình Today

Nhân viên văn phòng thường bị lạc giữa nhiều agent và nhiều cuộc trò chuyện. Màn hình Today gom lại những gì cần bạn quyết định: yêu cầu duyệt, câu hỏi từ agent, kết quả routine, lỗi engine và việc đến hạn. Nếu bạn nối Gmail và Google Calendar qua khoá Composio của mình, nó còn hiện thư và lịch ở chế độ chỉ đọc.

Cách dùng: mỗi sáng mở Today trước, xử lý các mục cần duyệt, rồi mới mở từng agent. Chỉ cấp quyền Gmail hay lịch cho đúng agent cần dùng.

D.Dev mới: giao agent đọc và sửa thư mục code

Bạn là lập trình viên mới, có một thư mục dự án nhỏ. Tạo một agent với thư mục làm việc trỏ vào đó, chọn chế độ Plan only để agent chỉ đề xuất kế hoạch, hoặc Ask first để nó hỏi trước khi sửa. Prompt mẫu:

text
Đọc thư mục này và giải thích cấu trúc cho mình. Sau đó đề xuất các bước để thêm tính năng đăng nhập, chưa sửa gì cả.

Kết quả là một bản kế hoạch bạn đọc và chỉnh. Khi hài lòng, chuyển sang Ask first để agent làm từng bước và bạn duyệt từng thay đổi.

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

App mở nhưng báo không có engine sẵn sàng. Thường vì CLI engine chưa được cài hoặc chưa đăng nhập. Cài và đăng nhập engine trước, rồi vào Settings → Engines để kiểm tra lại. Hoặc cấu hình một engine dạng API ngay trong đó.

Lệnh npm run app báo lỗi hoặc không tìm thấy. Kiểm tra bạn đang đứng trong thư mục suparagent/desktop. Rồi gõ node --version để chắc là Node.js từ bản 22 trở lên. Nếu vẫn lỗi, xem hướng dẫn desktop setup trong thư mục docs hoặc hỏi trên Discord/GitHub Issues của dự án.

Windows hoặc hệ điều hành cảnh báo khi mở bộ cài. README nói bộ cài desktop còn thử nghiệm và chưa ký số. Nếu bạn lo ngại, hãy chạy từ mã nguồn như hướng dẫn ở trên. Chỉ tải bộ cài từ trang Releases chính thức của repo.

Routine không chạy đúng giờ. Routine chạy ở backend, nên backend phải đang chạy. Kiểm tra app hoặc server có đang mở không. Với việc cần chạy đều, bản self-host trên server sẽ hợp hơn máy cá nhân hay tắt.

Agent không dùng được Gmail, GitHub hay lịch. Ứng dụng kết nối cần khoá Composio của riêng bạn, và chỉ agent Claude hoặc Codex mới dùng được. Kiểm tra engine của agent đó. Ngoài ra mọi thay đổi vẫn chờ bạn duyệt, nên đừng quên mở danh sách yêu cầu duyệt.

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

Điểm mạnh.

  • Mã nguồn mở, giấy phép Apache-2.0, dữ liệu desktop và self-host nằm trên máy hoặc server của bạn. Khoá API lưu qua Suparagent được mã hoá ở đó.
  • Kiểm soát rõ ràng: nhiều mức duyệt việc, routine không tự duyệt.
  • Không bị khoá vào một hãng: nhiều engine, kể cả Ollama và LM Studio chạy cục bộ.
  • Có trí nhớ, lịch, bảng việc, màn hình Today trong cùng một nơi.

Giới hạn cần biết.

  • Dự án đang phát triển nhanh. Bản desktop và self-host đều còn thử nghiệm, README khuyên đọc phần known limitations trước khi dùng cho việc quan trọng.
  • Server tự host chỉ có một chủ sở hữu, người này mời được đồng đội; 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.
  • Giao việc theo nhóm còn mới, trưởng nhóm phải dùng Claude hoặc Codex.
  • App điện thoại mới thử trên Android, chưa thử trên iOS, chưa có thông báo đẩy hay bản trên cửa hàng.
  • Máy tính Docker, công cụ trình duyệt và bản macOS gốc đều là tuỳ chọn thử nghiệm.
  • Phần kết nối ứng dụng qua Composio mới được thử với dịch vụ giả, chưa phải dịch vụ thật.
  • Cần mang engine riêng và tự trả phí cho nhà cung cấp mô hình.

Ngoài bản mã nguồn mở, tác giả còn có dịch vụ hosted riêng với các gói trả phí; đó là sản phẩm tách biệt, xử lý dữ liệu theo chính sách của họ.

Khi nào chọn cách khác. Nếu bạn chỉ cần hỏi đáp thỉnh thoảng, một app chat thông thường đơn giản hơn. Nếu bạn cần dịch vụ ổn định đã qua kiểm chứng cho cả công ty, hãy cân nhắc kỹ vì repo tự nhận còn sớm. Nếu bạn muốn thử một nhóm agent làm việc thay mình mà vẫn giữ quyền duyệt từng bước, đây là một lựa chọn đáng thử trên một thư mục dữ liệu không nhạy cảm.

4.4/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ở (bản desktop và self-host) dùng giấy phép Apache-2.0 nên bạn dùng được không mất phí phần mềm. Nhưng Suparagent không kèm mô hình AI, nên bạn vẫn trả tiền cho nhà cung cấp engine bạn chọn nếu họ tính phí. Dịch vụ hosted riêng có các gói trả phí tách biệt.

Cần máy mạnh hay GPU không?

README không yêu cầu GPU. Bạn cần Node.js 22+, uv và một engine. Nếu bạn dùng engine 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 đó, README không nói thêm.

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

README không liệt kê rõ hệ điều hành cho bản desktop. Repo có file run-desktop.bat và bộ cài desktop trên trang Releases, nhưng các bộ cài này còn thử nghiệm, chưa ký số và chưa kiểm chứng nhiều nền tảng. Server tự host theo README cần máy chủ Linux.

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

Với desktop và self-host, hội thoại, ghi chú, routine và cài đặt lưu trong thư mục dữ liệu trên máy hoặc server của bạn, khoá API lưu qua app được mã hoá. Tuy nhiên engine bạn chọn sẽ nhận prompt và ngữ cảnh của lượt đó; nếu là dịch vụ trên mạng thì nằm dưới điều khoản của nhà cung cấp đó.

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

Tuỳ chế độ bạn chọn: Ask first, Accept edits, Approve for me (cho Claude, Codex, Cursor) hoặc Plan only. Routine chạy theo lịch không bao giờ tự duyệt một hành động, bạn phải trả lời các yêu cầu duyệt.

Dùng được những engine AI nào?

README liệt kê Claude Code, Codex CLI, Gemini CLI, Google Gemini qua Antigravity, Cursor, agent dòng lệnh dùng ACP, OpenRouter và API tương thích OpenAI như Ollama hay LM Studio. Không phải engine nào cũng hỗ trợ ảnh hay máy tính riêng của agent.

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 bạn, dùng để chat, dừng câu trả lời và cho phép hoặc từ chối lệnh gọi công cụ. README ghi rõ mới thử trên Android, chưa thử trên iOS, chưa có thông báo đẩy hay bản trên cửa hà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.Cấu hình lần mở đầu tiên
    5. E.Muốn tự host server thì sao
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chuẩn bị bản tóm tắt dự án mỗi tuần
    2. B.Biến việc lặp lại thành routine
    3. C.Gom việc cần chú ý bằng màn hình Today
    4. D.Dev mới: giao agent đọc và sửa 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ỏ.