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

Suparagent: đồng nghiệp AI có trí nhớ, lịch chạy và duyệt trước khi làm — cài 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: đồng nghiệp AI có trí nhớ, lịch chạy và 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, Apache-2.0) để tạo các "đồng nghiệp AI" có tên, vai trò, bộ nhớ, lịch chạy và cơ chế xin duyệt trước khi làm. Bạn 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 quen terminal, nhưng cần Node.js 22+, uv và một engine AI có sẵn.

Suparagent là một không gian làm việc mã nguồn mở, tự host, nơi bạn tạo ra các "đồng nghiệp AI" có tên riêng. Mỗi agent có công việc, thư mục làm việc, trí nhớ và mức quyền riêng. Toàn bộ hội thoại, ghi chú, lịch chạy và các yêu cầu duyệt nằm chung một chỗ. Tác giả định vị nó là bản thay thế mã nguồn mở, tự host cho các sản phẩm đồng nghiệp AI kiểu Grok Bot hay Claude Duet.

Bạn nên xem nếu bạn là chủ shop, nhân viên văn phòng hoặc dev muốn giao việc lặp lại cho AI mà vẫn giữ quyền kiểm soát. Ví dụ: soạn bản tóm tắt dự án hằng tuần, hoặc gom việc cần chú ý mỗi sáng. Điểm đáng giá nhất là chữ "duyệt": theo README, một routine không bao giờ tự phê duyệt hành động thay bạn. Bạn chọn mức tự do cho từng agent.

Có một điều cần nói rõ ngay từ đầu: Suparagent không kèm mô hình AI hay gói đăng ký mô hình nào. Bạn mang theo engine và tài khoản của mình. README cũng ghi dự án đang phát triển tích cực, nhiều phần còn ở mức thử nghiệm. Hiện repo có khoảng 7041 sao và 913 fork. Xem video ngắn bên dưới nếu bạn muốn thấy nhanh nó trông thế nào.

Ứ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, có trí nhớ, chạy theo lịch và luôn xin bạn duyệt trước khi hành độ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 theo README, kèm 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, bộ nhớ và cài đặt duyệt. Một agent "trưởng nhóm" có thể giao việc cho các agent chuyên môn, hoặc điều phối nhiều agent trong phòng chung. Lợi ích: bạn chia việc như ngoài đời, một người nghiên cứu, một người biên tập. README lưu ý trưởng nhóm hiện cần dùng Claude hoặc Codex.
  • 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ì chúng nhớ. Lợi ích: bạn đỡ phải nhắc lại bối cảnh mỗi lần.
  • Chạy việc theo lịch (routine). Routine chạy theo lịch, theo webhook hoặc chạy tay. Mỗi kết quả bạn xem lại, và mọi yêu cầu duyệt vẫn do bạn trả lời.
  • Chọn mức tự do. 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). Bạn xem được hoạt động công cụ và các quyết định duyệt ngay trong ứng dụng.
  • Kết nối công cụ và ứng dụng. Qua khoá Composio của chính bạn, bạn kết nối GitHub, Gmail, Google Calendar 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ụ riêng lẻ.
  • 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, 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 việc và lịch. Giao việc, hẹn chạy một lần, xem lại hội thoại và các lần thử.
  • Skill và mẫu agent. Lưu hướng dẫn dùng lại và tạo agent từ mẫu. Theo README, skill là những chỉ dẫn bạn chọn cho một tin nhắn.
  • 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 và lịch sử. 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 đăng nhập), duyệt hoặc tải tệp trong thư mục làm việc, xuất lịch sử.

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

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 (README dẫn tới trang docs.astral.sh/uv để bạn cài).
  • Ít nhất một engine có sẵn trên cùng máy. Nếu dùng engine dòng lệnh (CLI), hãy cài và đăng nhập nó trước khi mở ứng dụng. Nếu dùng engine qua API, bạn cấu hình trong Settings → Engines.
  • Docker chỉ cần cho tính năng tuỳ chọn là máy tính cô lập cho agent.
  • Tài khoản nhà cung cấp AI của bạn. Dùng mô hình có thể tốn tiền, do bên cung cấp tính.

Về hệ điều hành, README chưa nêu một danh sách rõ ràng cho bản chạy từ mã nguồn. Trong thư mục gốc có file run-desktop.bat, nhưng README không giải thích cách dùng nó. Bản cài đặt desktop trên trang Releases được ghi là thử nghiệm và chưa ký số. Bản tự host trên máy chủ cần máy chủ Linux, HTTPS, Docker hoặc Node.js cùng uv, và một engine. README không nói về yêu cầu phần cứng như GPU.

Suparagent không đi kèm mô hình AI. Khoá API bạn lưu qua Suparagent được mã hoá trên máy bạn, nhưng khi agent trả lời, engine bạn chọn sẽ nhận câu hỏi và ngữ cảnh của lượt đó. Nếu engine là dịch vụ trên mạng, dữ liệu đi theo điều khoản của nhà cung cấp đó. Đừng cho agent đọc thư mục chứa thông tin nhạy cảm nếu bạn chưa yên tâm.

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

Bản desktop chạy từ một thư mục mã nguồn. Các bước dưới đây bám đúng phần Quick start của README.

  1. Chuẩn bị công cụCài Node.js 22+, uv và một engine AI, đăng nhập engine nếu là CLI
  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 ứng dụngGõ npm run app
  5. Thiết lập lần đầuChọn engine, workspace và chế độ duyệt

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

Trước khi gõ lệnh nào của Suparagent, hãy chắc rằng máy bạn đã có Node.js 22 trở lên và uv. README không ghi lệnh cài hai công cụ này, nên bạn xem hướng dẫn trên trang chính thức của chúng. Với uv, README dẫn tới trang docs.astral.sh/uv.

Với engine, nếu bạn dùng Claude Code hay Codex CLI, hãy cài và đăng nhập nó trước. Chỗ người mới hay vấp là mở Suparagent trước rồi mới đăng nhập CLI, khiến ứng dụng báo chưa có engine. Nếu dùng API, bạn điền thông tin sau trong Settings → Engines.

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. Lệnh git clone sẽ tạo thư mục suparagent ngay tại đó. Bạn cần có Git trên máy.

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

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

Lệnh cd đưa terminal vào thư mục desktop bên trong dự án. Sau đó npm run app khởi động ứng dụng. Phải chạy lệnh này trong thư mục desktop, không phải thư mục gốc, nếu không npm sẽ không tìm thấy lệnh app.

Terminal
cd suparagent/desktop
npm run app

Lần chạy đầu có thể mất thời gian, vì README không mô tả chi tiết bước nó tự chuẩn bị gì. Cứ chờ đến khi cửa sổ ứng dụng hiện ra.

D.Thiết lập lần mở đầu tiên

Theo README, lần mở đầu bạn chọn engine, workspace và chế độ duyệt (approval mode). Nếu chưa chắc, hãy chọn Ask first: agent sẽ dừng và hỏi bạn trước các hành động cần duyệt. Đây là lựa chọn an toàn nhất cho người mới.

E.Muốn tự host trên máy chủ?

Repo có Dockerfile và compose.yaml, nhưng README chính chỉ trỏ tới "Self-hosting guide" mà không chép lệnh cụ thể. Mình sẽ không đoán lệnh ở đây. Bạn hãy mở thư mục docs/ và thư mục deploy/ trong repo để đọc hướng dẫn tự host. README ghi bản này cần máy chủ Linux, HTTPS và vẫn đang ở mức thử nghiệm.

Nếu bạn không muốn build từ mã nguồn, trang Releases của repo có bản cài desktop. README cảnh báo chúng là thử nghiệm, chưa ký số, và đường cập nhật giữa các bản chưa được kiểm chứng đầy đủ.

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

Không có lệnh kiểm tra riêng nào trong README. Cách kiểm tra là đi theo bốn bước README nêu:

  1. Cửa sổ ứng dụng mở được và hiện màn hình thiết lập lần đầu.
  2. Vào Settings → Engines và thấy engine của bạn ở trạng thái sẵn sàng (README dùng chữ "ready").
  3. Tạo một agent với tên, công việc rõ ràng và một workspace.
  4. Bắt đầu một cuộc chat với chế độ Ask first, gửi một câu đơn giản như "liệt kê các tệp trong thư mục làm việc".

Nếu agent trả lời, và khi cần thao tác nó dừng lại xin bạn duyệt, nghĩa là cài đặt đã ổn. Nếu engine không hiện ở trạng thái sẵn sàng, quay lại phần lỗi hay gặp bên dưới.

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

Các tình huống dưới đây bám đúng khả năng README mô tả. Cách đặt tên agent và câu lệnh mẫu là gợi ý của mình.

A.Chủ shop gom việc mỗi sáng

Bạn bán hàng online, sáng nào cũng phải lướt thư và lịch để biết hôm nay có gì. Hãy mở màn hình Today. Nó gom yêu cầu duyệt, câu hỏi, kết quả routine, lỗi engine và việc đến hạn vào một chỗ, và có thể hiện thư Gmail cùng lịch ở chế độ chỉ đọc. Để Gmail hiện được, bạn cần nối qua khoá Composio của riêng mình. Kết quả là một danh sách ngắn việc cần bạn xử lý trước, thay vì mở từng ứng dụng.

B.Nhân viên văn phòng soạn bản tóm tắt dự án hằng tuần

Đây là ví dụ chính trong README. Bạn tạo một agent trưởng nhóm cùng hai chuyên viên, một người nghiên cứu, một người biên tập. Cho cả ba cùng một 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 soạn 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 làm việc. Giao phần tổng hợp số liệu cho người nghiên cứu và phần viết lại cho người biên tập.

Trưởng nhóm chia việc thành các việc nhỏ, giao cho chuyên viên. Mỗi người làm trong một cuộc hội thoại 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 hành động khi cài đặt yêu cầu. Khi quy trình đã ổn, bạn biến nó thành routine chạy hằng tuần và xem lại kết quả mỗi lần chạy.

Agent làm việc thay bạn, nhưng người bấm "đồng ý" vẫn là bạn.

Ông T

C.Dev giao việc lặp lại và duyệt từ điện thoại

Bạn là lập trình viên, có vài việc lặp lại cần agent hỗ trợ. Tạo routine chạy theo lịch hoặc theo webhook trên agent chạy cục bộ. Lưu ý README nói routine chạy ở backend, nên backend phải luôn chạy thì lịch mới hoạt động. Nếu đã ghép app điện thoại với máy chủ của mình, bạn có thể cho phép hoặc từ chối một lệnh gọi công cụ ngay khi đang ở ngoài. README ghi app điện thoạ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.

D.Tái sử dụng chỉ dẫn bằng skill và mẫu

Bạn hay viết lại cùng một đoạn hướng dẫn, ví dụ "viết lại email theo giọng lịch sự, ngắn gọn". Hãy lưu nó thành skill và tạo agent mới từ một mẫu có sẵn. Mỗi lần cần, bạn chọn skill đó cho tin nhắn. Kết quả là bạn không phải gõ lại cùng một đoạn nhiều lần, và các agent mới có sẵn khung làm việc từ đầu.

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

Ứng dụng báo chưa có engine hoặc engine không sẵn sàng. Thường do chưa cài hoặc chưa đăng nhập CLI của engine trước khi mở ứng dụng. README yêu cầu đăng nhập trước. Hãy đăng nhập trong terminal, mở lại ứng dụng rồi vào Settings → Engines kiểm tra. Hoặc cấu hình một engine dùng API ở cùng màn hình đó.

npm run app không chạy hoặc báo thiếu lệnh. Hai nguyên nhân dễ gặp: bạn đang đứng sai thư mục (phải là suparagent/desktop), hoặc phiên bản Node.js cũ hơn 22. Hãy kiểm tra thư mục hiện tại và phiên bản Node, rồi thử lại. Kiểm tra thêm là bạn đã cài uv chưa.

Routine không chạy đúng giờ. Theo README, routine chạy ở backend nên backend phải luôn bật. Nếu bạn tắt máy hoặc đóng ứng dụng, lịch sẽ không chạy. Với việc cần chạy đều, README gợi ý host trên máy chủ bạn kiểm soát.

Tính năng không dùng được với engine đã chọn. Không phải engine nào cũng hỗ trợ nhập ảnh, máy tính riêng cho agent, kết nối ứng dụng hay làm trưởng nhóm. README ghi trưởng nhóm cần Claude hoặc Codex, và ứng dụng kết nối qua Composio chỉ dùng được với agent Claude hoặc Codex. Nếu một tính năng bị mờ, hãy xem trang "Engines and models" trong docs/ của repo để biết engine nào hỗ trợ gì.

Bản cài desktop bị hệ điều hành cảnh báo. README nói rõ các bản cài là 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. Nếu e ngại, bạn dùng cách chạy từ mã nguồn ở trên. Có lỗi lạ thì báo ở mục GitHub Issues của repo.

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 trong thư mục dữ liệu của máy bạn hoặc cơ sở dữ liệu của máy chủ bạn. Có nhiều mức duyệt, từ hỏi trước đến chỉ lập kế hoạch. Bạn chọn được engine, kể cả Ollama hoặc LM Studio nếu muốn chạy mô hình cục bộ, và không bị khoá vào một nhà cung cấp. Giấy phép Apache-2.0 cho phép dùng và sửa linh hoạt. Repo cũng được cập nhật trong vài tháng gần đây.

Giới hạn. Chính README thừa nhận dự án còn sớm và đang thay đổi. Bản tự host là thử nghiệm: một người làm chủ, có thể mời đồng đội với vai trò và quyền riêng, nhưng cả nhóm dùng chung agent, hội thoại và bộ nhớ. Nó không phải dịch vụ nhiều tổ chức. Máy tính Docker, công cụ trình duyệt và bản macOS gốc là tuỳ chọn thử nghiệm. Phần kết nối ứng dụng qua Composio mới được kiểm thử với một dịch vụ giả, chưa với dịch vụ thật. MCP Marketplace, máy tính đám mây và chuyển âm thanh thành chữ cũng chưa được kiểm chứng đầy đủ. Ngoài ra bạn vẫn phải tự lo tài khoản và chi phí mô hình AI.

Khi nào chọn cách khác. Nếu bạn cần công cụ ổn định cho công việc quan trọng ngay, hoặc cần giải pháp nhiều tổ chức, hãy cân nhắc kỹ trước khi dựa vào Suparagent. Nếu bạn chỉ cần trò chuyện đơn giản với AI, một ứng dụng chat thông thường sẽ nhẹ hơn. Nếu bạn không quen terminal và không muốn tự cài Node.js, uv, thì README cũng nhắc đến bản web có host (một sản phẩm riêng, do Suparagent vận hành, có gói trả phí), nhưng dữ liệu khi đó do dịch vụ đó xử lý theo điều khoản của họ. Với người muốn thử, lời khuyên của mình là bắt đầu bằng chế độ Ask first, một agent, một thư mục làm việc nhỏ không chứa dữ liệu nhạy cảm, rồi mở rộng dần.

4.7/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, bạn chạy bản desktop hoặc tự host mà không phải trả phí cho Suparagent. Tuy vậy, README nói rõ phần mềm không kèm mô hình AI, bạn tự mang tài khoản hoặc khoá API và phải trả cho nhà cung cấp theo mức dùng. Bản web có host là sản phẩm riêng, có gói trả phí.

Cần những gì để cài bản desktop?

Theo README: Node.js 22 trở lên, uv và ít nhất một engine có sẵn trên cùng máy. Docker chỉ cần nếu bạn dùng máy tính cô lập cho agent, là tính năng tuỳ chọn. Sau đó chạy git clone, cd suparagent/desktop và npm run app.

Có cần GPU không?

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

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

README chưa liệt kê rõ hệ điều hành cho bản chạy từ mã nguồn. Trong repo có file run-desktop.bat, nhưng README không giải thích. Bản cài desktop được ghi là thử nghiệm, chưa ký số và có kiểm chứng nền tảng hạn chế. Bạn nên xem thêm hướng dẫn thiết lập desktop trong docs/ của repo.

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 nằm trong thư mục dữ liệu của máy hoặc cơ sở dữ liệu của máy chủ bạn, còn khoá API lưu qua Suparagent được mã hoá ở đó. Tuy nhiên khi agent trả lời, engine được chọn sẽ nhận câu hỏi và ngữ cảnh cần thiết cho lượt đó. 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.

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

Bạn quyết định. Có các chế độ Ask first, Accept edits, Approve for me (cho Claude, Codex, Cursor) và Plan only. README nói rõ một routine không bao giờ tự phê duyệt hành động, và việc kết nối ứng dụng cũng chờ bạn duyệt thay đổi.

Suparagent dùng được với những 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 giao thức ACP, OpenRouter và API tương thích OpenAI như Ollama hay LM Studio. Tính năng sẵn có khác nhau theo engine. Chẳng hạn trưởng nhóm cần Claude hoặc Codex.

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
    4. D.Thiết lập lần mở đầu tiên
    5. E.Muốn tự host trên máy chủ?
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop gom việc mỗi sáng
    2. B.Nhân viên văn phòng soạn bản tóm tắt dự án hằng tuần
    3. C.Dev giao việc lặp lại và duyệt từ điện thoại
    4. D.Tái sử dụng chỉ dẫn bằng skill và mẫu
  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ỏ.