Skip to content

Tech stack

Runtime dependencies

These install with pip install parsecraft (pyproject.toml [project] dependencies).

Package Role
markdown-it-py CommonMark parsing for the Markdown input adapter (lazy import)
pydantic IR schema and validation
pydantic-settings Configuration schema base
platformdirs Platform-appropriate config and cache directories
tomlkit Style-preserving TOML read and write
typer CLI framework

Optional extras

Extra Contents Role
web httpx, trafilatura the trafilatura HTML backend
docling docling-rs>=2.55 layout-aware conversion
mineru torch>=2.5, transformers>=5.17,<6, accelerate, torchvision the native MinerU2.5 VLM backend (no mineru package)
pymupdf pymupdf>=1.28.2 PyMuPDF extraction (AGPL)
pdf-full pymupdf + the native VLM stack the whole PDF stack in one name
ocr torch, transformers, … the GPU OCR/VLM backends
surya torch, transformers, accelerate, torchvision the ocr-surya backend (OpenRAIL-M weights, kept out of ocr so that extra stays Apache-only)
vllm vllm>=0.11 the vLLM accelerator (Linux/WSL2 only)

huggingface-hub is core (pinned model-asset downloads, lazy import); it is no longer an extra.

Core is import-clean offline: no network or heavy runtime is imported at import time, and no model weights, CUDA, or OCR stacks ship with a base install. Runtime floor is >=3.13 with classifiers for 3.13 and 3.14.

Development tooling

Dev tooling is not part of the distribution.

Tool Installed by Role
uv manually Dependency and environment manager
mise manually Task runner and pinned tool versions
hatchling + uv-dynamic-versioning build Build backend and CalVer versioning
pytest + pytest-cov dev group Tests and the 100% coverage gate
ruff mise Linter and formatter
ty mise Type checker
codespell mise Spell checker
rumdl mise Markdown linter and formatter
pyreorder mise Structural sorter
pre-commit manually Git hook runner
Zensical + mkdocstrings + markdown-exec + markdown-callouts dev group Documentation site and API reference
ghp-import dev group Template-provided Pages helper

Dev tool tasks are listed in Development setup. The optional agent tooling built on top of mise is described in AI dev features.