Files
Conal Mullan 290d7d345b Adopt uv for Python dependency management (#33 rebased, thanks @AsharibAli) (#59)
* Adopt uv for Python dependency management

Replace manual pip/venv setup with `uv sync` (pyproject.toml + uv.lock),
and switch all tool invocations across docs, skills, commands, and
examples to `uv run`. Optional extras: --extra whisper, --extra modal.
tools/requirements.txt is kept as a pip fallback.

* FIX: bring uv migration current with main — post-June deps and docs

Adds websocket-client (60db websocket transport) to core deps and a
'youtube' extra for the google-* packages (tools/youtube_upload.py),
regenerates uv.lock, bumps pyproject version to 0.18.0, and converts the
51 'python3 tools/…' invocations added since the PR was opened (60db,
YouTube, Kiro docs, publish command) to 'uv run'. Verified with
uv sync --frozen --extra youtube; voiceover, sixtydb_tts, youtube_upload
and migrate_to_kiro all run through the project environment.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Asharib Ali <asharibarain4@gmail.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-08-26 22:55:43 +01:00
..

Example Projects

Curated showcase projects demonstrating toolkit capabilities.

Available Examples

Example Stack Contributor Description Complexity
hello-world Remotion sprint-review — Minimal 25s video — zero config, renders in 2 minutes Beginner
quick-spot moviepy + PIL — 15s ad-style spot with audio-anchored timeline. Runs with zero external assets. Beginner
data-viz-chart moviepy + matplotlib — Animated time-series chart with deterministic title and source attribution. Runs with included data file. Beginner
ds-crt-stinger LTX-2 + moviepy + PIL — 6s brand stinger — LTX-2 CRT LoRA footage + post-processed grunged logo Intermediate
sky-blue-short concept-explainer-short (moviepy) — 52s vertical 9:16 explainer short — Qwen3 VO + Ideogram cards + LTX b-roll + burned captions. All assets committed; re-renders with uv run build.py. Intermediate
digital-samba-skill-demo Remotion product-demo Digital Samba Marketing video for Claude Code skill Intermediate
sprint-review-cho-oyu Remotion sprint-review Digital Samba iOS sprint review for Digital Samba Mobile Intermediate

Note: Remotion examples include configs and documentation but NOT large media files — see each example's ASSETS-NEEDED.md for what to create. The moviepy examples (quick-spot, data-viz-chart) are fully self-contained and run end-to-end with uv run build.py.

Contributors

Thank you to these organizations and individuals for sharing their video projects:

Contributor Website Examples Shared
Digital Samba digitalsamba.com digital-samba-skill-demo, sprint-review-cho-oyu

Want your project featured? Run /contribute and select "Share an example project".

Using Examples

Remotion examples (hello-world, digital-samba-skill-demo, sprint-review-cho-oyu):

cp -r examples/example-name projects/my-project
cd projects/my-project
npm install
npm run studio

moviepy examples (quick-spot, data-viz-chart) — run in place, no copy needed:

cd examples/quick-spot   # or examples/data-viz-chart
uv run build.py         # produces out.mp4 in the example directory

These are fully self-contained references for the moviepy skill. Read the build.py and README.md in each.

Adding Demo Assets

Examples don't include large media files (videos, audio). To run them:

  1. Record demos - Use /record-demo to capture screen recordings
  2. Generate voiceover - Use /generate-voiceover with the included script
  3. Add music - Use uv run tools/music.py for background tracks

Each example includes a ASSETS-NEEDED.md documenting what to create.

Contributing Examples

To share a project as an example:

  1. Run /contribute and select "Share a template" (examples work similarly)
  2. Or manually:
# Copy project to examples (without large media)
cp -r projects/my-project examples/

# Remove media files (these are gitignored anyway)
rm examples/my-project/public/demos/*.mp4
rm examples/my-project/public/audio/*.mp3

# Create asset documentation
# (describe what demos/audio are needed)

# Commit and PR
git add examples/my-project
git commit -m "Add example: my-project"
gh pr create

Example Structure

examples/example-name/
├── README.md              # What this example demonstrates
├── ASSETS-NEEDED.md       # What media to create
├── src/
│   └── config/
│       └── *-config.ts    # Example configuration
├── public/
│   ├── demos/             # Empty (add your recordings)
│   ├── audio/             # Empty (add your voiceover)
│   └── images/            # Logos, screenshots (tracked)
└── VOICEOVER-SCRIPT.md    # Script for narration