mirror of https://github.com/hanzoai/video.git synced 2026-11-03 04:21:39 +00:00

Files

T

calesthio e5367f7d66 feat(character-animation): add local rigged character pipeline

New beta pipeline for reusable cartoon characters with SVG rigs, pose
libraries, action timelines, and Canvas/Remotion/HyperFrames rendering.

- pipeline_defs/character-animation.yaml: 11-stage manifest
- skills/pipelines/character-animation/: 11 stage director skills
- tools/character/: BaseTool implementations for char design, rigging,
  pose libraries, action timelines, previews, and QA
- schemas/artifacts/{character_design,rig_plan,pose_library,
  action_timeline,character_qa_report}.schema.json: canonical artifacts
- schemas/artifacts/scene_plan.schema.json: extended for character-led
  scenes
- .agents/skills/{canvas-procedural-animation,character-animation-qa,
  character-rigging,pose-library-design,svg-character-animation}/:
  Layer 3 vendor knowledge
- AGENT_GUIDE / PROJECT_CONTEXT / README / ARCHITECTURE / PROVIDERS:
  surface the new pipeline and its capability family
- tools/video/hyperframes_compose.py: SVG character rig support
- tests/contracts/test_character_animation_pipeline.py: contract tests

2026-04-28 08:11:02 -07:00

1.9 KiB

Raw Permalink Blame History

Compose Director - Character Animation Pipeline

Goal

Render the approved character animation and prove it was reviewed.

Runtime Routing

First read edit_decisions.render_runtime. It must match the runtime locked in proposal unless a render_runtime_selection decision explicitly changed it.

remotion: stage assets into remotion-composer/public, build composition JSON, render via video_compose.
hyperframes: materialize a HyperFrames workspace and let video_compose delegate to hyperframes_compose. hyperframes lint and validate must pass.
ffmpeg: only for post-processing or simple video assembly; not enough for character acting by itself.

Review Workflow

Run character_rig_renderer to produce or refresh the HyperFrames package. The browser preview is a QA/debug artifact only, not the render path.
Verify the renderer emitted a HyperFrames workspace_path, composition HTML, asset_manifest, and edit_decisions.render_runtime: "hyperframes" handoff.
Run character_animation_reviewer against rig, poses, timeline, and preview.
Render final video through video_compose using the renderer handoff or the approved Remotion/HyperFrames package. The deliverable path is projects/<project-name>/renders/final.mp4, matching the standard OpenMontage project convention.
Run standard final_review: ffprobe, frame sampling, visual spotcheck, audio spotcheck, promise preservation.

Browser QA

When Playwright is available:

open the preview,
capture opening/middle/end frames,
check for console errors,
verify characters are visible,
compare frame deltas to ensure motion exists.

When Playwright is unavailable, use static artifact checks and FFmpeg frame sampling, and report the reduced confidence.

Quality Bar

Do not present the output as complete when character_qa_report.status is revise or fail.

1.9 KiB Raw Permalink Blame History