M
MusicMaster4/umbra-25d
2.5D silhouette-and-diorama animation framework for AI agents: Python scene in, cinematic 1080p film out (Blender EEVEE on the GPU).
○checked 2026-11-20 - the package in the command does not match this entry, so it is not shown as a copyable command.
updated 2026-11-16
View on GitHub ↗Link checked 2026-11-17 · HTTP 200 · opens the vendor's own site
After install: how to tell it works
- What you see after install — The command exits 0 and the terminal shows no "command not found" or "permission denied".
- One-line self-check — Run the smallest usage example from that repository's README. If the output matches what the README describes, it is working.
- If that does not work — This project has no troubleshooting notes. Search its issues for "install".
The install command comes from the repository; these checks describe observable results only and do not replace the project's own docs.
- Star count
- 0 ★ · MusicMaster4/umbra-25d · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-15 · last seen 2026-11-20 · seen 6× · listed by 1 sources
- Score
- score 103 · 1 sources · repo
- Install
- see Install & config above
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
MusicMaster4/umbra-25d;first catalogued 2026-11-15;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# umbra
Excerpted from the repository README (abridged)
2.5D silhouette-and-diorama animation, written in Python, built for AI agents.
Describe a scene in ~60 lines; umbra stages it in Blender, lights it, animates it and renders a
1080p film on your GPU. No Blender skills, no keyframing, no node graphs.
python
from umbra import
class Hello(Scene):
duration = 8
def build(s):
s.table(at=(0, 0)); s.chair(at=(0, -0.75)); s.lamp(at=(0, 0), kind="pendant")
a = s.person(at=(0, -0.75), color=WHITE).sit(pose="sit_table")
b = s.person(at=(3.5, 2.5), color=RED, build="woman", hair="long")
b.walk((0.9, 0.5), t=1, dur=3).pose("wave", t=4.2)
a.look_at(b.anchor("head"), t=2.5)
s.cam.set(pos=(4.5, -5.5, 3.2), look=(0.3, 0, 1), lens=45)
s.cam.orbit(25, t=0, dur=8)
s.label(b.anchor("above"), "Hello", t=4.4, out=7.4)
bash
python -m umbra render scenes/00_hello.py # -> out/00_hello.mp4
## Gallery
Ten 20-second films, each one a single Python file in scenes/. The first drafts of scenes 04–10
were written by fresh AI agents from AGENTS.md, in at most six contact-sheet iterations each;
their friction reports shaped the API you see here.
01 · Cabin fight — blueprint look, crowd, fight choreography, a dive through cloud
02 · Corcovado — dusk look, terrain, chase cam, explosions, falling wreck
03 · Dinner date — candle light, hand IK, shallow focus
04 · Crime scene — noir look, lantern beam, callout labels
05 · Rocket launch — countdown, fire and smoke riding a moving anchor
06 · Night chase — procedural city, headlights, route trails
07 · Warehouse — clay look, tilt-shift miniature
08 · Storm — water, rain, lightning, a sweeping beam
09 · Penalty — crowd, ball trajectory, broadcast-style graphics
10 · Orbit — no people: pure motion graphics in space
## Install
| need | version | notes |
| Blender | 4.5 LTS or newer (developed on 5.2) | found automatically, or set UMBRA_BLENDER=/path/to/blender |
| ffmpeg | any recent | on PATH (or pip install imageio-ffmpeg) |
| Python | 3.9+ | only runs the CLI; no packages to install |
| GPU | anything Blender's EEVEE runs on | NVIDIA / AMD / Intel / Apple; no CUDA or OptiX setup |
bash
git clone https://github.com/MusicMaster4/umbra-25d && cd umbra-25d
python -m umbra doctor # checks Blender + ffmpeg
python -m umbra sheet scenes/00_hello.py # a contact sheet in ~10 s
## For AI agents
Point your agent at the repo and say what film you want. AGENTS.md (also loaded through
CLAUDE.md) is a single page with the whole API, the working loop and the art-direction rules; an agent
does not need to read the source.
> Read AGENTS.md, then write scenes/lighthouse.py: a 20-second film of a fishing boat in a storm
> near a lighthouse. Iterate with python -m umbra sheet until it looks right, then render it.
The loop is built to be cheap in tokens:
| step | command | cost |
| see the whole film | python -m umbra sheet scene.py | one image (12 timestamped frames), ~10 s |
| check a moment | python -m umbra sheet scene.py -t 4.2 -t 4.6 -t 5.0 | one image |
| check detail | python -m umbra still scene.py -t 6.5 | one 1080p frame |
| check without rendering | python -m umbra lint scene.py | text only, no GPU, ~5 s |
| deliver | python -m umbra render scene.py | mp4; the ten films here took 3–20 min each (median 7) at 1080p on an RTX 3070 |
Describe a scene in ~60 lines; umbra stages it in Blender, lights it, animates it and renders a
1080p film on your GPU. No Blender skills, no keyframing, no node graphs.
python
from umbra import
class Hello(Scene):
duration = 8
def build(s):
s.table(at=(0, 0)); s.chair(at=(0, -0.75)); s.lamp(at=(0, 0), kind="pendant")
a = s.person(at=(0, -0.75), color=WHITE).sit(pose="sit_table")
b = s.person(at=(3.5, 2.5), color=RED, build="woman", hair="long")
b.walk((0.9, 0.5), t=1, dur=3).pose("wave", t=4.2)
a.look_at(b.anchor("head"), t=2.5)
s.cam.set(pos=(4.5, -5.5, 3.2), look=(0.3, 0, 1), lens=45)
s.cam.orbit(25, t=0, dur=8)
s.label(b.anchor("above"), "Hello", t=4.4, out=7.4)
bash
python -m umbra render scenes/00_hello.py # -> out/00_hello.mp4
## Gallery
Ten 20-second films, each one a single Python file in scenes/. The first drafts of scenes 04–10
were written by fresh AI agents from AGENTS.md, in at most six contact-sheet iterations each;
their friction reports shaped the API you see here.
01 · Cabin fight — blueprint look, crowd, fight choreography, a dive through cloud
02 · Corcovado — dusk look, terrain, chase cam, explosions, falling wreck
03 · Dinner date — candle light, hand IK, shallow focus
04 · Crime scene — noir look, lantern beam, callout labels
05 · Rocket launch — countdown, fire and smoke riding a moving anchor
06 · Night chase — procedural city, headlights, route trails
07 · Warehouse — clay look, tilt-shift miniature
08 · Storm — water, rain, lightning, a sweeping beam
09 · Penalty — crowd, ball trajectory, broadcast-style graphics
10 · Orbit — no people: pure motion graphics in space
## Install
| need | version | notes |
| Blender | 4.5 LTS or newer (developed on 5.2) | found automatically, or set UMBRA_BLENDER=/path/to/blender |
| ffmpeg | any recent | on PATH (or pip install imageio-ffmpeg) |
| Python | 3.9+ | only runs the CLI; no packages to install |
| GPU | anything Blender's EEVEE runs on | NVIDIA / AMD / Intel / Apple; no CUDA or OptiX setup |
bash
git clone https://github.com/MusicMaster4/umbra-25d && cd umbra-25d
python -m umbra doctor # checks Blender + ffmpeg
python -m umbra sheet scenes/00_hello.py # a contact sheet in ~10 s
## For AI agents
Point your agent at the repo and say what film you want. AGENTS.md (also loaded through
CLAUDE.md) is a single page with the whole API, the working loop and the art-direction rules; an agent
does not need to read the source.
> Read AGENTS.md, then write scenes/lighthouse.py: a 20-second film of a fishing boat in a storm
> near a lighthouse. Iterate with python -m umbra sheet until it looks right, then render it.
The loop is built to be cheap in tokens:
| step | command | cost |
| see the whole film | python -m umbra sheet scene.py | one image (12 timestamped frames), ~10 s |
| check a moment | python -m umbra sheet scene.py -t 4.2 -t 4.6 -t 5.0 | one image |
| check detail | python -m umbra still scene.py -t 6.5 | one 1080p frame |
| check without rendering | python -m umbra lint scene.py | text only, no GPU, ~5 s |
| deliver | python -m umbra render scene.py | mp4; the ten films here took 3–20 min each (median 7) at 1080p on an RTX 3070 |
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/musicmaster4-umbra-25d/)
- Source
- github · https://github.com/MusicMaster4/umbra-25d
- Browse by field
- Open source
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.