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

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

Tóm tắt nhanh

Suparagent là ứng dụng mã nguồn mở (Python, Apache-2.0) cho phép bạn tạo nhiều đồng nghiệp AI, mỗi người có vai trò, không gian làm việc, trí nhớ và quyền hạn riêng. Bạn dùng bản desktop hoặc tự dựng máy chủ, rồi nối với engine AI bạn đã có như Claude Code, Codex hay Ollama. Cài bản desktop từ mã nguồn cần Node.js 22+ và uv; dự án vẫn đang ở giai đoạn 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 người một công việc và một thư mục làm việc, rồi cho họ 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 lần xin duyệt đều nằm ở một chỗ.

Repo này hợp với người muốn dùng AI như một nhóm nhân viên chứ không chỉ một khung chat: chủ shop cần báo cáo đều đặn, nhân viên văn phòng muốn giao việc lặp lại, hoặc lập trình viên mới muốn thử mô hình “lead giao việc cho chuyên viên”. Hiện repo có khoảng 7.000 sao và 900 fork, giấy phép Apache-2.0.

Điểm đáng giá nhất là quyền kiểm soát. Bạn chọn mức tự do cho agent, và các thay đổi quan trọng phải chờ bạn đồng ý. Suparagent không kèm sẵn mô hình AI hay gói đăng ký nào: bạn mang tài khoản hoặc engine của mình đến. Mình sẽ nói rõ ở cuối bài những giới hạn, vì README tự thừa nhận dự án còn đang thay đổi nhiều. 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 đồng nghiệp AI có tên, có trí nhớ, chạy theo lịch và chỉ hành động khi bạn duyệt.

★ 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ì

A.Tạo agent và lập nhóm

Mỗi agent có tên, vai trò, engine, thư mục làm việc, trí nhớ và cài đặt phê duyệt. Một agent “trưởng nhóm” có thể giao việc cho các chuyên viên hoặc điều phối họ trong các phòng chung. Lợi ích thực tế: thay vì một cuộc chat dài rối rắm, bạn có người nghiên cứu, người biên tập, người tổng hợp, mỗi người một cuộc trò chuyện riêng. README lưu ý trưởng nhóm cần dùng Claude hoặc Codex.

B.Trí nhớ có thể xem và sửa

Agent có thể lưu ghi chú, nhớ lại ghi chú và hội thoại liên quan, và tìm trong lịch sử. Bạn xem và chỉnh được những gì agent nhớ. Nhờ vậy lần sau giao việc, bạn không phải giải thích lại từ đầu.

C.Routine: chạy việc theo lịch

Routine có thể chạy theo lịch, qua webhook hoặc chạy tay khi cần. Bạn xem kết quả từng lần và trả lời các yêu cầu duyệt. README nhấn mạnh: routine không bao giờ tự duyệt một hành động thay bạn.

D.Chọn mức tự do cho agent

Có bốn 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). Bạn xem được hoạt động công cụ và các quyết định duyệt ngay trong app.

E.Kết nối công cụ và ứng dụng

Bạn có thể nối GitHub, Gmail, Google Calendar… qua khoá Composio của chính bạn, rồi cấp quyền cho từng 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ụ lẻ.

F.Màn hình Today, bảng việc và lịch

Màn hình Today gom phê duyệt, câu hỏi, kết quả routine, lỗi engine và việc đến hạn; nó còn hiện được thư Gmail và lịch ở chế độ chỉ đọc. Bảng công việc và lịch giúp giao việc, hẹn chạy một lần và xem lại các lần thử.

G.Skills, mẫu, app điện thoại và quản lý tệp

Bạn lưu skill (hướng dẫn tái sử dụng cho một tin nhắn) và tạo agent từ mẫu. App điện thoại ghép 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. Bạn cũng đính kèm văn bản và ảnh, nhập âm thanh để chuyển thành chữ (khi bạn đồng ý và có thông tin đăng nhập), duyệt hoặc tải tệp trong workspace, và 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 tài liệu: docs.astral.sh/uv).
  • Ít nhất một engine có sẵn trên cùng máy. Với engine dạng dòng lệnh (CLI), bạn phải cài và đăng nhập trước khi mở app. 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 (tuỳ chọn).
  • Git để tải mã nguồn về.

Các engine được nhắc tới: Claude Code hoặc Codex CLI, Gemini CLI, Google Gemini qua Antigravity, Cursor, agent dòng lệnh khác dùng giao thức ACP, OpenRouter, hoặc API tương thích OpenAI như Ollama và LM Studio. Khả năng của từng engine khác nhau; ví dụ không phải engine nào cũng nhận ảnh hay dùng được máy tính của agent.

Về chi phí: Suparagent không có sẵn mô hình hay gói đăng ký. Bạn mang tài khoản, đăng nhập CLI hoặc API key của mình, và việc dùng mô hình có thể tốn tiền theo nhà cung cấp đó.

Về phần cứng, hệ điều hành cụ thể cho bản desktop, README không ghi yêu cầu chi tiết. README chỉ nói bản cài đặt sẵn còn thử nghiệm, chưa ký số và mới được kiểm chứng trên số nền tảng hạn chế.

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

  1. Cài nền tảngCó Node.js 22+, uv và ít nhất một engine AI đã đăng nhập
  2. Tải mã nguồnDùng git clone để lấy repo về máy
  3. Chạy appVào thư mục desktop và chạy lệnh npm run app
  4. Thiết lập lần đầuChọn engine, workspace và chế độ phê duyệt
  5. Tạo agent đầu tiênĐặt tên, giao việc, chọn workspace rồi bắt đầu chat

A.Cài sẵn Node.js, uv và một engine

Trước hết hãy chắc máy bạn có Node.js bản 22 trở lên và uv. README không đưa lệnh cài cho hai thứ này, nên bạn xem hướng dẫn trên trang chính thức của từng công cụ. Nếu dùng engine dạng CLI (ví dụ Claude Code hay Codex), hãy cài và đăng nhập xong rồi mới mở Suparagent. Chỗ này người mới hay vấp nhất: mở app mà chưa có engine nào sẵn sàng thì agent không trả lời được.

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

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

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

Lệnh đầu tải toàn bộ repo về thư mục suparagent. Lệnh thứ hai đi vào thư mục desktop, nơi README yêu cầu chạy app.

C.Chạy ứng dụng desktop

Trong thư mục desktop, chạy lệnh mà README ghi:

Terminal
npm run app

README không ghi thêm bước npm install riêng. Nếu lệnh báo thiếu gói, hãy xem hướng dẫn thiết lập desktop trong thư mục docs/ của repo. Ở gốc repo còn có tệp run-desktop.bat, nhưng README không giải thích cách dùng nó, nên bạn hãy mở tệp ra đọc trước khi chạy.

D.Thiết lập lần đầu và tạo agent

Lần đầu mở, app hỏi bạn chọn engine, workspace và chế độ phê duyệt. Sau đó:

  1. Vào Settings → Engines và kiểm tra có 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 workspace.
  3. Bắt đầu chat. Chọn Ask first nếu muốn app dừng lại xin duyệt 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 cần chạy trên máy chủ riêng, repo có Dockerfile và compose.yaml, cùng hướng dẫn self-hosting trong tài liệu. README chưa ghi lệnh cụ thể ở phần tóm tắt, nên bạn xem tài liệu self-hosting trong thư mục docs/ và thư mục deploy/. Máy chủ tự dựng đòi hỏi Linux, HTTPS, Docker (hoặc Node.js và uv) và một engine.

Bản desktop và bản self-host đều đang ở trạng thái thử nghiệm. Trình cài đặt chưa được ký số. Hãy dùng thử với việc ít rủi ro trước, và đừng giao agent những tệp hay tài khoản quan trọng khi chưa kiểm tra kỹ chế độ phê duyệt.

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

README không đưa một lệnh “kiểm tra” riêng. Dấu hiệu thành công theo tư liệu là:

  • Sau npm run app, cửa sổ ứng dụng mở lên và hiện màn hình thiết lập lần đầu (chọn engine, workspace, chế độ phê duyệt).
  • Trong Settings → Engines, engine của bạn hiện trạng thái sẵn sàng.
  • Bạn tạo được một agent, gửi tin nhắn và nhận được câu trả lời.

Một phép thử nhanh: tạo agent tên “Trợ lý thử”, chọn Ask first, rồi nhờ nó đọc một tệp văn bản trong workspace và tóm tắt. Nếu có câu trả lời, và app xin bạn duyệt đúng lúc cần, nghĩa là mọi thứ đã nối thông.

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

A.Báo cáo dự án hằng tuần cho người làm văn phòng

Bối cảnh: bạn quản lý một dự án, mỗi tuần phải gom ghi chú và báo cáo rời rạc thành một bản tổng hợp. Cách làm theo ví dụ trong README: tạo một agent trưởng nhóm và hai chuyên viên, như “Nghiên cứu” và “Biên tập”. Cho cả ba dùng chung một thư mục dự án, và đặt engine của trưởng nhóm là Claude hoặc Codex. Rồi nhờ trưởng nhóm:

Code
Hãy chuẩn bị bản tóm tắt dự án tuần này từ các ghi chú và báo cáo trong thư mục. Giao phần tổng hợp số liệu cho Nghiên cứu, phần viết lại cho Biên tập.

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

Cứ làm tay một lần cho trơn, rồi mới biến nó thành routine để máy làm thay.

Ông T

B.Biến quy trình thành routine cho chủ shop

Bối cảnh: chủ shop muốn mỗi sáng thứ Hai có bản tóm tắt tình hình từ các tệp ghi chú bán hàng. Khi quy trình trên đã chạy tốt, bạn tạo routine chạy theo lịch với cùng câu lệnh. Mỗi lần chạy, bạn mở app 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 luôn bật thì lịch mới chạy.

C.Dùng màn hình Today để không bỏ sót việc

Bối cảnh: bạn có nhiều agent chạy song song và hay quên cái nào đang chờ mình. 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, engine bị lỗi, việc đến hạn. Nếu đã nối Gmail và lịch, Today có thể hiện thư và sự kiện ở chế độ chỉ đọc. Cách này hợp với nhân viên văn phòng muốn mở một nơi là biết hôm nay cần quyết định gì.

D.Lập trình viên thử nhiều engine cho cùng một việc

Bối cảnh: bạn là dev mới, muốn so sánh cách làm của Claude Code, Codex hay một mô hình chạy cục bộ qua Ollama. Tạo mỗi agent một engine khác nhau, cho cùng workspace, giao cùng một yêu cầu rồi xem kết quả. Chọn Plan only để agent chỉ lập kế hoạch, hoặc Ask first để kiểm soát từng thao tác. Bạn xem lại hoạt động công cụ và các quyết định duyệt ngay trong app.

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

A.Agent không trả lời hoặc báo engine lỗi

Nguyên nhân thường gặp nhất là engine chưa sẵn sàng. Với engine CLI, bạn phải cài và đăng nhập trước khi mở app. Hãy vào Settings → Engines kiểm tra trạng thái, hoặc cấu hình một engine API. Màn hình Today cũng gom các lỗi engine để bạn dễ thấy.

B.npm run app không chạy

Kiểm tra bạn đang đứng đúng thư mục suparagent/desktop, Node.js đạt bản 22 trở lên (node --version) và uv đã cài. Nếu vẫn lỗi, xem hướng dẫn thiết lập desktop trong docs/ của repo, hoặc hỏi trong mục Issues hay cộng đồng Discord của dự án.

C.Routine không chạy đúng giờ

Routine chạy trong backend, nên nếu backend tắt thì lịch không chạy. Hãy để máy hoặc máy chủ chạy liên tục vào giờ hẹn. Nhớ rằng routine không tự duyệt hành động, nên nó có thể dừng chờ bạn trả lời yêu cầu duyệt.

D.Agent không dùng được ứng dụng đã kết nối hay ảnh

Chỉ agent Claude và Codex dùng được ứng dụng kết nối qua Composio, và không phải engine nào cũng hỗ trợ ảnh hoặc máy tính cô lập. Hãy đổi engine của agent đó, và kiểm tra bảng khả năng trong tài liệu repo.

E.Hệ điều hành chặn trình cài đặt

Trình cài desktop là bản thử nghiệm và chưa ký số, nên hệ điều hành có thể cảnh báo. Chỉ tải từ trang Releases chính thức của repo. README cũng nói luồng cập nhật có kiểm tra SHA-256 nhưng chưa được kiểm chứng đầy đủ giữa các bản, và nó không tự cài bản cập nhật cho bạ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 hội thoại, ghi chú, routine nằm trên máy hoặc máy chủ của bạn; khoá API lưu qua Suparagent được mã hoá; tệp làm việc nằm trong thư mục bạn chỉ định. Bạn chọn engine tuỳ ý, kể cả mô hình chạy cục bộ. Cơ chế duyệt trước khi hành động giúp yên tâm hơn các công cụ tự làm hết.

Giới hạn. README nói thẳng dự án còn sớm và đang thay đổi. Máy chủ tự dựng mới ở mức thử nghiệm, có một chủ sở hữu và mời được đồng đội, nhưng mọi người dùng chung agent, hội thoại và trí nhớ. Giao việc theo nhóm còn mới và 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 có iOS, chưa có thông báo đẩy. 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. Ứng dụng kết nối qua Composio mới được kiểm thử với dịch vụ giả lập chứ chưa phải dịch vụ thật.

Về dữ liệu. Khi agent trả lời, engine bạn chọn nhận câu hỏi và ngữ cảnh cần thiết, gồm văn bản đính kèm, ghi chú liên quan và nội dung workspace nó đọc. 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 ấy.

Khi nào chọn cách khác. Nếu bạn cần công cụ ổn định, đã qua kiểm chứng cho công việc quan trọng, hoặc chỉ muốn hỏi đáp nhanh một mô hình, một ứng dụng chat thông thường sẽ đơn giản hơn. Còn nếu bạn thích cách giao việc cho nhiều agent, muốn lịch chạy định kỳ và kiểm soát từng hành động, Suparagent đáng để thử, bắt đầu với việc ít rủi ro.

4.3/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à tự dựng máy chủ) dùng giấy phép Apache-2.0. Tuy nhiên Suparagent không kèm mô hình AI, nên bạn vẫn có thể phải trả tiền cho nhà cung cấp mô hình bạn dùng. Bản hosted là sản phẩm riêng, có gói Free preview và các gói trả phí Starter, Standard, Pro.

Tôi có cần GPU không?

Tư liệu không nêu yêu cầu GPU. Suparagent dùng engine bạn đã có, như Claude Code, Codex hoặc API. Nếu bạn muốn chạy mô hình cục bộ qua Ollama hay LM Studio thì phần cứng phụ thuộc vào mô hình đó, tư liệu chưa nói chi tiết.

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

README không nêu rõ hệ điều hành cho bản desktop. Nó chỉ nói trình cài đặt còn thử nghiệm, chưa ký số và mới được kiểm chứng hạn chế trên một số nền tảng. Repo có tệp run-desktop.bat ở thư mục gốc, nhưng README chưa giải thích cách dùng. Máy chủ tự dựng thì yêu cầu Linux.

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 lưu trong thư mục dữ liệu hoặc cơ sở dữ liệu của máy bạn, khoá API lưu qua Suparagent được mã hoá. Tuy vậy engine bạn chọn vẫn nhận prompt và ngữ cảnh cần cho mỗi lượt trả lời, nên nếu là dịch vụ trên mạng thì dữ liệu theo điều khoản của nhà cung cấp đó.

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

Bạn quyết định. Có bốn chế độ: Ask first, Accept edits, Approve for me và Plan only. Với Ask first, app tạm dừng để xin duyệt. README cũng nói routine không bao giờ tự duyệt một hành động.

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

Có app điện thoại ghép 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 lệnh, tạo và sửa agent. Tuy vậy README nói mới thử trên 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.

Suparagent khác gì chỉ chat với một mô hình AI?

Suparagent tạo nhiều agent có tên, vai trò, trí nhớ, thư mục làm việc và lịch chạy riêng, có thể phối hợp thành nhóm và xin bạn duyệt trước khi hành động. Tư liệu không so sánh trực tiếp với từng công cụ cụ thể, nên bạn nên tự thử với một việc nhỏ để thấy khác biệt.

Chuyển nhanh tới mục

  1. I.Suparagent làm được gì
    1. A.Tạo agent và lập nhóm
    2. B.Trí nhớ có thể xem và sửa
    3. C.Routine: chạy việc theo lịch
    4. D.Chọn mức tự do cho agent
    5. E.Kết nối công cụ và ứng dụng
    6. F.Màn hình Today, bảng việc và lịch
    7. G.Skills, mẫu, app điện thoại và quản lý tệp
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài sẵn Node.js, uv và một engine
    2. B.Tải mã nguồn về
    3. C.Chạy ứng dụng desktop
    4. D.Thiết lập lần đầu và tạo agent
  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 làm văn phòng
    2. B.Biến quy trình thành routine cho chủ shop
    3. C.Dùng màn hình Today để không bỏ sót việc
    4. D.Lập trình viên thử nhiều engine cho cùng một việc
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Agent không trả lời hoặc báo engine lỗi
    2. B.npm run app không chạy
    3. C.Routine không chạy đúng giờ
    4. D.Agent không dùng được ứng dụng đã kết nối hay ảnh
    5. E.Hệ điều hành chặn trình cài đặt
  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ỏ.