Agentero README

The project's README from github.com/poco-ai/Agentero. As one markdown file: README.md.

Agentero

为人与 Agent 协作而生的一站式科研工作台

保留人类舒适的 PDF 阅读习惯,为模型提供纯净的结构化上下文;文献、笔记与交互记录统一沉淀于本地。

GitHub stars Release License: MIT Website Documentation

中文 | English

如果本项目对你有帮助,请在右上角给个 star 吧!

Give me a star


背景与设计初衷

Zotero 是学术管理领域非常优秀的软件。它功能成熟、生态稳定,帮助许多科研人员建立了最初的文献归档体系。

但在当下日常科研与深度使用各类 Agent 时,传统的文献工具链暴露出一些断点:

Agentero 并非旨在替代 Zotero,而是探索一种人与 Agent 协同处理科研上下文的新方式:


核心功能

1. 结构化阅读与笔记系统

PDF 阅读与 Agent 伴读
分屏阅读与分析:左侧高亮批注,右侧本地 Agent 基于准确的结构化上下文进行答疑与推导

划词翻译与笔记联动
划词翻译与实时记录:阅读过程中提取的要点可直接沉淀至本地 Markdown 笔记


2. 开放的 Agent 协议与自动化接口

内置 MCP 连接
内置 MCP 协议服务,支持将本地文献库无缝接入各类外部 AI 客户端


3. 学术雷达与文献发现

Cool Papers 集成
应用内直接浏览 Cool Papers 热门论文并一键导入本地知识库


4. 兼容 Zotero 生态与本地透明存储


界面与功能预览

点击展开:查看更多界面截图(RSS 订阅、技能扩展、Agent 配置、S3 云同步、主题风格)

1. 学术 RSS 订阅

追踪关注的学术博客、实验室主页与前沿动态:

RSS 订阅

2. Agent 技能(Skill)扩展

浏览并安装社区提供的科研技能,扩展论文精读与写作分析能力:

Skill 扩展

3. Agent 与连接配置

通过 ACP 协议管理、升级和切换本地 Agent:

Agent 设置

4. S3 兼容云存储同步

配置私有或商业 S3 存储,实现多设备间知识库同步:

S3 同步设置

5. 多套界面主题

支持亮色/暗色及多种配色风格,支持自适应系统外观设置:

主题配置


快速开始

桌面客户端安装 (macOS / Windows / Linux)

可前往 官网 agentero.app 或 GitHub Releases 下载适用于各平台的预编译安装包。

macOS (Homebrew)

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

Linux 用户须知:系统环境要求 Ubuntu 22.04+(依赖 webkit2gtk 4.1),详细依赖说明请参考 安装文档。


命令行工具 (CLI)

如需在终端或通过脚本自动化管理文献:

brew tap poco-ai/agentero
brew install agentero

# 查看常用命令与参数
agentero --help

在更多地方使用 Agentero


致谢与社区

用户交流群

Agentero 用户群二维码
扫码加入微信群:使用心得、问题反馈与版本预告。二维码 7 天内有效,过期请在 Issue 留言。

如果 Agentero 对你的日常学术研究有所帮助,欢迎在 GitHub 上为本项目点亮一个 ⭐ Star。

感谢所有贡献者!

contributors img Made with contrib.rocks

Star History

Star History Chart

开源许可证

本项目基于 MIT License 协议开源。第三方组件与许可证清单见 .github/THIRD_PARTY_NOTICES.md。

Agentero (poco-ai/Agentero)

Searching Database…

What is this?A desktop research workspace that puts your PDFs, Markdown notes and an AI agent in one place, so papers, notes and model conversations stay connected.
Is it meant to replace Zotero?No. It is designed to work alongside Zotero, and you can import a whole Zotero library with tags, notes and attachments kept.
How do I get it running?Download a prebuilt installer for macOS, Windows or Linux from agentero.app or GitHub Releases. Homebrew is also listed for macOS.
Do I need my own AI agent or API key?It connects to a local agent over the ACP protocol, such as Claude Code, OpenCode, Codex or a local model. A built-in translation channel is included, and you can add your own API key (BYOK) for translation.
Any install pitfalls?On Linux you need Ubuntu 22.04 or newer with webkit2gtk 4.1. The README points to a separate install guide for the other dependencies.
What makes the PDF reading different from a normal reader?It extracts formulas, algorithm pseudocode and tables into structured Markdown and LaTeX. The agent then works from that clean text instead of guessing from the two-column layout of the PDF.
Can an agent in another app use my library?Yes. Agentero can run as an MCP server, so clients such as ChatGPT Web or Claude Desktop can search your local literature and use it as context.
Can I automate imports from a script?There is a headless CLI for batch imports, metadata extraction and writing notes. It also supports BibTeX and BibLaTeX export.
Why did the author build this instead of using Zotero plus plugins?The author found that papers, notes and model chats were scattered across Zotero, Obsidian and browser tabs, and that PDFs are hard for models to parse. Agentero keeps these in one local place and tries to close that gap.
Creator
poco-ai
Size
43.8 MB
Stars
1.6K
Age
4mo
Commits · 90 Days