obsidian-plugin/lllin000_PaperForge
1
0
Fork 0
mirror of https://github.com/lllin000/PaperForge.git synced 2026-07-22 17:00:23 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
lllin000_PaperForge/INSTALLATION.md

1.7 KiB
Raw Blame History

PaperForge Installation Guide

Canonical install reference. For other docs, see README.md.

Method 1: Obsidian Plugin (Recommended)

  1. Download the plugin files from the latest release.
  2. Extract and copy the files into vault/.obsidian/plugins/paperforge/.
  3. Open Obsidian -> Settings -> Community Plugins -> Enable PaperForge.
  4. Open PaperForge settings and click Open Installation Wizard.
  5. Follow the 5-step guided setup: Overview -> Directory Config -> Agent & Keys -> Install -> Done.

The wizard auto-detects Python, Zotero, and Better BibTeX before installation starts.

Method 2: CLI via pip (Developers)

pip install paperforge

Then run the headless setup:

python -m paperforge setup --headless --agent opencode --paddleocr-key <key>

For the latest stable release, replace master with a version tag:

pip install paperforge==1.5.2

Method 3: AI Agent Setup

Copy the following to your AI agent for a guided headless install:

Prerequisites

Software Purpose Get it
Python 3.10+ Run PaperForge CLI and backend tasks https://python.org
Zotero Literature management https://zotero.org
Better BibTeX Auto-export metadata as JSON https://retorque.re/zotero-better-bibtex/
PaddleOCR Key OCR text and layout extraction https://aistudio.baidu.com/paddleocr

Post-Installation

After installing, see AGENTS.md for first-use workflow and detailed command reference.