Skip to main content

AI-powered PDF annotation for research papers

Project description

PaperFlux

AI-powered PDF annotation for research papers. PaperFlux extracts exact quotations, organizes them by category (contributions, limitations, claims, evidence), and annotates your PDFs with precise highlights.

Quick Start

1. Installation

Install the latest release from PyPI:

python -m pip install paperflux

For local development from a cloned repository:

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

2. Set API Key

export PAPERFLUX_OPENAI_API_KEY="sk-your-key"

3. Run

paperflux init
paperflux --config config.yaml path/to/paper.pdf

Features

  • Batch processing: *.pdf
  • Three detail levels (low/medium/high)
  • RAG-based extraction with exact quotes
  • Color-coded highlights by category
  • Markdown summary with sticky note
  • Quote-match report with matched/skipped counts and scores
  • Layout-aware quote matching across column, table, figure, and caption interruptions
  • Stage-level CLI progress during extraction and annotation
  • Configurable prompts and colors

Documentation

For detailed setup, configuration options, and advanced usage, see the full documentation.

Contributing

Contributions welcome! Fork the repo, create a feature branch, and open a PR.

License

See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

paperflux-3.4.20260528.tar.gz (27.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

paperflux-3.4.20260528-py3-none-any.whl (26.0 kB view details)

Uploaded Python 3

File details

Details for the file paperflux-3.4.20260528.tar.gz.

File metadata

  • Download URL: paperflux-3.4.20260528.tar.gz
  • Upload date:
  • Size: 27.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for paperflux-3.4.20260528.tar.gz
Algorithm Hash digest
SHA256 b48830eee039632ee2fd9dbf1345330291be613a849dd2d6b9bb7d3433c660ca
MD5 de8cd5e65dee14fb938fa06a016da986
BLAKE2b-256 5b04fbda45caa3aa67dfd5b61f9082bd0ed9fa3e2cf346d9a3e5defb0c0b7721

See more details on using hashes here.

Provenance

The following attestation bundles were made for paperflux-3.4.20260528.tar.gz:

Publisher: publish.yml on ehabets/PaperFlux

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file paperflux-3.4.20260528-py3-none-any.whl.

File metadata

File hashes

Hashes for paperflux-3.4.20260528-py3-none-any.whl
Algorithm Hash digest
SHA256 ad8ef5504322cfc311ce6d6ccfd45c017891c6f265d981b6b9635af8ecce4571
MD5 70839931da43f869a97d5bc301350a77
BLAKE2b-256 f2f0c7a0c706051c34b6c08a916dbff365271341841cee81aa33a50ccf624aea

See more details on using hashes here.

Provenance

The following attestation bundles were made for paperflux-3.4.20260528-py3-none-any.whl:

Publisher: publish.yml on ehabets/PaperFlux

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page