Skip to content

corbel-spatial/here-be-dragons

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Here Be Dragons 🌍 🐲

A helpful Docker image for bleeding-edge spatial data analysis in Python.

We build the low-level C binaries from source so you don't have to. These images are built on top of Ubuntu Linux and the most recent versions of Python, Arrow, GDAL, GEOS, and PROJ.

The Python package manager uv is pre-installed and the recommended way to install additional packages. git, pip, and Pixi are also included.

Getting Started

You will need to install Docker.

On Windows, we recommend using Docker Desktop and Windows Subsystem for Linux (WSL).

Latest 🐍 Python 3.14.2

This is the stable version intended for production work. The image is built on top of Ubuntu 24.04 LTS (ubuntu:latest).

To pull and start the container in your terminal:

docker run -it --name here-be-dragons-latest ghcr.io/corbel-spatial/here-be-dragons:latest

After the image downloads and opens a terminal you can check which packages are already installed by running:

uv pip list

geopandas and common dependencies are pre-installed, which you can check with:

python -c "import geopandas; geopandas.show_versions()"

To install additional packages use uv pip install --system, for example:

uv pip install --system geojson duckdb sedonadb

To update and restart the stopped container:

docker pull ghcr.io/corbel-spatial/here-be-dragons:latest
docker start here-be-dragons-latest
docker attach here-be-dragons-latest

These are the current included versions of the binaries and the packages built with them:

Binary Source Python Packages
Arrow (22.0.0) pyarrow (22.0.0)
geoarrow-pyarrow (0.2)
GDAL (3.12.0) osgeo / gdal (3.12.0)
GEOS (3.14.1) shapely (2.1.2)
PROJ (9.7.1) gdal (3.12.0)
pyproj (3.7.2)

Next 🔥 Python 3.15.0a3

This is the experimental version intended for testing Arrow, GDAL, GEOS, and PROJ against the latest pre-release version of Python. It's useful for testing other packages in development with this suite of dependencies. The image is built on top of Ubuntu 25.10 (ubuntu:rolling).

Unstable source branches will be used if they are needed for a successful build.

docker run -it --name here-be-dragons-next ghcr.io/corbel-spatial/here-be-dragons:next
Binary Source Python Packages
Arrow (23.0.0a1.dev1+) pyarrow (23.0.0a1.dev1+)
geoarrow-pyarrow (0.2)
GDAL (3.12.0) osgeo / gdal (3.12.0)
GEOS (3.14.1) shapely (2.1.2)
PROJ (9.7.1) gdal (3.12.0)
pyproj (3.7.2)

📑 References

Project Source Downstream Packages
Arrow https://github.com/apache/arrow geoarrow-pyarrow
GDAL https://github.com/OSGeo/gdal Python bindings
GEOS https://github.com/libgeos/geos Shapely
PROJ https://github.com/OSGeo/PROJ Pyproj
Python
(release schedule)
https://github.com/python/cpython uv, Pixi, pip
Ubuntu Docker image ubuntu:latest

About

Docker image for bleeding-edge spatial data analysis in Python

Resources

License

Contributing

Stars

Watchers

Forks

Packages