Install

The CLI is published to PyPI as layer. Install it as a tool, so it gets an environment of its own rather than sharing whichever one happens to be active.

uv

uv tool install layer
uv tool upgrade layer

pipx

pipx install layer
pipx upgrade layer

pip

pip install layer
pip install --upgrade layer

Check what you have:

layer --version

Supported Python versions

The wheel requires Python 3.10 or newer — deliberately older than the services that build it, so the same package imports inside Blender, Maya, and Houdini, where a studio’s pipeline code already lives.

Note

pip install layer inside a DCC’s bundled interpreter puts the CLI on that interpreter’s path. Use uv tool or pipx for the standalone command you type in a shell.

Upgrading

The commands above upgrade in place. layer --version prints what you have; PyPI has the latest.

Pin the version in CI so a release cannot change a build under you:

uv tool install layer==1.0.4

Uninstalling

uv

uv tool uninstall layer

pipx

pipx uninstall layer

pip

pip uninstall layer

Credentials live outside the package, in your operating system keychain and ~/.layer/config.toml. Run layer logout before uninstalling if you want them gone too.