Plugins / AI & summaries

Iris

by zbhou2002 · github.com/zbhou2002/iris-zotero

An AI reading assistant in the reader sidebar.

Iris has a Zotero Plugins grade of C (not recommended) because it installs and runs npm or PyPI packages without a fixed version. It works with Zotero 7–10. Last checked 15 Nov 2026.

View source
Downloads a .xpi file (1.7 MB). In Zotero, open Tools → Plugins and install it from the file.
In useAn estimate of how many copies of Zotero have it: Zotero downloads each new version once for every copy that has the plugin, so we count the downloads of its most-downloaded recent release. Rounded. Plugins that update from outside GitHub count low.
8
DownloadsAll-time downloads of its release files from GitHub, counting every update. Installs from elsewhere aren't counted.
43
Latest releaseDownloads of version 3.4.20, its latest release, since it came out on 1 Oct 2026. A new release starts from zero; Downloads counts every release.
8
ReleasesVersions published on GitHub. Everyone who has the plugin downloads each one again, which adds up in Downloads.
14
AgeTime since its GitHub repository was created, on 8 Sep 2026. The plugin can be younger than its repository.
2 months
StarsPeople who starred the repository on GitHub: a rough measure of interest.
1
ContributorsPeople who have committed code to this plugin. Bots don't count, nor do the authors of a template or project it was copied from.
1
LicenceThe licence the code is published under, as GitHub reports it.
AGPL-3.0
C
Zotero Plugins gradeNot recommended
because it installs and runs npm or PyPI packages without a fixed version
Applies to v3.4.20, released 1 Oct 2026Code checked · not yet tested in a live Zotero
Another plugin uses the same IDOne other plugin shares this add-on ID. Zotero can only install one of them.
What we found in the codeSets the gradeThe worst finding in these three areas sets the grade.
Code transparencyReadable code, uploaded by the project's automated GitHub buildThe release file was uploaded by the project's automated GitHub build. We haven't yet rebuilt it from the source to compare.LowLow concern: normal for plugins that do this job. Listed so you know.
Updates
Updates come from this project's GitHub repositoryThe update address offers this version
Where your data goesOnly contacts services we could identify20 addresses in 6 groups.LowLow concern: normal for plugins that do this job. Listed so you know.
AI services (7)
Codex CLI (OpenAI)Gemini CLI (Google)api.individual.githubcopilot.comautopush-cloudcode-pa.sandbox.googleapis.comnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.chatgpt.comcloudcode-pa.googleapis.comdaily-cloudcode-pa.sandbox.googleapis.comnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.
Translation (1)
pdf2zh-next (SiliconFlow, or the engine it's set up with)
Scholarly services (6)
api.crossref.orgapi.openalex.orgnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.api.semanticscholar.orgdoi.orgnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.eutils.ncbi.nlm.nih.govwww.ncbi.nlm.nih.gov
Apps you connect (3)
accounts.google.comnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.oauth2.googleapis.comwww.googleapis.comnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.
Code hosting (1)
github.com
On your computer (2)
127.0.0.1named in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.localhostnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.
Where we found it
api.individual.githubcopilot.comcontent/scripts/aidea.js · line 26251
DEFAULT_COPILOT_API_BASE = "https://api.individual.githubcopilot.com";
chatgpt.comcontent/scripts/aidea.js · line 21929
return "$env:CODEX_NON_INTERACTIVE=1; $sys=$env:SystemRoot; $env:Path=(Join-Path $sys 'System32')+';'+$sys+';'+(Join-Path $sys 'System32\\WindowsPowerShell\\v1.0')+';'+$env:Path; irm https://cha
cloudcode-pa.googleapis.comcontent/scripts/aidea.js · line 24323
"https://cloudcode-pa.googleapis.com",
Powerful capabilitiesInstalls and runs npm or PyPI packages without a fixed version, and 12 moreHighHigh concern: a serious problem. One high finding makes the grade C.
High concern (1)
Installs and runs npm or PyPI packages without a fixed version
Medium concern (7)
Signs in using another app's identityChanges settings in other programs or on your computerKeeps its own tables in Zotero's databaseA zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit)A zotero:// link can make it run code if you approve a prompt (from zotero-plugin-toolkit)Launches programs on your computerReuses a sign-in you saved in another program
Low concern (5)
Uses the clipboardStores API keys or passwordsDownloads uv and installs Python and speech packages when you turn on voice inputWorks with files on your computerRuns its own server for programs on this computer
Where we found it
Installs and runs npm or PyPI packages without a fixed versioncontent/scripts/aidea.js · line 24830

pdf2zh_next: installs the newest version each time

let updateResult = await runExecutableCommand(npmState.npmPath, [
Signs in using another app's identitycontent/scripts/aidea.js · line 26289

Signs in as GitHub Copilot for VS Code

COPILOT_GITHUB_CLIENT_ID = "Iv1.b507a08c87ecfe98";
Changes settings in other programs or on your computercontent/scripts/aidea.js · line 22202

Changes Zotero's proxy settings, at startup, without asking; changes the settings of conda and npm; adds a folder to your PATH

prefSvc.setIntPref("network.proxy.type", 1);
Keeps its own tables in Zotero's databasecontent/scripts/aidea.js · line 18758
await Zotero.DB.queryAsync(
A zotero:// link (a web page can open one) can make it install add-o…content/scripts/aidea.js · line 511

zotero://plugin. zotero-plugin-toolkit removed this link in version 6.0.0; this plugin is built with an older version

Services.io.getProtocolHandler("zotero").wrappedJSObject._extensions["zotero://plugin"] = pluginBridgeExtension;
A zotero:// link can make it run code if you approve a promptcontent/scripts/aidea.js · line 467

zotero://ztoolkit-debug

Services.io.getProtocolHandler("zotero").wrappedJSObject._extensions["zotero://ztoolkit-debug"] = debugBridgeExtension;
Launches programs on your computercontent/scripts/aidea.js · line 21165

Programs it names include cmd, codesign, ditto, pkill, powershell and 3 more

const execFn = Zotero?.Utilities?.Internal?.exec;
Reuses a sign-in you saved in another programcontent/scripts/aidea.js · line 23127

Reuses the sign-in you saved in Codex CLI, Gemini CLI

const authPath = joinPath2(home, ".codex", "auth.json");
Downloads uv and installs Python and speech packages when you turn o…content/scripts/aidea.js · line 55266

It comes straight from Astral, who make uv, over an encrypted connection, as it would if you installed it yourself. When you choose to install voice input (the button says about 700 MB), it downloads uv and uses it to install Python, speech packages and a speech model. The README says a one-time download is needed but doesn't name uv. We reviewed version 3.4.18; this release has the same code.

"irm https://astral.sh/uv/install.ps1 | iex"
Before you installShown, not gradedFacts to help you decide. They don't change the grade.
Works withZotero 7, 8, 9, 10Updates automatically
Zotero 7 ✓ worksZotero 8 ✓ worksZotero 9 ✓ worksZotero 10 ✓ worksZotero 11 beta not tested yet: Zotero hasn't opened Zotero 11 testing
What you'll needAn API keyDetected automatically from its code
No further detail for this area yet.
MaintenanceActive · last release 1 Oct 20261 contributor
No further detail for this area yet.
LanguagesDocumentation in English and ChineseInterface: English and Chinese
No further detail for this area yet.
We report what we found in the code. Open any area for the evidence.How we gradeReport a problem

What it does

Written by AI from the README

An AI reading assistant in the reader sidebar. Ask about a selected passage, translate text in place, dictate questions with local Whisper speech to text, and highlight a paper's contributions and evidence. Connect a Codex account sign-in or your own API endpoint and key.

Understanding a paper often means copying passages into a separate chat app. Iris keeps questions, translation and voice input next to the PDF.

What you'll need

Detected automatically
  • An API keyNeeds a key you get from the service (OpenAI Codex account, Google Gemini account and your own API provider). What needs it: the AI model: a supported Codex account sign-in (the default) or your own API endpoint and key.

Where your data goes

We found: only contacts services we could identify. 20 addresses in 6 groups.

AI services (7)
Codex CLI (OpenAI)Gemini CLI (Google)api.individual.githubcopilot.comautopush-cloudcode-pa.sandbox.googleapis.comnamed in its codechatgpt.comcloudcode-pa.googleapis.comdaily-cloudcode-pa.sandbox.googleapis.comnamed in its code
Translation (1)
pdf2zh-next (SiliconFlow, or the engine it's set up with)
Scholarly services (6)
api.crossref.orgapi.openalex.orgnamed in its codeapi.semanticscholar.orgdoi.orgnamed in its codeeutils.ncbi.nlm.nih.govwww.ncbi.nlm.nih.gov
Apps you connect (3)
accounts.google.comnamed in its codeoauth2.googleapis.comwww.googleapis.comnamed in its code
Code hosting (1)
github.com
On your computer (2)
127.0.0.1named in its codelocalhostnamed in its code
Evidence · file and line
api.individual.githubcopilot.comcontent/scripts/aidea.js · line 26251
DEFAULT_COPILOT_API_BASE = "https://api.individual.githubcopilot.com";
chatgpt.comcontent/scripts/aidea.js · line 21929
return "$env:CODEX_NON_INTERACTIVE=1; $sys=$env:SystemRoot; $env:Path=(Join-Path $sys 'System32')+';'+$sys+';'+(Join-Path $sys 'System32\\WindowsPowerShell\\v1.0')+';'+$env:Path; irm https://cha
cloudcode-pa.googleapis.comcontent/scripts/aidea.js · line 24323
"https://cloudcode-pa.googleapis.com",

Forks and copies

1 other plugin uses the same ID as this one. Every Zotero plugin carries an ID, a name tag Zotero uses to tell plugins apart. These 2 plugins carry the same one.Show what this means
  • You can only have one. Zotero sees them as the same plugin.
  • Installing another replaces it. If you install one of the others, it takes this one's place.
  • They do different things. The one you install may have nothing to do with the one it replaces.
Iris · this pluginzbhou2002/iris-zoteroCNot recommended431 Oct 2026
AIdeaVisterainer/aidea-zoteroCNot recommended28,35112 Nov 2026
See all 2 and how they differ →

No forks listed.

The developer's response

The developer hasn't responded. Developers can reply here, and their reply sits next to our findings.I'm the developer

Ratings and reviews

What people who use it say. This is separate from the grade, which is what the code does, and never changes it.

No ratings yet.

Write a review
Your rating of Iris v3.4.20

Your review is public, under the name you give, and published with the directory's data under CC BY 4.0. Links are removed. We never store your IP address: a scrambled code made from it is kept for 30 days to catch fake reviews. Every review is checked before it's published; how fake ones are spotted isn't published, so it can't be gamed.

Install Iris
CNot recommended
We don't recommend itIt installs and runs npm or PyPI packages without a fixed version.
Read what we found