PaperForge

简体中文 · English

铸知识为器，启洞见之明。 — Forge Knowledge, Empower Insight.

PaperForge brings your Zotero library into Obsidian. Sync papers, run OCR, extract figures, and do AI-assisted deep reading — all inside a single vault.

0. What PaperForge Is

PaperForge is not just an Obsidian plugin. It has two parts:

The plugin is the interface. The Python package is the engine. Every button you click in the plugin actually runs a Python command behind the scenes.

After installing the plugin, you MUST verify that the Python package is also installed and version-matched.

1. Install the Obsidian Plugin

Option A: Community Plugin Browser (Recommended)

1. Open Obsidian → Settings → Community plugins → Browse
2. Search for PaperForge
3. Click Install, then Enable

Community plugins auto-update through Obsidian. No extra steps needed.

Option B: BRAT

If you need beta versions or the plugin hasn't appeared in search yet:

1. Install BRAT from the Obsidian community plugin browser
2. Open BRAT settings → Add Beta Plugin
3. Enter: https://github.com/LLLin000/PaperForge
4. Enable PaperForge in Settings → Community Plugins

Option C: Manual Download

1. Go to Releases
2. Download the three files: main.js, manifest.json, styles.css
3. Create .obsidian/plugins/paperforge/ in your vault
4. Put the three files there
5. Restart Obsidian → Settings → Community Plugins → enable PaperForge

Manual install does not auto-update. You'll need to re-download for each new version.

2. Install the Python Package

After enabling the plugin, open the PaperForge settings tab. You'll see a Runtime Status section:

Plugin v1.5.0 → Python Package v1.5.0 ✓ Matched

• If it says "Not installed" → click Open Wizard to re-run the setup process
• If it says "Mismatch" → the Python package auto-updates when the plugin updates. If it didn't succeed, click Update Runtime to manually trigger

3. Quickstart

# 1. Export from Zotero (Better BibTeX JSON, Keep updated) to exports/
# 2. Sync
paperforge sync

# 3. Mark a paper for OCR in its frontmatter: do_ocr: true
# 4. Run OCR
paperforge ocr

# 5. Mark for deep reading: analyze: true
# 6. In your Agent chat:
/pf-deep <zotero_key>

文档导航

License

CC BY-NC-SA 4.0. Non-commercial use only.

Acknowledgments

Built on PaddleOCR, Obsidian, Better BibTeX for Zotero, and other great open-source projects.