HiFoHubInstall Blender 4.5.0 and Python 3.11. Extract a token package, then run:
cd 00012
python3 -m pip install -r requirements.txtThe package includes the model, motion sources, custom scene assets and soundtracks. Blender is detected on PATH or at its standard macOS location; use --blender "/path/to/blender" to select another installation. On Windows, replace python3 with py -3.11.
python3 scripts/fuku.py animate --source "sources/mixamo/Walking.fbx"
python3 scripts/fuku.py studio --motion walkinganimate saves corrected BLEND and FBX files. studio creates PNG frames, an MP4 and a GIF. Defaults: canonical studio, matte floor, 512 × 512 pixels, 24 samples, 12 fps.
Generate a motion once, then reuse it for scene comparisons. Use --overwrite only to regenerate it deliberately.
00012/ ├── README.md, VERSIONS.md, requirements.txt, AGENTS.md ├── package.json # identity and traits ├── 00012.blend # original bust ├── 00012.comparison.png # authored appearance/background ├── full_body/ # full-body native model ├── rigged/ # rest-pose BLEND and FBX ├── sources/mixamo/ # all 15 tuned motion sources ├── scripts/ │ ├── fuku.py # CLI entry point │ ├── config/ # motion, scene, signal and recipe profiles │ ├── assets/ # button, UFO and audio inputs │ ├── lib/ # modular preparation/rendering steps │ └── docs/ # usage, module map, agent handoff ├── animations/<motion>/ # generated BLEND, FBX and validation.json └── artworks/ # derived scenes, PNGs, MP4s, GIFs, reports
Select two settings to compare. Click an image to open it at full resolution.
Run python3 scripts/fuku.py <command> [options] from an extracted token folder. Command and Example entries below show the part that follows the script name. The animation file example uses token 00012 from Setup.
Replace placeholders such as <name>, <path> and <n> with actual values, omitting the angle brackets. [options] means optional arguments; omit the square brackets too.
| Command | Usage | Example |
|---|---|---|
animate --source <path> | Apply a source FBX motion to the character and save validated BLEND and FBX files. A recognized source checksum selects its correction profile automatically. | animate --source sources/mixamo/Walking.fbx |
animate --source <path> --profile <name> | Explicitly select a correction profile from scripts/config/animation_profiles.json. Required for an unrecognized source; overrides automatic profile selection. | animate --source sources/mixamo/Walking.fbx --profile walking |
These 15 animations are included in every token package. Paths are relative to the extracted package.
| Animation | FBX path |
|---|---|
walking | sources/mixamo/Walking.fbx |
walker_walk | sources/mixamo/Walker Walk.fbx |
rumba_dancing | sources/mixamo/Rumba Dancing.fbx |
change_direction | sources/mixamo/Change Direction.fbx |
hurricane_kick | sources/mixamo/Hurricane Kick.fbx |
dodging_right | sources/mixamo/Dodging Right.fbx |
female_standing_pose | sources/mixamo/Female Standing Pose.fbx |
jumping_down | sources/mixamo/Jumping Down.fbx |
bicycle_crunch | sources/mixamo/Bicycle Crunch.fbx |
baseball_hit | sources/mixamo/Baseball Hit.fbx |
catwalk_walk_forward_highknees | sources/mixamo/Catwalk Walk Forward HighKnees.fbx |
catwalk_walk | sources/mixamo/Catwalk Walk.fbx |
button_pushing | sources/mixamo/Button Pushing.fbx |
idle | sources/mixamo/Idle.fbx |
situps | sources/mixamo/Situps.fbx |
For a Mixamo animation not included in the package’s sources/mixamo/ list, see Add a new Mixamo animation for the download steps, manifest entry and correction settings.
| Command | Usage | Example |
|---|---|---|
studio | Render a prepared animation to PNG frames, MP4 and GIF. Generate the animation with animate first. | studio |
studio --motion <name> | Select a generated motion by its profile name. Default: walking. Loads its BLEND file from the package’s animations/<name>/ folder; does not generate the motion. | studio --motion walking |
studio --animation <path> | Use an explicit character animation instead of the default input. Studio, button and UFO support BLEND or FBX; multicamera build requires BLEND. Overrides --motion in Studio. Relative paths start at the package for Studio and button/multicamera build, and at the current working directory for UFO build and inspect. | studio --animation animations/walking/00012.walking.blend |
studio --scene-profile <name> | Select a scene preset containing camera, lighting, materials and render defaults. Default: canonical_balanced_matte. Multicamera retains its fixed camera edit. See scene examples below. Also supported by button build/render and multicamera render. | studio --scene-profile soft_product_matte |
studio --camera-profile <name> | Use the camera from another scene preset while retaining the other selected settings. Multicamera rejects this option. Also supported by button build/render. | studio --camera-profile frontal_clean_matte |
studio --studio-lighting <name>studio --material-treatment <name>studio --ground-material <name> | Override the preset’s lighting, character materials or floor material. Choices are illustrated in the lighting, materials and floor examples below. Also supported by button build/render and multicamera render. | studio --studio-lighting softstudio --material-treatment mattestudio --ground-material satin_vinyl |
studio --signal-profile <name> | Select an animated lighting/camera overlay from scripts/config/scene_signal_profiles.json. This release provides subtle_studio_polish. Studio has no overlay by default; multicamera uses this overlay by default. Also supported by button build/render and multicamera render. | studio --signal-profile subtle_studio_polish |
| Command | Usage | Example |
|---|---|---|
build --recipe <name>render --recipe <name>gif --recipe <name> | Build a custom scene, render it, then create a GIF from the completed frames. Run these commands in order with the same recipe and output directory; use matching render settings for gif. | build --recipe buttonrender --recipe buttongif --recipe button |
build --recipe <name> | Choose ufo, button or multicam. Default: ufo. Use the literal name multicam for the multicamera recipe. Use with inspect, build, render or gif. | build --recipe ufo |
render --recipe multicam --music <name-or-path> | Select all (default), none, mid_strut, mid_strut_2, or an audio file path. Music versions fit the complete track and may have different durations. GIFs are silent. | render --recipe multicam --music mid_strut |
These options work with multiple commands. Usage notes describe where each option is supported.
| Command | Usage | Example |
|---|---|---|
studio --package <path> --token-id <n> | Select an extracted token package, or check that its public ID matches <n> (1–10000). The default package contains the launcher. --token-id does not select or download a token; use its website ID, not its internal ID. | studio --package ../05936 --token-id 5936 |
studio --output <path> | Set the output directory. Relative paths start at the current working directory. Defaults are animations/<name>/ for animation preparation, artworks/studio/<scene-profile>/ for Studio, and artworks/<recipe>/ for custom recipes, all inside the package. Relative --source paths start at the package. | studio --output artworks/studio_preview |
studio --size <n>studio --samples <n> | Set square image dimensions to <n> × <n> pixels (minimum 32), or Cycles samples per pixel (minimum 1). The default Studio preset uses 512 × 512 and 24 samples; UFO uses 720 × 720 and 32 samples; multicamera uses 720 × 720 and 16 samples. Denoising is enabled. | studio --size 512studio --samples 24 |
studio --fps <n> | Set output frames per second, from 1 to 120, for Studio/button (default preset: 12). Multicamera requires 12; UFO requires 24. Other rates are rejected for those recipes. | studio --fps 12 |
studio --frame <n> | Render a single source frame as PNG. UFO uses its scene frame number. Multicamera render requires the full edit and rejects this option. Use with studio, render --recipe button or render --recipe ufo. | studio --frame 15 |
studio --dry-run | Print input or render settings without building or rendering. Input animations must exist; custom render checks require a built scene. Unsupported commands do not provide a dry run. Supported by studio and button/multicamera build and render only. | studio --dry-run |
animate --source <path> --overwritebuild --recipe <name> --overwrite | Allow an existing animation or custom scene to be regenerated. Does not replace an incompatible render cache; choose a new --output directory when changing settings. | animate --source sources/mixamo/Walking.fbx --overwritebuild --recipe button --overwrite |
studio --threads <n> | Set the Blender worker thread count. Default: 4. Used by animate, studio, build and render. | studio --threads 4 |
studio --blender <path> | Set the Blender executable path. Otherwise uses BLENDER_BIN, then blender on PATH, then the standard macOS application location. | studio --blender /Applications/Blender.app/Contents/MacOS/Blender |
| Command | Usage | Example |
|---|---|---|
--help | Show launcher usage, commands and options. The launcher uses a shared option parser; consult this table for which commands use each option. | --help |
profiles | Print the scene preset JSON, including preset names and defaults. | profiles |
inspect --recipe <name> | Print package identity, the recipe’s default FBX input path, whether it contains animation, and the output path. Does not build a scene. | inspect --recipe button |
handoff | Print the included AI agent handoff documentation. | handoff |
python3 scripts/fuku.py profiles
python3 scripts/fuku.py inspect --recipe button
python3 scripts/fuku.py studio --motion walking --scene-profile warm_cool_cinematic_matte --dry-run
python3 scripts/fuku.py handoffpython3 scripts/fuku.py animate --package ../05936 --token-id 5936 --source "sources/mixamo/Walking.fbx"
python3 scripts/fuku.py studio --package ../05936 --token-id 5936 --motion walking --output ./artworks/other_characterUFO uses its own camera, lighting and beam treatment; generic studio overrides are rejected. Multicamera keeps its A/B1 camera edit and 12-fps frame maps. Button accepts regular matrix settings and FPS. Use the same output directory across build/render/GIF and the same size/samples for the GIF command.
Copy scripts/config/ufo_palette.json to ufo_palette.json in the token root to customize the UFO’s palette, then build into a new output folder. Numeric camera geometry, recipe timing, and individual choreography signals are profile/module edits, not additional CLI flags.
You can work with an AI coding agent to animate your Fukuhedron and create renders. All 10,000 token packages include the instructions the agent needs to work from your extracted folder:
AGENTS.md — the starting point, directing the agent to the package documentation and workflow.scripts/docs/AGENT_HANDOFF.md — the animation and rendering workflow, validation checks, and guidance for preserving original files.Open the extracted token folder in your agent’s workspace and ask it to read these files before making changes. The handoff also points to scripts/README.md and scripts/docs/CODE_MAP.md. The agent should identify your token from package.json, generate a preview first, and report the output paths and any failed checks.
Read AGENTS.md and scripts/docs/AGENT_HANDOFF.md in this token package, along with the documentation they reference.
Use the included Walking motion to animate this character. Preserve the original files, validate both the BLEND and FBX outputs, and render a low-resolution studio preview for me to review before the final render. Tell me where the outputs are saved and report any failed checks.Tested on macOS x86_64 with Blender 4.5.0, Python 3.11.10, Blender Python 3.11.11 and Pillow 12.2.0. See VERSIONS.md and requirements.txt in the token package.
Regular studio folders contain studio_scene.blend, frames/, studio_report.json, delivery.json, animation.mp4 and animation.gif. A still request produces the scene, report and PNG only. Button and multicamera use settings-specific render subfolders. UFO uses frames_<size>px_<samples>s/ and a similarly named MP4.
The example commands use a separate artworks/cli_examples/<example>/ folder per comparison. This avoids mixing frame caches from different settings.
Choose what you want to change, then explore the pictures and open Commands for an example you like.
Run animate once for each motion, then studio. These clips use the canonical studio. Female Standing Pose is a static pose. Regular motions animate the character only; they do not add props.
python3 scripts/fuku.py animate --source sources/mixamo/Walking.fbx
python3 scripts/fuku.py studio --motion walking --size 512 --samples 32 --output artworks/cli_examples/motion_walking --threads 8artworks/cli_examples/motion_walking/animation.mp4 artworks/cli_examples/motion_walking/studio_scene.blend artworks/cli_examples/motion_walking/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Walker Walk.fbx'
python3 scripts/fuku.py studio --motion walker_walk --size 512 --samples 32 --output artworks/cli_examples/motion_walker_walk --threads 8artworks/cli_examples/motion_walker_walk/animation.mp4 artworks/cli_examples/motion_walker_walk/studio_scene.blend artworks/cli_examples/motion_walker_walk/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Rumba Dancing.fbx'
python3 scripts/fuku.py studio --motion rumba_dancing --size 512 --samples 32 --output artworks/cli_examples/motion_rumba_dancing --threads 8artworks/cli_examples/motion_rumba_dancing/animation.mp4 artworks/cli_examples/motion_rumba_dancing/studio_scene.blend artworks/cli_examples/motion_rumba_dancing/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Change Direction.fbx'
python3 scripts/fuku.py studio --motion change_direction --size 512 --samples 32 --output artworks/cli_examples/motion_change_direction --threads 8artworks/cli_examples/motion_change_direction/animation.mp4 artworks/cli_examples/motion_change_direction/studio_scene.blend artworks/cli_examples/motion_change_direction/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Hurricane Kick.fbx'
python3 scripts/fuku.py studio --motion hurricane_kick --size 512 --samples 32 --output artworks/cli_examples/motion_hurricane_kick --threads 8artworks/cli_examples/motion_hurricane_kick/animation.mp4 artworks/cli_examples/motion_hurricane_kick/studio_scene.blend artworks/cli_examples/motion_hurricane_kick/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Dodging Right.fbx'
python3 scripts/fuku.py studio --motion dodging_right --size 512 --samples 32 --output artworks/cli_examples/motion_dodging_right --threads 8artworks/cli_examples/motion_dodging_right/animation.mp4 artworks/cli_examples/motion_dodging_right/studio_scene.blend artworks/cli_examples/motion_dodging_right/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Female Standing Pose.fbx'
python3 scripts/fuku.py studio --motion female_standing_pose --size 512 --samples 32 --output artworks/cli_examples/motion_female_standing_pose --threads 8artworks/cli_examples/motion_female_standing_pose/animation.mp4 artworks/cli_examples/motion_female_standing_pose/studio_scene.blend artworks/cli_examples/motion_female_standing_pose/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Jumping Down.fbx'
python3 scripts/fuku.py studio --motion jumping_down --size 512 --samples 32 --output artworks/cli_examples/motion_jumping_down --threads 8artworks/cli_examples/motion_jumping_down/animation.mp4 artworks/cli_examples/motion_jumping_down/studio_scene.blend artworks/cli_examples/motion_jumping_down/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Bicycle Crunch.fbx'
python3 scripts/fuku.py studio --motion bicycle_crunch --size 512 --samples 32 --output artworks/cli_examples/motion_bicycle_crunch --threads 8artworks/cli_examples/motion_bicycle_crunch/animation.mp4 artworks/cli_examples/motion_bicycle_crunch/studio_scene.blend artworks/cli_examples/motion_bicycle_crunch/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Baseball Hit.fbx'
python3 scripts/fuku.py studio --motion baseball_hit --size 512 --samples 32 --output artworks/cli_examples/motion_baseball_hit --threads 8artworks/cli_examples/motion_baseball_hit/animation.mp4 artworks/cli_examples/motion_baseball_hit/studio_scene.blend artworks/cli_examples/motion_baseball_hit/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Catwalk Walk Forward HighKnees.fbx'
python3 scripts/fuku.py studio --motion catwalk_walk_forward_highknees --size 512 --samples 32 --output artworks/cli_examples/motion_catwalk_walk_forward_highknees --threads 8artworks/cli_examples/motion_catwalk_walk_forward_highknees/animation.mp4 artworks/cli_examples/motion_catwalk_walk_forward_highknees/studio_scene.blend artworks/cli_examples/motion_catwalk_walk_forward_highknees/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Catwalk Walk.fbx'
python3 scripts/fuku.py studio --motion catwalk_walk --size 512 --samples 32 --output artworks/cli_examples/motion_catwalk_walk --threads 8artworks/cli_examples/motion_catwalk_walk/animation.mp4 artworks/cli_examples/motion_catwalk_walk/studio_scene.blend artworks/cli_examples/motion_catwalk_walk/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Button Pushing.fbx'
python3 scripts/fuku.py studio --motion button_pushing --size 512 --samples 32 --output artworks/cli_examples/motion_button_pushing --threads 8artworks/cli_examples/motion_button_pushing/animation.mp4 artworks/cli_examples/motion_button_pushing/studio_scene.blend artworks/cli_examples/motion_button_pushing/animation.gif
python3 scripts/fuku.py animate --source sources/mixamo/Idle.fbx
python3 scripts/fuku.py studio --motion idle --size 512 --samples 32 --output artworks/cli_examples/motion_idle --threads 8artworks/cli_examples/motion_idle/animation.mp4 artworks/cli_examples/motion_idle/studio_scene.blend artworks/cli_examples/motion_idle/animation.gif
python3 scripts/fuku.py animate --source sources/mixamo/Situps.fbx --threads 8
python3 scripts/fuku.py studio --motion situps --size 512 --samples 32 --output artworks/cli_examples/motion_situps --threads 8artworks/cli_examples/motion_situps/animation.mp4 artworks/cli_examples/motion_situps/studio_scene.blend artworks/cli_examples/motion_situps/animation.gif
--scene-profile selects camera, lighting and materials together. These stills use walking frame 15, 512 × 512 pixels and 32 samples.
python3 scripts/fuku.py studio --motion walking --scene-profile canonical_balanced_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_canonical_balanced_matte --threads 8artworks/cli_examples/scene_canonical_balanced_matte/studio_scene.blend artworks/cli_examples/scene_canonical_balanced_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile soft_product_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_soft_product_matte --threads 8artworks/cli_examples/scene_soft_product_matte/studio_scene.blend artworks/cli_examples/scene_soft_product_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile canonical_balanced_neutral --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_canonical_balanced_neutral --threads 8artworks/cli_examples/scene_canonical_balanced_neutral/studio_scene.blend artworks/cli_examples/scene_canonical_balanced_neutral/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile dramatic_promo_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_dramatic_promo_matte --threads 8artworks/cli_examples/scene_dramatic_promo_matte/studio_scene.blend artworks/cli_examples/scene_dramatic_promo_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile frontal_clean_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_frontal_clean_matte --threads 8artworks/cli_examples/scene_frontal_clean_matte/studio_scene.blend artworks/cli_examples/scene_frontal_clean_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile left_depth_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_left_depth_matte --threads 8artworks/cli_examples/scene_left_depth_matte/studio_scene.blend artworks/cli_examples/scene_left_depth_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile rembrandt_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_rembrandt_matte --threads 8artworks/cli_examples/scene_rembrandt_matte/studio_scene.blend artworks/cli_examples/scene_rembrandt_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile clamshell_beauty_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_clamshell_beauty_matte --threads 8artworks/cli_examples/scene_clamshell_beauty_matte/studio_scene.blend artworks/cli_examples/scene_clamshell_beauty_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile high_key_catalog_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_high_key_catalog_matte --threads 8artworks/cli_examples/scene_high_key_catalog_matte/studio_scene.blend artworks/cli_examples/scene_high_key_catalog_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile low_key_cinematic_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_low_key_cinematic_matte --threads 8artworks/cli_examples/scene_low_key_cinematic_matte/studio_scene.blend artworks/cli_examples/scene_low_key_cinematic_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile split_graphic_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_split_graphic_matte --threads 8artworks/cli_examples/scene_split_graphic_matte/studio_scene.blend artworks/cli_examples/scene_split_graphic_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile edge_rim_silhouette_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_edge_rim_silhouette_matte --threads 8artworks/cli_examples/scene_edge_rim_silhouette_matte/studio_scene.blend artworks/cli_examples/scene_edge_rim_silhouette_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile window_room_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_window_room_matte --threads 8artworks/cli_examples/scene_window_room_matte/studio_scene.blend artworks/cli_examples/scene_window_room_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile warm_cool_cinematic_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_warm_cool_cinematic_matte --threads 8artworks/cli_examples/scene_warm_cool_cinematic_matte/studio_scene.blend artworks/cli_examples/scene_warm_cool_cinematic_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile top_product_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_top_product_matte --threads 8artworks/cli_examples/scene_top_product_matte/studio_scene.blend artworks/cli_examples/scene_top_product_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --scene-profile canonical_color_pop --frame 15 --size 512 --samples 32 --output artworks/cli_examples/scene_canonical_color_pop --threads 8artworks/cli_examples/scene_canonical_color_pop/studio_scene.blend artworks/cli_examples/scene_canonical_color_pop/frames/frame_0001.png
--camera-profile selects only the camera from a named preset. The CLI supports the three distinct camera angles below; numeric angle and zoom changes require editing the profile.
python3 scripts/fuku.py studio --motion walking --camera-profile canonical_balanced_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/camera_canonical_balanced_matte --threads 8artworks/cli_examples/camera_canonical_balanced_matte/studio_scene.blend artworks/cli_examples/camera_canonical_balanced_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --camera-profile frontal_clean_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/camera_frontal_clean_matte --threads 8artworks/cli_examples/camera_frontal_clean_matte/studio_scene.blend artworks/cli_examples/camera_frontal_clean_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --camera-profile left_depth_matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/camera_left_depth_matte --threads 8artworks/cli_examples/camera_left_depth_matte/studio_scene.blend artworks/cli_examples/camera_left_depth_matte/frames/frame_0001.png
--studio-lighting selects the light rig. Camera, pose, materials and floor are the same in each example.
python3 scripts/fuku.py studio --motion walking --studio-lighting soft --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_soft --threads 8artworks/cli_examples/light_soft/studio_scene.blend artworks/cli_examples/light_soft/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting balanced --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_balanced --threads 8artworks/cli_examples/light_balanced/studio_scene.blend artworks/cli_examples/light_balanced/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting dramatic --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_dramatic --threads 8artworks/cli_examples/light_dramatic/studio_scene.blend artworks/cli_examples/light_dramatic/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting rembrandt --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_rembrandt --threads 8artworks/cli_examples/light_rembrandt/studio_scene.blend artworks/cli_examples/light_rembrandt/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting clamshell --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_clamshell --threads 8artworks/cli_examples/light_clamshell/studio_scene.blend artworks/cli_examples/light_clamshell/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting high_key --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_high_key --threads 8artworks/cli_examples/light_high_key/studio_scene.blend artworks/cli_examples/light_high_key/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting low_key --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_low_key --threads 8artworks/cli_examples/light_low_key/studio_scene.blend artworks/cli_examples/light_low_key/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting split --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_split --threads 8artworks/cli_examples/light_split/studio_scene.blend artworks/cli_examples/light_split/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting edge_rim --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_edge_rim --threads 8artworks/cli_examples/light_edge_rim/studio_scene.blend artworks/cli_examples/light_edge_rim/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting window --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_window --threads 8artworks/cli_examples/light_window/studio_scene.blend artworks/cli_examples/light_window/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting warm_cool --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_warm_cool --threads 8artworks/cli_examples/light_warm_cool/studio_scene.blend artworks/cli_examples/light_warm_cool/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --studio-lighting top_product --frame 15 --size 512 --samples 32 --output artworks/cli_examples/light_top_product --threads 8artworks/cli_examples/light_top_product/studio_scene.blend artworks/cli_examples/light_top_product/frames/frame_0001.png
--material-treatment selects matte (default), neutral (more reflection), or saturated (increased color saturation).
python3 scripts/fuku.py studio --motion walking --material-treatment matte --frame 15 --size 512 --samples 32 --output artworks/cli_examples/material_matte --threads 8artworks/cli_examples/material_matte/studio_scene.blend artworks/cli_examples/material_matte/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --material-treatment neutral --frame 15 --size 512 --samples 32 --output artworks/cli_examples/material_neutral --threads 8artworks/cli_examples/material_neutral/studio_scene.blend artworks/cli_examples/material_neutral/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --material-treatment saturated --frame 15 --size 512 --samples 32 --output artworks/cli_examples/material_saturated --threads 8artworks/cli_examples/material_saturated/studio_scene.blend artworks/cli_examples/material_saturated/frames/frame_0001.png
--ground-material selects the floor surface. All examples use balanced lighting.
python3 scripts/fuku.py studio --motion walking --ground-material matte_cyc --frame 15 --size 512 --samples 32 --output artworks/cli_examples/floor_matte_cyc --threads 8artworks/cli_examples/floor_matte_cyc/studio_scene.blend artworks/cli_examples/floor_matte_cyc/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --ground-material seamless_paper --frame 15 --size 512 --samples 32 --output artworks/cli_examples/floor_seamless_paper --threads 8artworks/cli_examples/floor_seamless_paper/studio_scene.blend artworks/cli_examples/floor_seamless_paper/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --ground-material plaster --frame 15 --size 512 --samples 32 --output artworks/cli_examples/floor_plaster --threads 8artworks/cli_examples/floor_plaster/studio_scene.blend artworks/cli_examples/floor_plaster/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --ground-material satin_vinyl --frame 15 --size 512 --samples 32 --output artworks/cli_examples/floor_satin_vinyl --threads 8artworks/cli_examples/floor_satin_vinyl/studio_scene.blend artworks/cli_examples/floor_satin_vinyl/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --ground-material polished_acrylic --frame 15 --size 512 --samples 32 --output artworks/cli_examples/floor_polished_acrylic --threads 8artworks/cli_examples/floor_polished_acrylic/studio_scene.blend artworks/cli_examples/floor_polished_acrylic/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --ground-material soft_rubber --frame 15 --size 512 --samples 32 --output artworks/cli_examples/floor_soft_rubber --threads 8artworks/cli_examples/floor_soft_rubber/studio_scene.blend artworks/cli_examples/floor_soft_rubber/frames/frame_0001.png
--size sets square pixel dimensions, --samples sets Cycles samples, and --fps sets temporal sampling and output FPS. Denoising is enabled. PNGs include 300-DPI metadata; video uses pixel dimensions and FPS.
Use 24 samples or more as a starting point, and 32 or more for final output. Use 1–8 for quick previews. Denoising is enabled at every sample count; more samples improve its input. If reflections, shadows or the UFO beam remain noisy, increase the count and check the moving clip for flicker.
Site examples use 32 samples, except the sample-count comparison and the exact-default example. See the Blender sampling and denoising reference.
python3 scripts/fuku.py studio --motion walking --size 128 --samples 32 --frame 15 --output artworks/cli_examples/size_128 --threads 8artworks/cli_examples/size_128/studio_scene.blend artworks/cli_examples/size_128/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --size 512 --samples 32 --frame 15 --output artworks/cli_examples/size_512 --threads 8artworks/cli_examples/size_512/studio_scene.blend artworks/cli_examples/size_512/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --size 720 --samples 32 --frame 15 --output artworks/cli_examples/size_720 --threads 8artworks/cli_examples/size_720/studio_scene.blend artworks/cli_examples/size_720/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --size 512 --samples 1 --frame 15 --output artworks/cli_examples/samples_1 --threads 8artworks/cli_examples/samples_1/studio_scene.blend artworks/cli_examples/samples_1/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --size 512 --samples 8 --frame 15 --output artworks/cli_examples/samples_8 --threads 8artworks/cli_examples/samples_8/studio_scene.blend artworks/cli_examples/samples_8/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --size 512 --samples 24 --frame 15 --output artworks/cli_examples/samples_24 --threads 8artworks/cli_examples/samples_24/studio_scene.blend artworks/cli_examples/samples_24/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --size 512 --samples 32 --frame 15 --output artworks/cli_examples/samples_32 --threads 8artworks/cli_examples/samples_32/studio_scene.blend artworks/cli_examples/samples_32/frames/frame_0001.png
python3 scripts/fuku.py studio --motion walking --size 512 --samples 32 --fps 6 --output artworks/cli_examples/fps_6 --threads 8artworks/cli_examples/fps_6/animation.mp4 artworks/cli_examples/fps_6/studio_scene.blend artworks/cli_examples/fps_6/animation.gif
python3 scripts/fuku.py studio --motion walking --size 512 --samples 32 --fps 12 --output artworks/cli_examples/fps_12 --threads 8artworks/cli_examples/fps_12/animation.mp4 artworks/cli_examples/fps_12/studio_scene.blend artworks/cli_examples/fps_12/animation.gif
python3 scripts/fuku.py studio --motion walking --size 512 --samples 32 --fps 24 --output artworks/cli_examples/fps_24 --threads 8artworks/cli_examples/fps_24/animation.mp4 artworks/cli_examples/fps_24/studio_scene.blend artworks/cli_examples/fps_24/animation.gif
python3 scripts/fuku.py studio --motion walking --output artworks/cli_examples/exact_defaults --threads 8artworks/cli_examples/exact_defaults/animation.mp4 artworks/cli_examples/exact_defaults/studio_scene.blend artworks/cli_examples/exact_defaults/animation.gif
--signal-profile subtle_studio_polish adds small animated changes to light intensity and camera scale. Both examples use satin vinyl.
python3 scripts/fuku.py studio --motion walking --size 512 --samples 32 --ground-material satin_vinyl --output artworks/cli_examples/signal_false --threads 8artworks/cli_examples/signal_false/animation.mp4 artworks/cli_examples/signal_false/studio_scene.blend artworks/cli_examples/signal_false/animation.gif
python3 scripts/fuku.py studio --motion walking --size 512 --samples 32 --ground-material satin_vinyl --signal-profile subtle_studio_polish --output artworks/cli_examples/signal_true --threads 8artworks/cli_examples/signal_true/animation.mp4 artworks/cli_examples/signal_true/studio_scene.blend artworks/cli_examples/signal_true/animation.gif
Explicit flags override the corresponding fields in --scene-profile. Add --dry-run to inspect the resolved settings before rendering.
python3 scripts/fuku.py studio --motion walking --scene-profile warm_cool_cinematic_matte --camera-profile frontal_clean_matte --ground-material polished_acrylic --material-treatment neutral --frame 15 --size 512 --samples 32 --output artworks/cli_examples/combined --threads 8artworks/cli_examples/combined/studio_scene.blend artworks/cli_examples/combined/frames/frame_0001.png
Use the 1-based website/marketplace ID. Website token 1 is internal token 0, in folder 00001/. The package handles that conversion; do not subtract one in commands. Examples below run from the indicated token folder.
Use a generated character BLEND or FBX with --animation. Select another extracted character with --package. --token-id checks its 1-based website ID.
python3 scripts/fuku.py animate --source sources/mixamo/Walking.fbx
python3 scripts/fuku.py studio --motion walking --animation animations/walking/00012.walking.fbx --frame 15 --size 512 --samples 32 --output artworks/cli_examples/fbx_input --threads 8artworks/cli_examples/fbx_input/studio_scene.blend artworks/cli_examples/fbx_input/frames/frame_0001.png
python3 scripts/fuku.py animate --source sources/mixamo/Walking.fbx --threads 8
python3 scripts/fuku.py studio --motion walking --frame 15 --size 512 --samples 32 --output artworks/cli_examples/other_token --threads 8artworks/cli_examples/other_token/studio_scene.blend artworks/cli_examples/other_token/frames/frame_0001.png
python3 scripts/fuku.py animate --source sources/mixamo/Walking.fbx --threads 8
python3 scripts/fuku.py studio --motion walking --token-id 1 --frame 15 --size 512 --samples 32 --output artworks/cli_examples/first_website_token --threads 8artworks/cli_examples/first_website_token/studio_scene.blend artworks/cli_examples/first_website_token/frames/frame_0001.png
Generate the required motion, build the scene, then render and create the GIF. Use the same --output folder throughout and matching render settings for the GIF.
| Recipe | Source | Defaults | Audio |
|---|---|---|---|
| button | Button Pushing.fbx | 512 px · 24 samples · 12 fps | Silent |
| multicam | Catwalk Walk Forward HighKnees.fbx | 720 px · 16 samples · 12 fps | Both bundled tracks |
| ufo | Walking.fbx | 720 px · 32 samples · 24 fps | Beep, footsteps and departure |
python3 scripts/fuku.py animate --source 'sources/mixamo/Button Pushing.fbx' --threads 8
python3 scripts/fuku.py build --recipe button --output artworks/cli_examples/custom_button --threads 8
python3 scripts/fuku.py render --recipe button --size 512 --samples 32 --output artworks/cli_examples/custom_button --threads 8
python3 scripts/fuku.py gif --recipe button --size 512 --samples 32 --output artworks/cli_examples/custom_button --threads 8artworks/cli_examples/custom_button/source_animation.blend artworks/cli_examples/custom_button/scene.blend artworks/cli_examples/custom_button/button_blink.blend artworks/cli_examples/custom_button/renders/canonical_balanced_matte_512px_32s_e763cd06d4/animation.mp4 artworks/cli_examples/custom_button/renders/canonical_balanced_matte_512px_32s_e763cd06d4/studio_scene.blend artworks/cli_examples/custom_button/renders/canonical_balanced_matte_512px_32s_e763cd06d4/animation.gif
python3 scripts/fuku.py animate --source 'sources/mixamo/Catwalk Walk Forward HighKnees.fbx' --threads 8
python3 scripts/fuku.py build --recipe multicam --output artworks/cli_examples/custom_multicam --threads 8
python3 scripts/fuku.py render --recipe multicam --size 512 --samples 32 --output artworks/cli_examples/custom_multicam --threads 8
python3 scripts/fuku.py gif --recipe multicam --size 512 --samples 32 --output artworks/cli_examples/custom_multicam --threads 8artworks/cli_examples/custom_multicam/scene.blend artworks/cli_examples/custom_multicam/renders/512px_32s_8bd8ec6de7/animation_mid_strut.mp4 artworks/cli_examples/custom_multicam/renders/512px_32s_8bd8ec6de7/animation.mp4 artworks/cli_examples/custom_multicam/renders/512px_32s_8bd8ec6de7/animation_mid_strut_2.mp4 artworks/cli_examples/custom_multicam/renders/512px_32s_8bd8ec6de7/animation.gif artworks/cli_examples/custom_multicam/renders/512px_32s_8bd8ec6de7/camera_a/studio_scene.blend artworks/cli_examples/custom_multicam/renders/512px_32s_8bd8ec6de7/blink_overrides/studio_scene.blend artworks/cli_examples/custom_multicam/renders/512px_32s_8bd8ec6de7/camera_b1/studio_scene.blend
python3 scripts/fuku.py animate --source sources/mixamo/Walking.fbx
python3 scripts/fuku.py build --recipe ufo --output artworks/cli_examples/custom_ufo --threads 8
python3 scripts/fuku.py render --recipe ufo --size 512 --samples 32 --output artworks/cli_examples/custom_ufo --threads 8
python3 scripts/fuku.py gif --recipe ufo --size 512 --samples 32 --output artworks/cli_examples/custom_ufo --threads 8artworks/cli_examples/custom_ufo/ufo_base.blend artworks/cli_examples/custom_ufo/source_animation.blend artworks/cli_examples/custom_ufo/scene.blend artworks/cli_examples/custom_ufo/ufo_commute_v3_departure_sound_soft.blend artworks/cli_examples/custom_ufo/animation_512px_32s.mp4 artworks/cli_examples/custom_ufo/ufo_commute_v2.blend artworks/cli_examples/custom_ufo/animation.gif artworks/cli_examples/custom_ufo/ufo_commute_v3.blend artworks/cli_examples/custom_ufo/ufo_commute_v3_footsteps_light.blend
The downloaded FBX supplies the motion. An entry in scripts/config/animation_profiles.json names the output and selects the corrections applied to that motion.
Upload the rigged FBX from your package’s rigged/ folder to Mixamo. Select an animation, tune its settings, and download it as FBX with Without Skin selected. Save it in sources/mixamo/. The examples here use Crawl.fbx.
From the extracted token folder, calculate the downloaded file’s MD5 checksum:
python3 -c "import hashlib; from pathlib import Path; p = Path('sources/mixamo/Crawl.fbx'); print(hashlib.md5(p.read_bytes()).hexdigest())"Add this entry inside the manifest’s animations object as a starting point. Give the entry key and output_name the same new name, such as crawl. Set source_filename to the exact downloaded filename and source_md5 to the printed checksum. Separate entries with a comma.
"crawl": {
"source_filename": "Crawl.fbx",
"source_md5": "PASTE_THE_CHECKSUM_HERE",
"output_name": "crawl",
"settings": {
"arm_profile": "raw",
"arm_mirror_source": "none",
"arm_mirror_phase": 0.0,
"arm_motion": 0.58,
"leg_motion": 0.88,
"head_tilt_degrees": 0.0
}
}This uses the downloaded motion with the corrections below. Inspect the result and tune the settings for that motion. A matching checksum selects the profile automatically; --profile crawl selects it explicitly. Recalculate the checksum if you replace or re-download the FBX.
Edit these JSON settings in the profile. Values omitted from settings inherit the manifest’s defaults. These are animation corrections; scene appearance is controlled separately by studio.
| Setting | Manifest default | Effect |
|---|---|---|
arm_profile | "raw" | "raw" keeps the imported arm motion unless mirroring is enabled. "walking" forces character-left to character-right mirroring with a half-cycle offset, overriding the mirror settings. "walker_walk" lowers and moves the character’s left arm inward when mirroring is disabled. This setting is separate from the manifest entry name: the bundled walking entry uses "raw". |
arm_mirror_source | "character-right" | "none" retains independent arm motion. "character-left" or "character-right" mirrors that anatomical arm’s geometry and motion onto the opposite arm. Left and right refer to the character, not the viewer. Set "none" explicitly to avoid inheriting mirroring. |
arm_mirror_phase | 0.0 | Offsets the source motion when mirroring, measured in cycles. 0.0 uses the same point in the cycle; 0.5 uses a half-cycle offset. Has no effect when mirroring is disabled. arm_profile: "walking" forces 0.5. |
leg_motion | 0.88 | Controls how much upper-leg rotation is retained around its average pose. 1.0 retains the full rotation range; 0.0 holds the average orientation. Values are limited to 0–1. This changes leg movement, not playback speed. |
head_tilt_degrees | 0.0 | Adds head roll around the character’s forward axis, in degrees. Zero adds no tilt. Positive and negative values tilt in opposite directions; inspect the result for clearance around the shoulders and mouth. |
arm_motion | 0.58 | Present in the manifest, but unused by the current correction implementation. Changing it currently has no effect. |
The recommended default preserves independent arm movements, retains 0.88 of the upper-leg rotation range, and adds no head tilt. It explicitly sets arm_mirror_source to "none" to override the manifest default. Enable mirroring only when the motion needs that correction. All Mixamo animations generated by this script are in place: horizontal travel is removed, while vertical movement is retained. To enable horizontal travel, either add it in Blender after generation, or modify scripts/lib/apply_mixamo_animation.py to skip make_in_place(...) and regenerate from an FBX that contains the original travel.
python3 scripts/fuku.py animate --source sources/mixamo/Crawl.fbx --profile crawl
python3 scripts/fuku.py studio --motion crawl --output artworks/crawl_previewInspect the motion and validation results. Adjust the profile if needed, regenerate with --overwrite, and use a new render output folder:
python3 scripts/fuku.py animate --source sources/mixamo/Crawl.fbx --profile crawl --overwrite
python3 scripts/fuku.py studio --motion crawl --output artworks/crawl_preview_v2