# 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/python/docs/llms-full.txt

# Python SDK

- [Start here](/python/docs/start-here): The entry point: how a coding agent sets up Scrambo and writes the user's first edit.
- [Install and sign in](/python/docs/install): Install the SDK, run a program, and authenticate with the closed-alpha cloud editor.
- [API reference](/python/docs/api-reference): The complete Python SDK call surface: facades, methods, arguments, and returns.

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

- **Core concepts**
- [Writing Scrambo Programs](/python/docs): How a Python program directs Scrambo's team of video-editing agents.
- [Choose the right workflow](/python/docs/workflows): Match the direct or structured workflow to what your edit actually needs.
- [The session lifecycle](/python/docs/session-lifecycle): Open, inspect, hand off, close, and export a Scrambo session.

- **The agents**
- [Source agents](/python/docs/source-agents): Semantic source work, analysis capabilities, and source generation.
- [Planning](/python/docs/planning): Ask read-only editorial questions and compile grounded, timed edit plans.
- [Timeline agents](/python/docs/timeline-agents): The author and the graphics, sound, titles, and captions refinement specialists.
- [Validation and repair](/python/docs/validation-and-repair): Run deterministic validators and route findings to the right specialist.
- [Artifacts](/python/docs/artifacts): Immutable Artifact and ValidationReport results and how caching uses them.

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