Installation

Install PyLD from PyPI:

pip install PyLD

PyLD's core package does not install requests or aiohttp automatically. If your application needs one of the built-in remote document loaders, install the matching extra:

pip install "PyLD[requests]"
pip install "PyLD[aiohttp]"
pip install "PyLD[requests-cache]"
pip install "PyLD[cli]"

PyLD[cli] installs Typer and requests-cache, and registers the pyld console script.

You can also depend on requests or aiohttp directly if your project already manages those dependencies.

Development Install

Install uv, then sync the locked development environment from a local checkout:

uv sync --locked

Run the project tests with:

uv run --locked pytest

The JSON-LD specification test suites are stored under specifications/ and are usually initialized as git submodules:

git submodule init
git submodule update