Skip to main content

Self-hosted PDF extraction backend for the Estravon Zotero plugin

Project description

estravon-backend

Self-hosted PDF extraction backend for the Estravon Zotero plugin.

Independent project. Estravon is not affiliated with, endorsed by, or in any way connected to the Zotero project or the Corporation for Digital Scholarship. Zotero is a registered trademark of the Corporation for Digital Scholarship.


Extracts nominated sections of a book PDF to Markdown and attaches the result directly to the Zotero item — synced, versioned, always co-located with the source. The plugin handles everything Zotero-side; this package runs on your machine and owns the extraction pipeline.

Installation

pip install estravon-backend

Requires Python 3.11+.

Quick start

# 1. Create a .env file with your API key
echo "MISTRAL_API_KEY=your_key_here" > .env

# 2. Start the backend
estravon --port 7766

In Zotero → Settings → Estravon, confirm the status indicator is green, then right-click any item with a PDF → Extract Section to Markdown…

Full setup guide: estravon.com/install

Supported extraction backends

Backend Pricing How to use
Mistral OCR ~$0.002/page, pay-as-you-go Default. Set MISTRAL_API_KEY in .env.
Datalab $25/month flat Set DATALAB_API_KEY and _ZM_BACKEND=datalab.
Replicate Pay-as-you-go Set REPLICATE_API_TOKEN and _ZM_BACKEND=replicate.

Links

License

AGPL-3.0 — the same license as Zotero itself.

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

estravon_backend-0.1.5.tar.gz (25.8 kB view details)

Uploaded Source

Built Distribution

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

estravon_backend-0.1.5-py3-none-any.whl (28.9 kB view details)

Uploaded Python 3

File details

Details for the file estravon_backend-0.1.5.tar.gz.

File metadata

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

File hashes

Hashes for estravon_backend-0.1.5.tar.gz
Algorithm Hash digest
SHA256 bf9d7d3f6a02bccd9648758a76ec69f0c7cbfca88218c8f6603a63401015ace6
MD5 7682ea2f69b15b0a64379df1423cd7a4
BLAKE2b-256 a9cd114e5fc0062c08a20a03f68bcde3bc5382e1c4c343316ce66cd34938d7c9

See more details on using hashes here.

Provenance

The following attestation bundles were made for estravon_backend-0.1.5.tar.gz:

Publisher: publish.yml on tiberavonltd/estravon-backend

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

File details

Details for the file estravon_backend-0.1.5-py3-none-any.whl.

File metadata

File hashes

Hashes for estravon_backend-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 1a4a8111eb064aa91926121f9aefdc8dac1843a9c0dbd1e8496046bd6da2359d
MD5 ee8f5b20d6a20ec23aa79aaf2152aaab
BLAKE2b-256 0d3caf833fd0b30eb9683b0bf3d9ace52de1d015ca2767e5ba6a7dbb4613ea13

See more details on using hashes here.

Provenance

The following attestation bundles were made for estravon_backend-0.1.5-py3-none-any.whl:

Publisher: publish.yml on tiberavonltd/estravon-backend

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