# Install

The CLI is published to PyPI as [layer](https://pypi.org/project/layer/). Install it as a tool, so it gets an environment of its own rather than sharing whichever one happens to be active.

**uv**

```bash
uv tool install layer
uv tool upgrade layer
```

**pipx**

```bash
pipx install layer
pipx upgrade layer
```

**pip**

```bash
pip install layer
pip install --upgrade layer
```

Check what you have:

```bash
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](https://pypi.org/project/layer/) has the latest.

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

```bash
uv tool install layer==1.0.4
```

## Uninstalling

**uv**

```bash
uv tool uninstall layer
```

**pipx**

```bash
pipx uninstall layer
```

**pip**

```bash
pip uninstall layer
```

Credentials live outside the package, in your operating system keychain and `~/.layer/config.toml`. Run [layer logout](/docs/cli/authentication) before uninstalling if you want them gone too.
