Repolode
Submit
NomaDamas

NomaDamas/CozyClay

Browser-based previs studio for blocking scenes, posing characters, and cutting camera moves, then sending the shots to AI video models.

View on GitHubWebsite
Stars
807
Forks
93
Open issues
13
Last commit
yesterday

What is it?

CozyClay is a previsualization studio that runs in the browser, built with Three.js and React Three Fiber. You block a scene with primitives and set pieces, cast rigged or rigless characters, pose them, and author camera moves and cuts on a timeline.

The main output is for AI video generation. Each shot can be exported as a keyframe pack with first and last frames, a greybox clip, camera JSON and a prompt, or as an mp4, depth and normal passes, a storyboard contact sheet, or an OTIO cut list. The project targets Seedance 2.5, Kling 2, Veo 3 and self-hosted MiniMax-H3 as target models, and flags shots that exceed a model's limits.

The studio also includes a Storyboard mode for still panels, a Workflow canvas for image and video nodes (ComfyUI or fal), and an agent that can drive the scene through a chat panel, an MCP server, or the `cclay` CLI. It runs locally with `npx cozyclay`.

Key features

  • 01Block scenes with primitives and set pieces, then transform them with a gizmo.
  • 02Pose rigged characters, or use rigless capsule figures for blocking.
  • 03Author camera moves and cuts on a timeline, including dolly rails drawn on a top view.
  • 04Export keyframe packs, mp4 shots, depth and normal passes, and OTIO cut lists for AI video.
  • 05Undo any scene change through a single history store.
  • 06Drive the studio with an AI agent via chat, MCP, or a terminal CLI.

Use cases

  • Previsualizing shots for a film, commercial, or music video before filming.
  • Building storyboards and then turning them into moving shots.
  • Generating AI video with controlled camera moves and character blocking.
  • Blocking scene staging and character paths for virtual production.

Quick start

  1. 1

    Run the studio with npx

    npx cozyclay
  2. 2

    Open the bundled starter scene instead of an empty room

    npx cozyclay --scene city-block

Things to know

  • Requires Node.js 22.19 or newer and a Chromium-based browser.
  • Some features need your own API keys, such as the agent providers and the Video node via fal or ComfyUI.

Topics

#3d#previs#storyboard#ai-video#threejs#webgl#animation#camera-control#3d-animation#ai

FAQ

What is CozyClay?
Browser-based previs studio for blocking scenes, posing characters, and cutting camera moves, then sending the shots to AI video models. CozyClay is a previsualization studio that runs in the browser, built with Three.js and React Three Fiber. You block a scene with primitives and set pieces, cast rigged or rigless characters, pose them, and author camera moves and cuts on a timeline.
Is CozyClay free to use? What license does it have?
CozyClay is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is CozyClay still maintained?
Actively maintained. The last commit to CozyClay was on Oct 19, 2026.
What can I use CozyClay for?
Previsualizing shots for a film, commercial, or music video before filming. Building storyboards and then turning them into moving shots. Generating AI video with controlled camera moves and character blocking. Blocking scene staging and character paths for virtual production.
How do I install CozyClay?
Run the studio with npx: npx cozyclay Open the bundled starter scene instead of an empty room: npx cozyclay --scene city-block
Where can I get CozyClay?
The source code and installation instructions are on GitHub: https://github.com/NomaDamas/CozyClay

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects