Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

shotfable — ShotFable command-line client (pre-release)

The production API is not open yet. api.shotfable.com opens later; no API keys are issued and nothing is billed today. Until then, point the CLI at a test environment with --api-base <URL> (or SHOTFABLE_API_BASE=<URL>).

生产 API 即将开放,目前不发放密钥、不收费。 现在可以用 --api-base <URL>(或环境变量 SHOTFABLE_API_BASE)指向测试环境试用。

ShotFable turns one sentence into a finished short film: consistent characters, stable voices, clean video plus subtitles. shotfable is its official command-line client: one command per API operation, one JSON envelope on stdout, stable exit codes, automatic idempotency keys. Python 3.11+, standard library only.

Install

uv tool install shotfable      # or: pipx install shotfable

Quick start (against a test environment)

export SHOTFABLE_API_BASE=https://<test-environment>/v1
printf '%s' "$KEY" | shotfable auth login      # the key is read from stdin, never from argv
shotfable film quote --idea "A lighthouse keeper's last night on the island"
shotfable commands                              # every command → API operation

Without --api-base, commands target https://api.shotfable.com/v1 and fail with a network_error envelope until the production API opens.

For agents

Every run prints exactly one JSON envelope on stdout; progress events go to stderr. Exit codes, recovery rules and the full command list ship inside the package: shotfable skill path prints the bundled SKILL.md.

Docs: https://shotfable.com/docs/cli · API reference: https://shotfable.com/docs/api

Metadata

Release files for shotfable 0.1.0a1

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

Source distribution (sdist)

Source distribution for shotfable 0.1.0a1
File Size Uploaded Provenance Actions
shotfable-0.1.0a1.tar.gz 26.9 kB Without provenance Details for shotfable-0.1.0a1.tar.gz

Built distribution (wheel)

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

Total release size: 55.7 kB

Release files / shotfable-0.1.0a1.tar.gz

Download URL shotfable-0.1.0a1.tar.gz
Size 26.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5ec8cae27018dbf40bdc75c73c2f577f1e82fd583ac5f30dc6436e764e992424
BLAKE2b-256 checksum
How to use checksums
89cf99a357edf5e43e93f1ae2ece9a6638041dcaf6f5d6d753a107e4b0c0c0b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Omarchy","version":"4.0.4","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / shotfable-0.1.0a1-py3-none-any.whl

Download URL shotfable-0.1.0a1-py3-none-any.whl
Size 28.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7bfa60f25bd6a1061153fddf00c410ecb73d57d2ff5ced5bb107d539164c52a8
BLAKE2b-256 checksum
How to use checksums
e84c7f0b2f6441267aa2d9a16633123676a69ab883f2405e778ab7ffd06c32c9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Omarchy","version":"4.0.4","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for shotfable 0.1.0a1

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