# Scrambo

> Python SDK for a closed-alpha cloud video editor. A short Python program
> describes the creative intent; Scrambo inspects the user's real media and
> builds a timeline the user reviews and exports in a browser editor.

The complete documentation in one file: https://scrambo.dev/llms-full.txt

# Scrambo API

- [Start here](/docs/start-here): The entry point: how a coding agent sets up Scrambo and writes the user's first edit.
- [Install and sign in](/docs/install): Install the SDK and authenticate with the closed-alpha cloud editor.

- **Core concepts**
- [Writing Scrambo Programs](/docs): How a Python program directs Scrambo's team of video-editing agents.
- [Choose the right workflow](/docs/workflows): Match the direct or structured workflow to what your edit actually needs.
- [The session lifecycle](/docs/session-lifecycle): editor.open, editor.start, editor.close, and how sessions and export work.
- [Supplying media and creative constraints](/docs/media-and-constraints): Separate facts from choices and refer to source files by name.

- **Your first timeline**
- [Start with the smallest useful program](/docs/quickstart): The shortest path: open a session and author a timeline from one prompt.
- [Two ways to create the first timeline](/docs/first-timeline): Direct authoring versus the scout, storyboard, and author workflow.

- **The agents**
- [Source agents](/docs/source-agents): Scout, prepare, transcripts, deterministic generation, and generate specialist.
- [Storyboarding](/docs/storyboarding): Turn accepted source evidence into an ordered, timed narrative plan.
- [Timeline agents](/docs/timeline-agents): The author and the graphics, sound, titles, and captions refinement specialists.
- [Validation and repair](/docs/validation-and-repair): Run deterministic validators and route findings to the right specialist.
- [Artifacts](/docs/artifacts): Immutable Artifact and ValidationReport results and how caching uses them.

- **Writing good programs**
- [Prompting each agent well](/docs/prompting): Assign decisions to the right specialist and make constraints testable.
- [Common mistakes](/docs/common-mistakes): Frequent pitfalls to avoid when writing Scrambo programs.

- **Separator**
- [API reference](/docs/api-reference): The whole call surface on one page: facades, methods, arguments, and returns.
- [Complete examples](/docs/examples): End-to-end programs: caption video, generative listing tour, and interview.