Skip to content


Issues and pull requests are more than welcome.

dev install

git clone
cd rio-tiler
python -m pip install -e ".[test,dev]"

You can then run the tests with the following command:

python -m pytest --cov rio_tiler --cov-report term-missing
Performance tests
python -m pip install -e ".[benchmark]"
python -m pytest tests/benchmarks/ --benchmark-only --benchmark-columns 'min, max, mean, median' --benchmark-sort 'min'


This repo is set to use pre-commit to run isort, flake8, pydocstring, black ("uncompromising Python code formatter") and mypy when committing new code.

$ pre-commit install


git clone
cd rio-tiler
python -m pip install -e .["docs"]

Hot-reloading docs:

$ mkdocs serve -f docs/mkdocs.yml

To manually deploy docs (note you should never need to do this because Github Actions deploys automatically for new commits.):

$ mkdocs gh-deploy -f docs/mkdocs.yml
pdocs as_markdown \
   --output_dir docs/src/api/ \
   --exclude_source \
   --overwrite \
   rio_tiler.colormap \
   rio_tiler.constants \
   rio_tiler.errors \
   rio_tiler.expression \
   rio_tiler.models \ \ \ \ \
   rio_tiler.mosaic.methods.base \
   rio_tiler.mosaic.methods.defaults \
   rio_tiler.mosaic.reader \
   rio_tiler.profiles \
   rio_tiler.reader \
   rio_tiler.tasks \