PeerFold
Website: vincenzoml.github.io/PeerFold · Source: github.com/vincenzoml/PeerFold
Review PDFs in a native window. Click, type, done.
Saved reviews: manuscript_VC-2026-06-09.pdf next to the original.
Install
macOS & Linux
curl -fsSL https://vincenzoml.github.io/PeerFold/install.sh | bash
Windows (PowerShell)
irm https://vincenzoml.github.io/PeerFold/install.ps1 | iex
Python 3.10+
python3 -m pip install --user peerfold-review
peerfold manuscript.pdf --reviewer RB
Over SSH: peerfold paper.pdf --web
Shared folder or git repo
One launcher file — pinned PyPI version, same build for every co-author. Do not submodule PeerFold.
One-liner (from project root):
curl -fsSLO https://vincenzoml.github.io/PeerFold/peerfold.py && chmod +x peerfold.py
./peerfold.py your-paper.pdf --reviewer AB
Windows (PowerShell):
irm https://vincenzoml.github.io/PeerFold/peerfold.py -OutFile peerfold.py
py .\peerfold.py your-paper.pdf --reviewer AB
Or download peerfold.py into your project root. Packages are cached in ~/.local/share/peerfold/cache (uv; override with PEERFOLD_CACHE / PEERFOLD_DATA).
Upgrade when needed:
./peerfold.py --update # then commit peerfold.py
Site: vincenzoml.github.io/PeerFold
Usage
peerfold paper.pdf # native window (default)
peerfold paper.pdf -r VC # reviewer short name
peerfold paper.pdf --web # system browser (SSH)
peerfold paper.pdf --no-browser # server only
Environment: PEERFOLD_REVIEWER sets the default reviewer name. Set PEERFOLD_SAVE_COPY=1 to write sidecar files (paper_VC-2026-06-09.pdf) instead of editing in place.
Roadmap
Planned features (discussion and design in GitHub issues):
| Feature | Issue |
|---|---|
| Merge comments from different PDFs into one view | #1 |
| PDF diff view for revised manuscripts | #2 |
| GitHub integration for paper repos and review versioning | #3 |
| Export comments to human-readable text (page, section, quote) | #4 |
Development
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
peerfold sample.pdf
pytest
License
MIT — see LICENSE. Uses PyMuPDF (AGPL).
Brought to you by vincenzoml@gmail.com · vincenzoml.github.io
1 maintainer
Metadata
1 maintainer
Release files for peerfold-review 1.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| peerfold_review-1.1.2.tar.gz | 154.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| peerfold_review-1.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 303.7 kB
Release files / peerfold_review-1.1.2.tar.gz
| Download URL | peerfold_review-1.1.2.tar.gz |
|---|---|
| Size | 154.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0e68408bfd2f8f5d2fce143fa2b265c68dd38654c7a72c225b5eebf1ed3675be
|
|
BLAKE2b-256 checksum How to use checksums |
7cd4d71d8c0834b5a1e2fb1722a6f486c142560c23187e38370951a5db523af9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / peerfold_review-1.1.2-py3-none-any.whl
| Download URL | peerfold_review-1.1.2-py3-none-any.whl |
|---|---|
| Size | 149.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
947c819854ae35790491a3c4396bca478b3db4a4b55e91395c9b5b8f1b39b64e
|
|
BLAKE2b-256 checksum How to use checksums |
0c3c0abb5da4eb434f28d79dacd9b95a8519319a6ed7593fa5f5f576743f753d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
