Skip to main content
Glama

Shard

A motion-design studio for AI video and images, on your own computer.

Plan a film shot by shot, generate it on today's video and image models, and finish it, from a web studio, the terminal, or by asking Claude Code or Codex. Every paid job shows its price first.

CI License: MIT Node 22+ macOS Claude Code | Codex

English · 简体中文 · Español · 日本語 · 한국어 · Português (Brasil) · Deutsch (translations may lag behind English)

Website · A look around · Demo · Feature status · Quick start · Set up with an agent · Credits · The CLI · The MCP server · The studio


What it is

Shard is an open-source studio that runs on your computer and sends generation jobs to kie.ai, one API key for many video, image and audio models (Seedance, Kling, Veo, Wan, MiniMax, GPT Image, Nano Banana, ElevenLabs, Suno and more). You bring the key and pay kie for what you generate; Shard itself is free.

It is for people who want to make short films, ads and social clips with AI models without losing track of the plan, the characters or the bill:

  • Direct a film, not a prompt. Agree a brief, plan the shots with real camera terms, make a storyboard of stills, film each shot, review the takes and cut the result.

  • Keep people consistent. Save characters, products and places in a Library, and build character sheets so the same face comes back in every shot.

  • Know the cost first. Every paid job is priced before it is sent and checked against your daily and per-job limits.

  • Work where you like. The same tools are in the web studio, the kie command line and an MCP server for coding agents.

Shard started as a fork of Chase's motion-design skill, whose ten styles live on here as the Ad templates. See Credits.

Related MCP server: Bench Studio MCP Server

A look around

What's inside

Part

What it does

Studio (web/)

A local web app: Image and Video pages, films planned scene by scene, Openjutsu (beta: swap a person, outfit, object or background into any clip), AI Influencers with three-panel character sheets, a Library of characters, products and places, Looks, your skills, spend and settings.

kie CLI (cli/)

Generates video, images and audio through kie.ai (WaveSpeed is an optional second route for some models), prices every job first, and keeps a record of each one.

MCP server (mcp/)

Gives Claude Code and Codex (and Claude Desktop, with a pasted config) the same tools as the studio, so you can make films by asking.

Render and finish (render/, cli/)

Draws exact graphics in code (titles, logos, numbers) with Remotion, and finishes films with ffmpeg: music, captions, loudness, other aspect ratios.

Skill library (skills/)

Your favourite agent skills, each usable as a /slash-command, as an MCP prompt and in the studio. motion-design holds the Ad templates and the film-making guides.

Spending is guarded everywhere. Every paid job is priced before it is sent and checked against a daily cap and an optional per-job limit, whether it comes from the studio, the CLI or an agent. Looking things up, planning and pricing are free.

Feature status

Status

Features

Ready

Studio (Image, Video, films scene by scene, Library, Looks, Skills, spend), AI Influencers and character sheets, the kie CLI, spending limits, the MCP server for Claude Code and Codex, the skill library, 17 Looks, Remotion graphics templates

Experimental

Openjutsu (beta character swap), ffmpeg finishing (built and unit-tested, not yet verified on a full film), WaveSpeed routes, Claude Desktop (manual config), Linux and Windows (untested)

Planned

ffmpeg check at startup, Silent and Loop switches, take comparison and Retry, Next beat and Coverage in Scenes, self-hosted Openjutsu

Prices come from each provider's page on the date in cli/models.json and can go stale; the CLI warns when they are old. ROADMAP.md has the details.

Demo

A full end-to-end demo film is still to be recorded. It will show one real brief going through Shard: the plan, the storyboard, the takes, the finished cut, and the cost Shard recorded for each job. Until then, the walkthrough at the top and the screenshots are the studio itself, recorded with no generations in it and nothing spent, and no third-party video is presented as Shard output.

You can walk through most of the workflow without spending anything:

kie looks                                        # the 17 Looks
kie plan --menu                                  # every shot size, lens, move and light the planner knows
kie preflight --model seedance-2-5 --duration 10 # what a 10-second shot would cost, without generating
kie video --run try --model seedance-2-5 --duration 5 --look neo-noir --prompt-file idea.txt --dry-run   # the prompt with the Look's words; sends nothing

In the studio, planning a film (brief, shot plan, checker) is free, and every Generate button shows its price before anything is sent.

Quick start

You need Node 22+ and a kie.ai API key. ffmpeg is needed only for finishing, and Python 3.10+ only to check the Ad templates. docs/setup.md explains each step and has a troubleshooting table.

  1. Get the code and install the tools. The installer puts kie on your PATH, links the skills into Claude Code, Codex and Kimi when they are installed, and registers the MCP server.

    git clone https://github.com/AlexMakesC0de/shard-motion-design-studio.git
    cd shard-motion-design-studio
    node install.mjs            # --dry-run shows what it would change first
  2. Add your kie.ai key, readable only by you, then check the setup. kie doctor makes one free balance request and generates nothing.

    mkdir -p ~/.config/kie
    printf '%s' 'YOUR_KIE_KEY' > ~/.config/kie/key && chmod 600 ~/.config/kie/key
    kie doctor
  3. Set a budget. For example, at most $25 a day and $2 per job:

    kie limits --daily 25 --per-job 2
  4. Open the studio. It runs on http://127.0.0.1:4317 and only answers your own machine.

    npm --prefix web install
    npm run studio
  5. Or ask an agent. Restart Claude Code or Codex and try: "Plan a 15-second product film for my app, show me the price, and don't generate anything yet." The MCP page in the studio has the exact setup command for each app.

Set it up with an AI agent

Paste this into Claude Code, Codex or another coding agent with terminal access. It installs everything, checks it and opens the studio, and it is told not to spend anything.

Set up Shard, the motion-design studio at https://github.com/AlexMakesC0de/shard-motion-design-studio, on this computer.

1. Check that Node 22 or newer is installed. If it isn't, tell me how to install it and stop.
2. Clone the repository into a folder I can find (ask me where if unsure), then cd into it.
3. Run `node install.mjs --dry-run`, show me what it would change, and wait for my OK. Then run `node install.mjs`.
4. Tell me to create a kie.ai API key at https://kie.ai and save it myself with:
   mkdir -p ~/.config/kie && printf '%s' 'MY_KEY' > ~/.config/kie/key && chmod 600 ~/.config/kie/key
   Never ask me to paste the key into this chat, and never read or print the key file.
5. When I say it's saved, run `kie doctor` (one free balance check, generates nothing) and show me the result.
6. Ask me for a daily spending limit and a per-job limit, then set them with `kie limits --daily <amount> --per-job <amount>`.
7. Run `npm --prefix web install`, then start the studio with `npm run studio` and give me the address (http://127.0.0.1:4317).
8. If ffmpeg is missing, tell me it's only needed for finishing films and how to install it; don't install it unasked.

Do not generate any image, video or audio, and do not spend money at any step. Finish with a short summary of what was installed and what I can try first.

Make something from the terminal

kie looks                                          # the 17 Looks
kie presets                                        # the ten Ad templates
kie preflight --model seedance-2-5 --duration 10   # what a job would cost, without spending
kie video    --run launch --preset kinetic-typography --duration 10
kie render   --run launch --template logo-reveal --props brand.json
kie assemble --run launch --shot out.mp4 --shot logo-reveal.mp4 --transition fade:0.5
kie variants --run launch --video film.mp4 --ratios 9:16,1:1

kie render needs Remotion, installed once with npm --prefix render install. kie assemble, kie caption and kie variants need ffmpeg.

Generated video is photographic: it invents plausible pixels. Anything that has to be exactly right, like a headline, a logo or a price, is better drawn by kie render and laid over the film. graphic-motion.md explains when to use which.

Your films, takes and spend records stay in runs/, and saved references in library/. Both are ignored by git.

The Looks

A Look sets the camera, light, colour, pacing and sound for a shot in one pick, on any video model. Shard ships 17, listed by kie looks, in the studio's Looks page and through MCP. The previews below were made for Shard.

Shard also keeps the ten Ad templates from Chase's original skill (kie presets): full source prompts with adaptation guides, for example a glass UI launch or an exploded product. They are his work and are not under the MIT licence; see Licence.

Credits

  • Chase (@cth9191) made the original motion-design skill this project grew out of: the ten Ad templates, their source prompts and the adaptation guides. If you like them, give his repo a star.

  • The Ad templates' source prompts first appeared in a Higgsfield Marketing Studio article.

  • The Claude and OpenAI icons on the MCP page are from LobeHub Icons (MIT).

ATTRIBUTION.md lists exactly which files came from Chase's repo.

Licence

Shard's own code and docs are under the MIT licence: the studio, the kie CLI, the MCP server, the render and finishing engines, the installer, the Looks and their previews, the director guides, the tests and the docs.

The Ad templates and the other files from Chase's repo are not covered by the MIT licence. His repo has no licence, so they are his, included here with credit until he grants permission or they are replaced. ATTRIBUTION.md lists them. If you redistribute Shard, leave them out or ask him first.

Tests

npm test             # CLI
npm run test:mcp     # MCP server
npm run test:web     # studio
npm run validate     # the Ad templates: source hashes, templates and gallery

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers