📓 Interactive Notebooks

The fastest, friendliest way to learn Strands Cosmos. Eight short notebooks take you from "what is this?" all the way to generating video with sound — each explained simply, with color-coded diagrams, and safe to run even without a GPU (heavy cells skip politely instead of crashing).

Start here

New to Strands Cosmos? Open notebooks/00_start_here.ipynb first — it's a 5-minute map of the whole toolkit, no GPU required.

---

The learning path

flowchart LR
    N0["00<br/>Big Picture"]:::user
    N1["01<br/>Text"]:::reason
    N2["02<br/>Video"]:::reason
    N3["03<br/>Driving"]:::think
    N4["04<br/>Robot"]:::reason
    N5["05<br/>Tools"]:::tool
    N6["06<br/>Cosmos 3<br/>Understand"]:::reason
    N7["07<br/>Cosmos 3<br/>Generate"]:::gen
    N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> N7

    classDef user fill:#ECEFF1,stroke:#607D8B,stroke-width:2px,color:#263238
    classDef reason fill:#E8F5E9,stroke:#388E3C,stroke-width:2px,color:#1B5E20
    classDef gen fill:#F3E5F5,stroke:#8E24AA,stroke-width:2px,color:#4A148C
    classDef tool fill:#FFF3E0,stroke:#F57C00,stroke-width:2px,color:#E65100
    classDef think fill:#FCE4EC,stroke:#D81B60,stroke-width:2px,color:#880E4F

🟢 understanding · 🧠 step-by-step thinking · 🟠 tools · 🟣 generation

---

What's inside

#	Notebook	You'll learn	Needs
00	Start Here	The big picture — two model families, one simple tag	—
01	Basic Text	Build an agent in 3 lines; ask physics questions	GPU*
02	Video Caption	Give the agent eyes with <video>	GPU*
03	Driving Analysis	Chain-of-thought (reasoning=True) for safety	GPU*
04	Embodied Reasoning	Robot next-action from an <image>	GPU*
05	Tool Usage	Cosmos as composable tools (many need no GPU)	partial
06	Cosmos 3: Understand	The newest reasoner via a vLLM server	GPU + server
07	Cosmos 3: Generate	Create image / video / video+sound	big GPU

* No GPU? You can still run every notebook — the compute cells detect your hardware and skip with a friendly message.

---

Run them locally

We use uv everywhere:

uv pip install strands-cosmos jupyter
jupyter lab          # then open notebooks/00_start_here.ipynb

The Cosmos 3 notebooks (06, 07) need their backends built once:

just c3-doctor                                 # check GPU / CUDA / disk
just c3-setup-reason && just c3-serve-reason   # notebook 06 (server on :8000)
just c3-setup-gen                              # notebook 07 (in-process Diffusers)

---

Notebooks vs. Examples

Every notebook has a matching runnable script in the examples/ folder. The notebook teaches the concept step by step; the script is the copy-paste-ready version.

→ Browse them on GitHub: notebooks/ · examples/