Metadata-Version: 2.5
Name: reel-studio
Version: 0.2.4
Summary: Agency-quality marketing reels, ads and posts made by Claude Code. Free and open source; no per-video fees.
Project-URL: Homepage, https://github.com/murathany7/reel-studio
Project-URL: Issues, https://github.com/murathany7/reel-studio/issues
Author: Murathan Yıldırım
License-Expression: MIT
Keywords: ai-video,blender,claude-code,claude-code-plugin,claude-skills,ffmpeg,gsap,headless-chrome,instagram-reels,marketing,motion-graphics,pixi,reels,remotion-alternative,threejs,tiktok,video,video-ads,video-generation
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.9
Description-Content-Type: text/markdown

<!-- PyPI cannot resolve relative paths: every image and link here is absolute. -->
<h1 align="center">🎬 Reel Studio</h1>

<p align="center">
  <a href="https://pypi.org/project/reel-studio/"><img src="https://img.shields.io/pypi/v/reel-studio?color=e8a33d" alt="PyPI"></a>
  <a href="https://www.npmjs.com/package/reel-studio"><img src="https://img.shields.io/npm/v/reel-studio?color=e8a33d" alt="npm"></a>
  <a href="https://github.com/murathany7/reel-studio/actions/workflows/ci.yml"><img src="https://github.com/murathany7/reel-studio/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  <a href="https://github.com/murathany7/reel-studio/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-3ecf7a" alt="MIT"></a>
  <a href="https://github.com/murathany7/reel-studio"><img src="https://img.shields.io/badge/Claude%20Code-plugin-8b93a1" alt="Claude Code plugin"></a>
</p>

<p align="center"><b>Agency-quality reels, ads and posts, made by Claude Code.</b><br>
Open source and free. Your Claude subscription does the rest.<br>
No editor, no timeline, no per-video fees. Every frame is code you own.</p>

<p align="center">
  <img src="https://raw.githubusercontent.com/murathany7/reel-studio/main/docs/media/bike-logger-reel.gif" width="260" alt="Bike Logger reel">
</p>
<p align="center"><sub><b>Bike Logger</b> robotics kit reel: 28 s, made by an agent from the product's own live 3D site.<br>
Full-quality MP4: <a href="https://github.com/murathany7/reel-studio/releases/latest">Releases</a></sub></p>

---

## Quick start

```bash
pipx install reel-studio      # or: uv tool install reel-studio
reel-studio init              # copy the kit and skills here and install the renderer
```

Or without installing anything: `uvx reel-studio init`.

The renderer runs on Node, so you also need **Node 18+, Google Chrome and ffmpeg**. Blender is optional, for 3D plates.
Then open the folder in Claude Code and ask:

> *Add my product as a new brand: https://my-product.com* → facts, colours, fonts, voice, rules
>
> *Make a 15 s reel for &lt;brand&gt; about &lt;feature&gt;* → brief and storyboard, then the video once you approve

## How it works

<p align="center"><img src="https://raw.githubusercontent.com/murathany7/reel-studio/main/docs/media/pipeline.svg" width="860" alt="Brief → Storyboard → You approve → HTML on one clock → Frame QA → MP4"></p>

Claude Code writes a brief and a storyboard, waits for your yes, builds the piece as an HTML page, renders every
frame in headless Chrome, checks them, and delivers a folder with the video and how it was made.
Every frame is a pure function of time, so two renders are identical.

## Example: Bike Logger

A robotics kit reel, built by capturing the product's own 3D web page and laying brand copy on top.

<p align="center"><img src="https://raw.githubusercontent.com/murathany7/reel-studio/main/docs/media/bike-logger-strip.jpg" alt="Frames from the Bike Logger reel"></p>

<table><tr>
<td width="50%"><img src="https://raw.githubusercontent.com/murathany7/reel-studio/main/brands/bike-logger/assets/reference/brand-check.png" alt="Brand check card"><br><sub><b>Brand check</b>: one still that proves the brand's look renders right before any video is made.</sub></td>
<td width="50%"><img src="https://raw.githubusercontent.com/murathany7/reel-studio/main/docs/media/qa-contact-sheet.jpg" alt="QA contact sheet with safe zones"><br><sub><b>Frame QA</b>: a contact sheet with the platform's safe zones drawn over it, plus a motion check that flags jumps.</sub></td>
</tr></table>

Everything behind it is in the repo:
[the brand](https://github.com/murathany7/reel-studio/tree/main/brands/bike-logger) ·
[brief → storyboard → delivery](https://github.com/murathany7/reel-studio/blob/main/productions/bike-logger/REEL-001-kit/README.md) ·
[the composition](https://github.com/murathany7/reel-studio/blob/main/productions/bike-logger/REEL-001-kit/composition/index.html) ·
[the QA report](https://github.com/murathany7/reel-studio/blob/main/productions/bike-logger/REEL-001-kit/qa/report.md)

## Engines, all on one clock

| Look | Engine |
|---|---|
| Text, UI, layouts | HTML/CSS + GSAP |
| Cartoon character | SVG rig · Lottie |
| Particles | Pixi.js |
| 3D, toon 3D | Three.js |
| Premium 3D, physics | Blender (pre-rendered plate) |
| Your live website | Page capture |

Mix them freely in one piece.

## Other ways to install

This package ships the same kit as `npx reel-studio init`. Also available as a Claude Code plugin
(`/plugin marketplace add murathany7/reel-studio`), on Homebrew and as a Docker image:
see the [install guide](https://github.com/murathany7/reel-studio#install).

---

<p align="center"><a href="https://github.com/murathany7/reel-studio">GitHub</a> ·
<a href="https://github.com/murathany7/reel-studio/issues/new?template=show-your-reel.yml">Show your reel</a> ·
<a href="https://github.com/murathany7/reel-studio/discussions">Discussions</a> ·
MIT licence</p>
