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

Agentero: bàn làm việc nghiên cứu cho người và AI Agent — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật
Agentero: bàn làm việc nghiên cứu cho người và AI Agent — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Agentero là ứng dụng desktop mã nguồn mở (MIT) để đọc PDF, ghi chú Markdown và quản lý tài liệu nghiên cứu. Điểm đặc biệt là nó cho các AI Agent chạy trên máy bạn, như Claude Code, OpenCode hay Codex, đọc cùng kho tài liệu đó. Cài khá dễ: tải bộ cài từ trang chủ hoặc GitHub Releases, hoặc dùng Homebrew trên macOS.

Agentero là một ứng dụng desktop mã nguồn mở, đóng vai bàn làm việc nghiên cứu cho cả người lẫn AI Agent. Bạn đọc PDF, ghi chú, quản lý tài liệu trong một app. Các Agent chạy trên máy bạn cũng đọc được đúng kho tài liệu và ghi chú đó, nên bạn không phải copy-paste qua lại nữa.

Vấn đề mà tác giả nhắm tới khá quen thuộc. Bài báo nằm trong Zotero, ghi chú nằm trong Obsidian, còn phần trao đổi với AI nằm rải rác trên các khung chat web. Ba nơi tách biệt, mỗi lần nhờ AI phân tích một bài báo kèm ghi chú cũ, bạn lại phải dán thủ công. Thêm nữa, PDF hai cột, bảng nhiều trang và công thức toán rất khó cho mô hình đọc đúng. Agentero trích các phần này ra Markdown và LaTeX để mô hình hiểu chính xác hơn.

Repo hiện có khoảng 2464 sao và 151 fork, giấy phép MIT, viết chủ yếu bằng TypeScript và vẫn được cập nhật trong vài tháng gần đây. Tác giả nói rõ Agentero không nhằm thay thế Zotero. Nó là một cách làm khác cho thời đại có Agent. Công cụ hợp với sinh viên, nghiên cứu sinh, người làm báo cáo cần đọc nhiều tài liệu, và lập trình viên muốn nối kho tài liệu vào AI. Chỗ đáng giá nhất là mọi thứ nằm trên máy bạn dưới dạng file PDF và Markdown thông thường.

Ứng dụng

poco-ai/Agentero

Ứng dụng desktop mã nguồn mở gom đọc PDF, ghi chú và hỏi đáp có trích dẫn vào một nơi, để bạn và AI Agent cùng làm việc trên một kho tài liệu.

★ 2.5kTypeScriptMIT
Xem repo trên GitHub

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

Tính năng của Agentero chia thành vài nhóm. Mình tóm lại theo lợi ích thực tế.

A.Đọc PDF và ghi chú ngay trong một app

Trình đọc PDF có mục lục điều hướng, chế độ vừa trang hoặc vừa chiều rộng, bôi đen chọn chữ, highlight, chú thích và tìm kiếm toàn văn. Bên cạnh là trình soạn ghi chú Markdown dạng xem trước là thấy luôn (WYSIWYG). Nó hỗ trợ liên kết hai chiều kiểu [[tên ghi chú]], lệnh nhanh bằng dấu / và hiển thị công thức LaTeX. Ghi chú gắn thẳng với bài báo, bạn không phải tự đồng bộ giữa hai app.

B.Trích công thức, bảng, thuật toán thành văn bản sạch

App tự phân tích công thức toán, mã giả thuật toán và bảng trong bài báo, rồi xuất ra Markdown và LaTeX. Agent đọc dạng này ít nhầm hơn đọc PDF thô. Nếu bạn từng thấy AI đọc sai một bảng số liệu, đây là phần giải quyết đúng chuyện đó.

C.Dịch thuật nhiều kiểu

Bạn có thể dịch đoạn bôi đen, dịch đối chiếu theo trang hoặc dịch cả bài. App có sẵn kênh dịch dùng được và cho phép bạn điền API key của riêng mình (BYOK).

D.Kết nối Agent chạy trên máy

Agentero dùng giao thức Agent Client Protocol (ACP) để nối với các Agent cục bộ như Claude Code, OpenCode, Codex hoặc mô hình chạy local. Nó không bó vào một hãng nào, và theo README thì ngữ cảnh được giữ trên máy bạn.

E.Chạy như MCP server và có CLI

App có thể làm MCP server (Model Context Protocol). Nhờ vậy các client như ChatGPT Web hay Claude Desktop có thể tra cứu kho tài liệu cục bộ của bạn. Ngoài ra có công cụ dòng lệnh không giao diện, để viết script nhập tài liệu hàng loạt, lấy metadata và ghi ghi chú.

F.Tìm tài liệu mới và theo dõi trích dẫn

App tích hợp Cool Papers và ModelScope (Mô Đáp), cho phép duyệt và lưu bài báo bằng một cú bấm, kèm đăng ký RSS học thuật. Nó còn gợi ý bài arXiv mới mỗi ngày dựa trên những gì bạn đã có trong kho. Phần danh sách tài liệu tham khảo cuối bài có thể được phân tích và nhập hàng loạt, và app theo dõi được các bài trích dẫn sau đó.

G.Tương thích Zotero và lưu trữ minh bạch

Bạn có thể nhập cả thư viện Zotero (giữ thẻ, ghi chú, tệp đính kèm), dùng tiện ích trình duyệt của Zotero để lưu bài, và xuất BibTeX hoặc BibLaTeX. Dữ liệu không nằm trong cơ sở dữ liệu riêng, chỉ là PDF và Markdown trong thư mục thường, nên bạn mở bằng trình soạn thảo khác vẫn được. App còn hỗ trợ đồng bộ qua dịch vụ lưu trữ tương thích S3 và truy cập kho đặt trên máy chủ từ xa qua đường hầm SSH.

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

Theo README, bạn cần ít thứ để cài bộ cài sẵn:

  • Hệ điều hành: macOS, Windows hoặc Linux. Có bộ cài biên dịch sẵn cho từng nền tảng.
  • Linux: cần Ubuntu 22.04 trở lên, vì app phụ thuộc webkit2gtk 4.1. README gửi bạn sang tài liệu cài đặt để xem chi tiết.
  • macOS: nếu muốn cài bằng dòng lệnh thì cần Homebrew.
  • Để dùng Agent: bạn cần một Agent chạy cục bộ (README nêu Claude Code, OpenCode, Codex hoặc mô hình local). Chuyện Agent đó cần tài khoản hay key gì là do Agent đó quy định, README Agentero không nói.
  • Để dùng dịch thuật bằng key riêng: README chỉ nói app cho phép điền API key của bạn, không nêu nhà cung cấp cụ thể.

README không nêu yêu cầu phần cứng như GPU hay dung lượng RAM. Phần đó chưa có thông tin.

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

  1. Chọn cách càiTải bộ cài từ trang chủ hoặc GitHub Releases, hoặc dùng Homebrew
  2. Cài app desktopChạy bộ cài (Windows, Linux) hoặc lệnh brew (macOS)
  3. Cài thêm CLI (tuỳ chọn)Dùng brew để có lệnh agentero trong terminal
  4. Kiểm tra CLIGõ agentero --help để xem danh sách lệnh
  5. Cài plugin dsh (tuỳ chọn)Nếu bạn dùng DeepSeek Harness

A.Cài app desktop trên Windows và Linux

README hướng dẫn tải bộ cài biên dịch sẵn từ trang chủ agentero.app hoặc từ mục Releases của repo trên GitHub. README không ghi lệnh cài cho hai hệ điều hành này, nên bạn chỉ cần tải file đúng với máy mình rồi mở lên cài như phần mềm bình thường. Người dùng Linux nhớ kiểm tra máy có Ubuntu 22.04 trở lên. Nếu muốn xem chi tiết phụ thuộc, hãy vào thư mục docs/ trong repo hoặc mục tài liệu cài đặt mà README nhắc tới.

B.Cài app desktop trên macOS bằng Homebrew

Mở ứng dụng Terminal rồi chạy hai lệnh sau. Lệnh đầu thêm kho phần mềm của tác giả, lệnh thứ hai cài app (chữ --cask nghĩa là cài ứng dụng có giao diện).

Terminal
brew tap poco-ai/agentero
brew install --cask agentero

Nếu máy chưa có Homebrew, bạn có thể tải bộ cài từ trang chủ hoặc Releases thay vì dùng lệnh.

C.Cài công cụ dòng lệnh (CLI)

Bước này dành cho bạn nào muốn viết script nhập tài liệu hàng loạt hay tự động hoá. Cũng trên Terminal:

Terminal
brew tap poco-ai/agentero
brew install agentero

# xem các lệnh và tham số thường dùng
agentero --help

Lưu ý chỗ này khác với lệnh ở bước trước: không có --cask, vì đây là công cụ dòng lệnh chứ không phải app có cửa sổ. README chỉ ghi cách cài CLI bằng Homebrew. Cách cài CLI trên Windows hay Linux README chưa ghi, bạn xem thêm trong docs/ hoặc thư mục cli/ của repo.

D.Cài plugin cho DeepSeek Harness (tuỳ chọn)

Nếu bạn dùng DeepSeek Harness (dsh), có một plugin để dùng kho tài liệu, ghi chú và trình đọc PDF của Agentero ngay trong đó. Chạy lệnh sau trong terminal đã có dsh:

Terminal
dsh plugin --profile web add @poco-ai/agentero-dsh

Chi tiết nằm ở repo riêng tên agentero-dsh-plugin của cùng tác giả.

E.Build từ mã nguồn

Repo có package.json, Cargo.toml và thư mục src-tauri/, nên đây là app Tauri. README chưa hướng dẫn build từ mã nguồn. Nếu cần, hãy đọc CONTRIBUTING.md trong repo. Người mới nên dùng bộ cài biên dịch sẵn cho nhanh.

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

Với app desktop, cách kiểm tra đơn giản nhất là mở app lên và thấy giao diện chính xuất hiện. README không mô tả màn hình đầu tiên chi tiết hơn, nên bạn thử nhập một file PDF để xem trình đọc có mở được không.

Với CLI, chạy:

Terminal
agentero --help

Nếu terminal in ra danh sách lệnh và tham số, bản CLI đã cài xong. Nếu báo không tìm thấy lệnh, hãy đóng terminal rồi mở lại, hoặc kiểm tra lại bước brew install agentero.

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

Các tình huống dưới đây bám theo những gì README nói app làm được. Phần câu hỏi mẫu là gợi ý để bạn thử, kết quả thực tế còn tuỳ Agent bạn nối vào.

A.Nghiên cứu sinh đọc một bài báo khó

Bạn kéo một bài báo PDF vào app, mở trình đọc và highlight những đoạn quan trọng. Bên cạnh, bạn mở khung Agent đã nối với một Agent chạy trên máy, ví dụ Claude Code. Bạn có thể hỏi: giải thích công thức ở mục 3 bằng lời dễ hiểu. Hoặc: bảng so sánh ở trang 7 cho thấy điều gì. Vì app đã trích công thức và bảng ra Markdown và LaTeX, Agent có ngữ cảnh sạch để trả lời. Ý hay nào bạn thấy đáng giữ, bạn ghi vào ghi chú Markdown ngay cạnh bài báo.

Bạn lo việc đặt câu hỏi và phán đoán giá trị, còn việc nhặt số liệu, công thức, danh sách trích dẫn cứ để Agent làm.

Ông T

B.Sinh viên chuyển từ Zotero sang

Bạn đang có cả thư viện Zotero với vài trăm bài, kèm thẻ và ghi chú. Thay vì làm lại từ đầu, bạn dùng tính năng nhập cả thư viện Zotero của Agentero. Thẻ, ghi chú và tệp đính kèm được giữ lại. Bạn vẫn có thể dùng tiện ích trình duyệt của Zotero để lưu bài mới. Khi viết luận văn, bạn xuất BibTeX hoặc BibLaTeX để dùng với trình soạn thảo của mình. Cách này hợp với người muốn thử Agent mà chưa muốn bỏ thói quen cũ.

C.Nhân viên phân tích theo dõi tài liệu mới mỗi ngày

Bạn làm ở bộ phận nghiên cứu thị trường hoặc công nghệ và cần cập nhật bài mới. Bạn đăng ký RSS của các blog hay phòng thí nghiệm mình quan tâm, duyệt Cool Papers ngay trong app và lưu bài cần đọc bằng một cú bấm. App còn gợi ý bài arXiv mới dựa trên kho tài liệu hiện có của bạn. Cuối tuần, bạn mở từng bài đã lưu, ghi chú, rồi nhờ Agent tóm tắt những bài bạn đánh dấu.

D.Lập trình viên nối kho tài liệu vào công cụ AI khác

Bạn đã có kho tài liệu trong Agentero và muốn hỏi nó từ Claude Desktop hoặc ChatGPT Web. README cho biết app có thể chạy như MCP server để các client này tra cứu kho cục bộ. Cách bật và cấu hình README không ghi từng bước, nên bạn xem trong docs/ hoặc phần cài đặt của app. Với việc nhập hàng loạt, bạn dùng CLI sau khi xem agentero --help để biết lệnh nào dùng cho nhập tài liệu, lấy metadata hay ghi ghi chú.

Kho tài liệu của bạn có thể chứa bài báo chưa công bố hoặc tài liệu nội bộ. Khi nối Agent, MCP hay đồng bộ S3, hãy kiểm tra Agent đó gửi dữ liệu đi đâu và ai có quyền vào bucket S3. API key dịch thuật hay key của Agent là của bạn, đừng chia sẻ và hãy theo dõi chi phí gọi API.

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

README không có mục xử lý lỗi, nên dưới đây là những chỗ rất dễ vấp với loại ứng dụng này. Nếu gặp lỗi lạ, hãy xem mục Issues của repo.

A.Lệnh agentero báo không tìm thấy

Thường là terminal chưa nhận lệnh mới cài. Đóng hẳn cửa sổ terminal rồi mở lại, sau đó chạy agentero --help. Nếu vẫn lỗi, kiểm tra xem lệnh brew install agentero có chạy xong không có lỗi. Nhớ rằng cách cài CLI trong README là cho Homebrew.

B.Cài nhầm bản app và bản CLI

Lệnh có --cask cài app có giao diện, lệnh không có --cask cài công cụ dòng lệnh. Muốn dùng đủ cả hai thì chạy cả hai lệnh.

C.App không chạy trên Linux

Kiểm tra hệ điều hành có phải Ubuntu 22.04 trở lên không và đã có webkit2gtk 4.1 chưa. Đây là yêu cầu README nêu rõ. Nếu máy cũ hơn, bạn nên cân nhắc dùng máy khác hoặc hệ điều hành mới hơn.

D.Agent không kết nối hoặc không trả lời

Agent là chương trình riêng, Agentero chỉ nối vào qua giao thức ACP. Hãy chắc là Agent đó (ví dụ Claude Code) đã cài và đăng nhập được khi chạy độc lập trước. Sau đó vào phần cấu hình Agent trong app để thêm hoặc đổi. Nếu vẫn lỗi, mở Issue kèm tên Agent và hệ điều hành bạn dùng.

E.Dịch thuật không chạy khi dùng key riêng

Kiểm tra lại key đã dán đúng chưa và tài khoản nhà cung cấp còn hạn mức không. Nếu chỉ cần dịch thử, bạn có thể thử kênh dịch có sẵn mà README nói là đã được tích hợp.

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

Điểm mạnh của Agentero nằm ở việc gom đọc PDF, ghi chú, dịch và Agent vào một chỗ. Dữ liệu là file PDF và Markdown thông thường trên máy, bạn không bị khoá vào định dạng riêng. Nó không bó vào một hãng AI: nối được Agent chạy cục bộ qua ACP, và đóng vai MCP server cho client khác. Giấy phép MIT, có CLI để tự động hoá, và nhập được thư viện Zotero cũ.

Giới hạn cũng cần nói thẳng. README chủ yếu viết bằng tiếng Trung (có bản tiếng Anh), chưa thấy giao diện hay tài liệu tiếng Việt. Một số cách cài, như CLI trên Windows hoặc Linux và việc bật MCP, README chưa ghi từng bước. Chất lượng trả lời phụ thuộc vào Agent bạn nối vào, chứ không phải bản thân app. README cũng không nói về yêu cầu phần cứng hay hiệu năng với kho tài liệu rất lớn.

Nên chọn Agentero nếu bạn đọc nhiều bài báo, hay dùng AI để hỏi đáp và muốn mọi thứ nằm gọn trên máy mình. Nếu bạn chỉ cần quản lý trích dẫn đơn giản và đã hài lòng với Zotero, bạn chưa cần đổi. Cách an toàn là cài thử song song và nhập một phần thư viện để xem có hợp với thói quen của mình không.

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

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

Repo dùng giấy phép MIT, là mã nguồn mở, và bộ cài tải từ trang chủ hoặc GitHub Releases. README không nói về gói trả phí. Chi phí có thể phát sinh nếu bạn dùng API key riêng cho dịch thuật hoặc dùng Agent tính phí theo lượng dùng.

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

Được. README nêu có bộ cài biên dịch sẵn cho macOS, Windows và Linux, tải từ trang chủ hoặc GitHub Releases. Riêng Linux cần Ubuntu 22.04 trở lên vì phụ thuộc webkit2gtk 4.1.

Cần GPU hay máy cấu hình mạnh không?

README không nêu yêu cầu phần cứng nào, nên chưa có thông tin chính thức. Việc Agent hay mô hình local bạn nối vào có cần GPU hay không là tuỳ chính Agent hoặc mô hình đó.

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

README nói tài liệu và ghi chú được lưu trên máy dưới dạng PDF và Markdown, và ngữ cảnh khi dùng Agent cục bộ được giữ trên máy. Tuy vậy, nếu bạn bật đồng bộ S3, nối MCP với client bên ngoài hoặc dùng API của bên thứ ba thì dữ liệu có thể đi ra ngoài, bạn nên kiểm tra kỹ từng kết nối.

Agentero khác gì Zotero?

Tác giả nói Agentero không nhằm thay thế Zotero mà bổ sung phần làm việc với Agent. Nó trích công thức, bảng thành Markdown và LaTeX cho mô hình, có sẵn ghi chú, dịch thuật và kết nối Agent qua ACP và MCP. Nó cũng nhập được thư viện Zotero và tương thích tiện ích trình duyệt của Zotero.

Agentero dùng được với Claude Code hay ChatGPT không?

README nêu Agentero kết nối với các Agent cục bộ như Claude Code, OpenCode, Codex hoặc mô hình local qua giao thức ACP. Ngoài ra nó chạy được như MCP server để ChatGPT Web hay Claude Desktop tra cứu kho tài liệu cục bộ. Các bước bật chi tiết README chưa viết, bạn xem trong tài liệu của repo.

Có cài được bằng dòng lệnh không?

Có trên macOS: brew tap poco-ai/agentero rồi brew install --cask agentero cho app, hoặc brew install agentero cho công cụ dòng lệnh. Trên Windows và Linux README chỉ nêu việc tải bộ cài, chưa ghi lệnh cài.

Chuyển nhanh tới mục

  1. I.Agentero làm được gì
    1. A.Đọc PDF và ghi chú ngay trong một app
    2. B.Trích công thức, bảng, thuật toán thành văn bản sạch
    3. C.Dịch thuật nhiều kiểu
    4. D.Kết nối Agent chạy trên máy
    5. E.Chạy như MCP server và có CLI
    6. F.Tìm tài liệu mới và theo dõi trích dẫn
    7. G.Tương thích Zotero và lưu trữ minh bạch
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài app desktop trên Windows và Linux
    2. B.Cài app desktop trên macOS bằng Homebrew
    3. C.Cài công cụ dòng lệnh (CLI)
    4. D.Cài plugin cho DeepSeek Harness (tuỳ chọn)
    5. E.Build từ mã nguồn
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Nghiên cứu sinh đọc một bài báo khó
    2. B.Sinh viên chuyển từ Zotero sang
    3. C.Nhân viên phân tích theo dõi tài liệu mới mỗi ngày
    4. D.Lập trình viên nối kho tài liệu vào công cụ AI khác
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh agentero báo không tìm thấy
    2. B.Cài nhầm bản app và bản CLI
    3. C.App không chạy trên Linux
    4. D.Agent không kết nối hoặc không trả lời
    5. E.Dịch thuật không chạy khi dùng key riêng
  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ỏ.