Skip to main content

Installation Guide

System Requirements​

  • Zotero: 7.0 through 10.x
  • Platform: Windows 10+, macOS 12+, Linux (x86_64 / x86 / ARM64 / ARM)

About Zotero Versions: This plugin supports Zotero 7, 9, and 10. Zotero 10 is recommended.

Installing the Plugin​

  1. Visit GitHub Releases or Gitee Releases Mirror
  2. Download the latest .xpi file
  3. In Zotero, open Tools → Add-ons
  4. Click the gear icon and select Install Add-on From File...
  5. Select the downloaded .xpi file

Via Zotero Plugin Marketplace​

If you have the Zotero Plugin Marketplace plugin installed, you can search for and install Zotero Agents directly from the marketplace:

  1. Click the icon in the Zotero toolbar to open the marketplace
  2. Search for Zotero Agents
  3. Click install

Building from Source​

git clone https://github.com/leike0813/zotero-agents.git
cd zotero-agents
npm install
npm run build

The build output is located in the .scaffold/build/ directory.

Installing Official Workflow Packages​

The plugin ships with no built-in business logic. All workflows are provided through separate official workflow packages.

  1. After restarting Zotero, right-click any item → Zotero Agents → 📦 Install Official Workflow Packages
  2. The plugin automatically downloads the latest official packages from GitHub / Gitee
  3. A success notification appears upon completion; all official workflows will then be visible in the Dashboard

Method 2: Install from Preferences​

  1. Open Zotero → Settings → Zotero Agents
  2. In the Workflow Settings section, click Install Official Workflow Packages
  3. You can also switch the update channel (stable / beta / dev) here and check for updates

Update Mechanism​

  • The plugin automatically checks for new versions of official packages on startup
  • A confirmation dialog appears when a new version is available
  • The workflow list is automatically reloaded after updating

Official Workflow Package Repository: GitHub · Gitee Mirror

Verifying the Installation​

  1. Restart Zotero
  2. You should see the Zotero Agents icon in the Zotero toolbar
  3. Right-click any item — the Zotero Agents submenu should appear (with available workflows)

If the right-click menu only shows a 📦 Install Official Workflow Packages option, the official packages have not been installed yet — follow the instructions above to install them. After successful installation, proceed to Getting Started to configure a backend and run your first workflow.