📦yilewang / llm-for-zotero
← 返回首页
An open-source research agent system for your Zotero library.
⚖️ AGPL-3.0#academic-paper#literature-analysis#llm-agent#zotero-plugin#zotero🌐 yilewang.github.io📅 创建于 2026-01-29🔄 更新于 2026-10-28
🔗 GitHub TypeScript

📄 仓库 README

在 GitHub 查看 ↗
来自 GitHub 仓库自述文件 · 版权归原作者所有

LLM for Zotero logo: a brain icon merged with the Zotero shield

LLM-for-Zotero: A Research Agent System for your Zotero Library

Zotero support Using Zotero Plugin Template License: AGPL v3 Latest release GitHub Stars GitHub Downloads buymeacoffee

LLM-for-Zotero brings Large Language Models into the Zotero reader, so you can ask questions, summarize papers, inspect figures, compare sources, and save notes without leaving your library. It works with standard API providers, local OpenAI-compatible models, WebChat, Codex App-Server, and Claude Code.

Documentation:

Screenshot of the llm-for-zotero sidebar inside the Zotero PDF reader

Screenshot 2026-10-26 at 17 39 20

Demo Video

How to do a library chat literature review with llm-for-zotero agent

Table of Contents

At a Glance

  • Chat with the current PDF, selected text, figures, screenshots, and uploaded documents directly inside Zotero.
  • Get grounded answers with citations that jump back to the source passage.
  • Compare multiple open papers or add external files as extra context.
  • Save answers, full conversations, and research notes to Zotero notes or local Markdown folders such as Obsidian and Logseq.
  • Enable Agent Mode for library-wide read, search, tagging, metadata, import, note-editing, and organization workflows.
  • Search the current public web and read relevant pages with Tavily, with source links attached to the answer.
  • Use your preferred backend: API keys, local models, ChatGPT WebChat, Codex App Server, or Claude Code.

What's New

  • Codex App Server is the recommended Codex path for ChatGPT Plus users. It runs through the local codex app-server runtime and is configured from the Agent tab.
  • Claude Code Mode runs Claude Code as a separate conversation system inside Zotero, using your own Claude Code login. The plugin starts and stops the small bridge it needs for you. It can use the plugin's Zotero tools to read your library and, with your approval, edit notes, tags, metadata, and imports.
  • One history lists Agent, Codex and Claude chats together. Click the runtime badge in the message box to switch runtimes, and attach an earlier conversation from the slash menu or by asking for it in plain words.
  • Side panel in the standalone window opens read-only past chats or a temporary side chat next to the main chat.
Earlier updates - **Skills** let you customize how Agent Mode handles research workflows. The plugin ships with 8 built-in skills and a portal for creating your own. - **General Web Search** lets the in-plugin Agent search the current public web with Tavily, read relevant pages, and attach source links to its answers. - **Standalone Window Mode** opens the assistant in a dedicated window with paper chat, library chat, and conversation history. - **File-Based Notes** save Markdown notes to local folders, including Obsidian, Logseq, or any plain Markdown directory. - **Cache-aware Agent Mode** preserves stable paper context, prior read evidence, and coverage state across longer research turns, then compacts old transcript history automatically when the context window gets crowded. - **Citation navigation** now keeps citation labels conservative until page locations are verified, while quote-based citations can jump back to the matching Zotero passage. - **MinerU PDF parsing** provides higher-fidelity extraction for tables, equations, figures, and local `mineru-api` servers, with a richer file manager for bulk parsing, cache repair, sync packages, tags, and parsing filters.

Thanks to @jianghao-zhang and @boltma for major contributions to the Codex App Server, Claude Code, and file upload workflows.

Quick Start

  1. Download the latest .xpi file from the Releases page.
  2. In Zotero, open Tools -> Add-ons -> gear icon -> Install Add-on From File, then select the .xpi.
  3. Restart Zotero.
  4. Open Preferences -> llm-for-zotero, choose a provider, enter the base URL, key, and model, then click Test Connection.
  5. Open a PDF in Zotero and click the LLM Assistant icon in the right-hand toolbar.

If you do not want to use a provider API key, start with WebChat or Codex App Server.

Configuration

Open Preferences -> llm-for-zotero.

  1. Select your Provider.
  2. Paste your API Base URL, secret key, and model name.
  3. Click Test Connection.
Setup animation, protocols, and multiple models

Animation showing provider and model configuration

The plugin supports multiple provider protocols, including `responses_api`, `openai_chat_compat`, `anthropic_messages`, and `gemini_native`. You can configure multiple providers and models for different tasks, such as a multimodal model for figures and a text model for summaries. The conversation panel also supports model-specific reasoning levels and hyperparameters such as `temperature` and `max_tokens_output`.

Demos

Grounded Paper Chat

On the first message, the model loads the current paper as context. Follow-up questions use focused retrieval from the same paper, keeping conversations fast and grounded. Click any generated citation to jump straight to the source passage in Zotero.

Show demo

Animation showing one-click jump from an AI citation to the paper source

Summaries and Selected Text

Summarize a full paper, focus on methodology or results, or select any paragraph and ask the model to explain it. The selected-text pop-up can add highlighted text to chat with one click. It can also be disabled in settings.

Show demos

Animation showing an instant paper summary in the sidebar

Animation showing selected text being explained by the model

Figures and External Files

Take screenshots of figures, attach up to 10 screenshots, or upload local files as additional context. Supported uploads include PDF, DOCX, PPTX, TXT, and Markdown.

Show demos

Animation showing screenshot-based figure interpretation

Animation showing external file upload for additional context

Multi-Paper Comparison

Open multiple papers in Zotero tabs and type / to cite another paper as additional context.

Show demo

Animation showing cross-paper comparison using the slash command

Notes, History, and Presets

Save answers or selected text to Zotero notes, export full conversations in Markdown, and customize quick-action presets for repeated research tasks.

Show demos

Animation showing model answers being saved to Zotero notes

Animation showing conversation export to Zotero notes with markdown

Animation showing custom quick-action preset configuration

Fi

📈 近 7 天 Star 趋势

每日新增 Star（柱）与累计 Star（线）· 数据来自 GitHub

🏆 排名变化趋势

在各榜单中的排名历史（数字越小越靠前）

📋 历史上榜记录

每次快照的详细数据
日期 榜单 排名 周期新增 总 STAR