biblio-tools 0.1.1

Portable bibliography workspace tool

biblio

Portable bibliography workspace tooling.

Distribution name: biblio-tools Import package: biblio CLI: biblio

biblio bootstraps a repo-local bib/ workspace, manages citekeys and BibTeX imports, runs Docling, resolves OpenAlex metadata, syncs a bibliography-owned RAG config, expands local literature graphs, and builds a standalone bibliography explorer.

It can also ingest structured inputs before you have .bib files, including:

• DOI lists
• CSL JSON
• RIS
• local PDFs

Install for development:

pip install -e ".[dev]"

Install by distribution name:

pip install biblio-tools

Run the CLI:

biblio --help

Example ingestion flow:

biblio ingest csljson exports/library.json
biblio ingest ris exports/library.ris
biblio ingest dois reading-list.txt --stdout
biblio ingest pdfs ~/Downloads/papers/

Documentation

Install docs dependencies:

pip install -e ".[docs]"

Preview locally:

mkdocs serve

The docs site uses a Diataxis layout and is intended for GitHub Pages deployment.

Optional local UI:

pip install -e ".[ui]"
biblio ui serve

Release workflow

Build and validate distributions:

python -m build
python -m twine check dist/*

Upload instructions live in RELEASE.md.