Our project welcomes external contributions. If you have an itch, please feel free to scratch it.
For more details on the contributing guidelines head to the Docling Project community repository.
We use uv as package and project manager.
To install uv, check the documentation on Installing uv.
You can use the uv sync to create a project virtual environment (if it does not already exist) and sync
the project's dependencies with the environment.
uv sync --all-extrasIf you need to work with a specific version of Python, you can create a new virtual environment for that version and run the sync command:
uv venv --python 3.12
uv sync --all-extrasMore detailed options are described on the Using Python environments documentation.
Simply use the uv add command. The pyproject.toml and uv.lock files will be updated.
uv add [OPTIONS] <PACKAGES|--requirements <REQUIREMENTS>>We use the following tools to enforce code style:
- Ruff, to format and lint code
- Flake8, to lint code
- autoflake, to remove unused variables and imports
- MyPy, as static type checker
A set of styling checks, as well as regression tests, are defined and managed through the pre-commit framework. To ensure that those scripts run automatically before a commit is finalized, install pre-commit on your local repository:
uv run pre-commit installTo run the checks on-demand, type:
uv run pre-commit run --all-filesWe use JSON Schema for Humans to generate Markdown pages documenting the JSON schema of the Docling objects.
The documentation pages are stored in docs folder and are updated at every commit, as part of the pre-commit check hooks.
To generate the documentation on-demand, run:
uv run python -m docling_core.utils.generate_docs docs