Silueta Studio
Vertical story videos — 2D silhouettes, rim light, parallax and karaoke captions — drawn in pure Python and directed by Claude Code.
English
silueta turns a shot-by-shot script into a finished 1080×1920 video: original silhouettes drawn in code (no stock images),
3–5 parallax layers, rim light, film grain, spring-in title cards, word-by-word karaoke synced to your real voice-over,
and automatic quality gates. It is the engine behind a faceless "true stories" channel, packaged so that
Claude Code can research, write, draw, render and check a video with you.
What you get
- A Python engine (numpy + Pillow + SciPy + ffmpeg): camera push/parallax, terrain ridges, skies, sun/moon, light rays, embers, people, birds, ships, sprite compositing, transitions (dissolve, fade-to-black, white flash, whip pan).
- Karaoke captions in the safe zone, with the active word popping in yellow; long words shrink to fit.
- Forced alignment with WhisperX: real timings per shot and per word, numbers mapped back to your script ("6" ↔ "seis").
- Audio mix: voice levelling, your music ~20 dB under the voice (+5 dB in pauses), SFX ducking, −14 LUFS loudness.
- Parallel, resumable render to H.264 High (CRF 17, GOP 60) plus a ≤ 30 MB review copy.
- QA gates: seedless randomness, missing glyphs, reading speed, dead air, too-short shots, flashes (> 3/s fails), loudness/true peak.
- Claude Code setup:
CLAUDE.mdwith the craft rules, and 4 agents —researcher,scriptwriter,scene-designer,render-qa.
Install (≈ 10 min)
Needs Python ≥ 3.10 and ffmpeg on your PATH.
git clone https://github.com/silueta-studio/silueta-studio && cd silueta-studio
python -m venv .venv
.venv/Scripts/activate # Linux/macOS: source .venv/bin/activate
pip install .
silueta -h
Optional, for real voice timings: install WhisperX in its own venv (it brings PyTorch, ~3 GB)
and pass its Python with --python.
Make a video
silueta new my_story # copies the example (historia.json + cenas.py)
silueta sheet my_story # contact sheet (1 frame per shot) + safe-zone QA -> my_story/prova.png
# record one voice file per shot: my_story/voz/s01.mp3, s02.mp3, ...
silueta align my_story --python <whisperx-venv>/Scripts/python
silueta mix my_story # voice + your licensed music/SFX declared in historia.json
silueta render my_story # -> final.mp4 + final_revisao.mp4
silueta qa my_story
If Windows blocks silueta.exe, run the same commands as python -m silueta_studio <command>.
Without a voice yet, render --force uses estimated timings (for tests only).
With Claude Code, just open the folder and ask: "make a 90-second video about " — the agents follow CLAUDE.md.
Rules the kit enforces
Two independent sources per fact · no photos, logos or third-party characters · music and SFX only from files you own a licence for (none are bundled) · nothing is published or paid for without your explicit OK.
Speed
About 0.85 s per frame on one core; the parallel render uses physical cores − 1 (7 processes: ~0.28 s/frame, so a 2-minute video ≈ 15 min).
Licence
MIT — see LICENSE. Third-party code and ideas: THIRD_PARTY.md.
Español
silueta convierte un guion por planos en un vídeo vertical terminado (1080×1920): siluetas originales dibujadas en código
(sin bancos de imágenes), 3–5 capas con paralaje, luz de recorte, grano, carteles con rebote, subtítulos karaoke palabra a palabra
sincronizados con tu voz real y controles de calidad automáticos. Es el motor de un canal de "historias reales que parecen inventadas",
empaquetado para que Claude Code investigue, escriba, dibuje, renderice y revise un vídeo contigo.
Qué incluye
- Motor en Python (numpy + Pillow + SciPy + ffmpeg): cámara con paralaje, crestas de terreno, cielos, sol/luna, rayos de luz, brasas, personas, aves, barcos, sprites y transiciones (fundido, negro, destello blanco, barrido).
- Karaoke dentro de la zona segura, con la palabra activa en amarillo; las palabras largas se encogen para caber.
- Alineación forzada con WhisperX: tiempos reales por plano y por palabra; los números vuelven al guion ("6" ↔ "seis").
- Mezcla: voz nivelada, tu música ~20 dB bajo la voz (+5 dB en las pausas), efectos con ducking, −14 LUFS.
- Render en paralelo y reanudable a H.264 High (CRF 17, GOP 60) y una copia de revisión de ≤ 30 MB.
- Controles de calidad: aleatoriedad sin semilla, glifos que faltan, velocidad de lectura, huecos muertos, planos demasiado cortos, destellos (> 3/s falla), sonoridad y pico real.
- Claude Code:
CLAUDE.mdcon las reglas del oficio y 4 agentes —researcher,scriptwriter,scene-designer,render-qa.
Instalación (≈ 10 min)
Python ≥ 3.10 y ffmpeg en el PATH; los comandos son los de arriba.
Opcional: WhisperX en su propio venv para los tiempos reales de la voz (--python).
Hacer un vídeo
new → sheet → grabar voz/s01.mp3… → align → mix → render → qa (ver arriba).
Con Claude Code: abre la carpeta y pide "haz un vídeo de 90 segundos sobre ".
Reglas
Dos fuentes independientes por dato · nada de fotos, logos ni personajes ajenos · música y efectos solo con licencia tuya (el kit no trae ninguno) · nada se publica ni se paga sin tu permiso explícito.
Licencia
MIT — ver LICENSE. Código e ideas de terceros: THIRD_PARTY.md.
Metadata
Release files for silueta-studio 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| silueta_studio-0.1.1.tar.gz | 43.8 kB | With provenance | Details for silueta_studio-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| silueta_studio-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for silueta_studio-0.1.1-py3-none-any.whl |
Total release size: 88.6 kB
Release files / silueta_studio-0.1.1.tar.gz
| Download URL | silueta_studio-0.1.1.tar.gz |
|---|---|
| Size | 43.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fc3d2f695594979dfb17478ee13d5f38cbebc53e4947bbc2628eaab70e799782
|
|
BLAKE2b-256 checksum How to use checksums |
6966df5a518f252555db94aaa881eb43fadf275e730c2a1b7f10c25c56926b39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logRelease files / silueta_studio-0.1.1-py3-none-any.whl
| Download URL | silueta_studio-0.1.1-py3-none-any.whl |
|---|---|
| Size | 44.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b1c293b7b90eca4c507cff0ab266925f4e29cb45c9a989873f5ed6d75347b89d
|
|
BLAKE2b-256 checksum How to use checksums |
1861017575792d7fdf823a763dc8d35ccd64be12bf3cff81d68c771f22fab756
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logSecurity for silueta-studio 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for silueta_studio-0.1.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.