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.