Writing Scrambo Programs
How a Python program directs Scrambo's team of video-editing agents.
Scrambo lets a Python program direct a team of video-editing agents. Your program supplies the creative intent, passes work between specialists, and decides what must be validated. Scrambo inspects the real media and builds the timeline in a browser editor.
Most programs use three facades:
from scrambo import editor, source, timelineeditorowns the editing session and browser editor.sourceunderstands, prepares, or generates media.timelineplans, authors, refines, and validates the edit.
Some steps also use tools — optional capabilities you import from
scrambo.tools and grant to a specialist for a single call. For example,
transcribe lets an agent read the spoken words in your media, and the
generation tools img2video and voiceover create new footage or narration.
Tools are opt-in and covered in detail later; the idea to hold onto now is that
a specialist can use a tool only when you explicitly give it one.
A Scrambo program is the Python script you write. Scrambo may generate its own low-level editing code while carrying out your requests, but that is an implementation detail; you do not write or manage it.
This guide focuses on the API and on composing agents. Install the SDK and sign in once (below) before running your first program.