Skip to main content

layer

Command-line interface for Layer — AI asset generation for game studios.

Reaches the same models, workspaces, and Creative Unit balance as the app, from a terminal, a Makefile, or a CI job.

Install

uv tool install layer        # or: pipx install layer

Python 3.10 and up — deliberately older than the services that build it, so the same package imports inside Blender, Maya, and Houdini.

Working on the CLI itself? Install it from your checkout instead, so the layer command follows the branch you have out:

task -d apps/cli-py install-cli

Sign in

layer login                 # prints a link and a code, opens the link when it can
layer whoami
layer use my-studio

For CI and other unattended runs, set LAYER_API_KEY to a personal access token instead of signing in.

Generate

layer generate image -p "a crystal sword icon, transparent background"
layer generate video -d 5 --aspect-ratio 16:9 -p "camera pushes through the gate"
layer generate mesh  -p "weathered treasure chest, game-ready"
layer generate audio -p "arcade coin pickup"

Each waits for the run, prints what it cost, and writes the result into the working directory under a name derived from the prompt — never overwriting a file already there. -o takes a directory, or the exact filename when there is a single output; --no-download prints URLs instead.

Leave --base-model off and the recommended model for that modality is chosen and named. The catalog is read from your workspace, not shipped with the package:

layer base-models list --modality video
layer base-models show bfl-flux-2-pro      # the keys --param accepts

Every run is priced before it executes. --confirm asks first; --max-cost 8 refuses anything more expensive. For a long render, submit and collect later:

id=$(layer --json generate video --no-wait -p "..." | jq -r .inference_id)
layer generate status "$id" --wait

Where settings come from

Highest wins:

  1. a command-line flag
  2. an environment variable — LAYER_PROFILE, LAYER_WORKSPACE, LAYER_PROJECT, LAYER_API_URL, LAYER_API_KEY
  3. layer.toml, found by walking up from the working directory
  4. the active profile in ~/.layer/config.toml

Committing a layer.toml pins a checkout to its workspace, so two repos open in two terminals cannot generate into each other's:

workspace = "my-studio"
project   = "season-12-art"

Scripting

--json puts the result on stdout and nothing else — progress, warnings, and errors all go to stderr, so a pipeline never has to filter them out.

layer --json whoami | jq -r .workspace
layer --json generate image -p "..." | jq -r '.files[].path'

Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 insufficient balance, 5 invalid input, 6 content policy, 7 timeout. They may gain members, never change meaning, so a caller can branch on them without parsing prose.

Documentation

https://layer.ai/docs/cli

Driving Layer from an agent rather than a shell? There is an MCP server and an Agent Skills pack.

License

Apache-2.0

Metadata

Release files for layer 1.0.118

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for layer 1.0.118
File Size Uploaded Provenance Actions
layer-1.0.118.tar.gz 113.4 kB Without provenance Details for layer-1.0.118.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for layer 1.0.118
File Interpreter ABI Platform Actions
layer-1.0.118-py3-none-any.whl Python 3 none any Details for layer-1.0.118-py3-none-any.whl

Total release size: 237.1 kB

Release files / layer-1.0.118.tar.gz

Download URL layer-1.0.118.tar.gz
Size 113.4 kB
Tags Source
SHA-256 checksum
How to use checksums
5c9be36c1f311ec20e522ba527f860a43dbf7866620838e429f57aea9383e0fe
BLAKE2b-256 checksum
How to use checksums
fb24e2c50a6e07f1975dd7717da047f1b486cdad0b6a5a42a09c8866877ee8b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / layer-1.0.118-py3-none-any.whl

Download URL layer-1.0.118-py3-none-any.whl
Size 123.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1bd9877cccf20358697e6a40be822dae59acee8d050fe5819f9ddba74db81de2
BLAKE2b-256 checksum
How to use checksums
9eaa88a7ef5aecd3c0cc9331856bd9148873f4f912fe3f01e71ea9ffe5a8a4b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for layer 1.0.118

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.118 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page