Cutlass.py overview

What Cutlass.py is

Cutlass.py is a MoviePy-style Python binding over the Cutlass Rust video engine. It lets scripts build a Cutlass project with explicit tracks, place clips, animate properties, render frames into NumPy arrays, export MP4, and save .cutlass project files.

The binding is written with PyO3 and wraps the same timeline, render, and export pipeline used by the native editor.

Package and import names

Install the package as cutlass-py, then import it as cutlass:

pip install --pre cutlass-py

import cutlass
from cutlass import Project, Text, Solid

The distribution name is cutlass-py because the bare cutlass name on PyPI belongs to an unrelated project.

What the binding wraps

Cutlass.py is track-first:

Project
|-- media pool
|-- tracks
|   `-- clips
|       |-- transform, crop, speed, volume
|       |-- effects
|       `-- transition
`-- render and export

Content descriptors such as Text, Solid, shapes, and media slices describe what to place. Track.add(...) decides where and when it appears.

When to use it

Use Cutlass.py when you want reproducible video edits from Python while keeping the underlying project compatible with the Cutlass engine.

Good fits:

• Generate repeatable social clips.
• Build timelines from data.
• Render test frames.
• Create .cutlass projects from scripts.
• Export MP4 through the native engine.