Manim-Studio

CLI Reference

studio is the main local workflow entry point.

Entry Points

pyproject.toml exposes:

studio = manim_studio.cli:main
manim-mcp = manim_mcp.server:main

studio doctor

Report local render prerequisites:

studio doctor

Also validate strict catalog metadata:

studio doctor --catalog

studio list

List registered decks and scenes:

studio list

Options:

• --repo-root
• --catalog

studio validate

Confirm a deck or scene target exists and catalog metadata can be loaded:

studio validate <deck-id>
studio validate <deck-id>/<scene-id>

studio catalog validate

Validate catalog entries against files and scene classes:

studio catalog validate

Require optional planning metadata:

studio catalog validate --strict-metadata

studio project init

Generate an external Manim Studio project without running Docker, building an image, validating the runtime, or rendering:

studio project init ./demo --name "Demo Project"

Options:

• --name
• --deck-id
• --scene-id
• --class-name
• --language
• --image-tag
• --force

The generated project includes a catalog, starter scene, Compose file, MCP snippet, AGENTS.md, documentation, and Windows helper wrappers.

studio project verify

Verify the Docker runtime for a generated external project:

studio project verify ./demo

This checks Docker availability, Docker responsiveness, the configured runtime image, studio doctor --catalog, studio list, and starter target validation. It does not build or pull a runtime image automatically.

Run an optional draft render and confirm a host-visible artifact:

studio project verify ./demo --render

This command is verification only. Public bootstrap installation, image publication, automatic client configuration, and cloud rendering are future distribution work.

studio beats

List named beats discovered in a registered scene:

studio beats <deck-id>/<scene-id>

studio render

Render one registered scene into an isolated build directory:

studio render <deck-id>/<scene-id> --profile draft

Options:

• --profile draft|review|final
• --repo-root
• --catalog
• --builds-root
• --beat <beat-id>
• --force

studio build

Render all scenes in a registered deck serially:

studio build <deck-id> --profile review

Options:

• --profile draft|review|final
• --repo-root
• --catalog
• --builds-root
• --force

studio export

Export an all-slides deck to a delivery artifact:

studio export <deck-id> --format pptx --profile final

Options:

• --format pptx
• --profile draft|review|final
• --repo-root
• --catalog
• --builds-root
• --force

studio inspect

Inspect a previous isolated build by build ID:

studio inspect <build-id>

Options:

• --repo-root
• --builds-root

This site is open source. Improve this page.