Python USD is a Docker container that contains a pre-built version of the Pixar OpenUSD toolchain. Because building USD takes a significant amount of time, this container serves as a useful base image for other applications.

Pre-built images are published to the GitHub Container Registry: ghcr.io/plattar/python-usd. Multi-arch manifests are produced for both linux/amd64 and linux/arm64.

docker pull ghcr.io/plattar/python-usd:latest
# or pin a specific OpenUSD version
docker pull ghcr.io/plattar/python-usd:26.05

Looking for the Python USD AR images with Apple USDZ Schema Definitions? Check out the python-usd-ar repository.

Building a new release

Builds are produced by .github/workflows/publish.yml. There are two ways to trigger a build:

1. Manual dispatch — run the workflow from the Actions tab and supply an usd_version (e.g. 26.05). Optionally override image_tag or tick tag_latest. This is the recommended path for ad-hoc and future-version builds.
2. Git tag — pushing a tag (e.g. git tag 26.05 && git push origin 26.05) triggers a build that uses the tag name as both the OpenUSD version and the image tag, and also publishes :latest.

Acknowledgements

This tool relies on the following open source projects.

• Pixar OpenUSD