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.116

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.116
File Size Uploaded Provenance Actions
layer-1.0.116.tar.gz 113.3 kB Without provenance Details for layer-1.0.116.tar.gz

Built distribution (wheel)

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

Total release size: 236.9 kB

Release files / layer-1.0.116.tar.gz

Download URL layer-1.0.116.tar.gz
Size 113.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f04537b67aa6d5f33190b9264d7e0194b7a6a6dba3f9f3a7820e4bc045974cd4
BLAKE2b-256 checksum
How to use checksums
8c9527d567b1b7c68a6889d2514ea796081dceebceddb0552cec27b438c1876a
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.116-py3-none-any.whl

Download URL layer-1.0.116-py3-none-any.whl
Size 123.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
78dea8208e750dcef1bf7cf139b2934c5dbab13d8dfffa5fa11a4ca4ca371797
BLAKE2b-256 checksum
How to use checksums
f46939e4cbcd29dee1d26fec20db7ac9a2253e45bcf60ba39a2fff2aa7c4560b
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.116

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.116 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