reelmimic README

The project's README from github.com/edenfunf/reelmimic. As one markdown file: README.md.

ReelMimic

ReelMimic

Show it a video you love. Get a new video in the same style.

License: MIT Claude Code Codex CLI Node 22.18+ Python 3.10+

English · 繁體中文 · 简体中文

Sugar Rush Sunshine Boy Bath Time
Sugar Rush
music video · hand-painted · 58 s
Sunshine Boy
music video · hand-painted · 63 s
Bath Time
narrated comic · 30 s

Each one made with ReelMimic from a reference video and a one-line brief. Previews are silent, with the lyrics cropped out.

What is this?

Ever watched a video and thought "I want one in that style, but completely my own"?

Just drop it into ReelMimic. A file, a phone recording or a YouTube link all work. Then tell it what you want to make.

First it takes the reference apart: editing rhythm, shot lengths, transitions, framing, colors and camera moves. Then it puts together a plan for you to check. You can chat right next to it, change settings or add assets, and start when you're happy.

Once production starts, the work is split across several AI agents. Different parts of the video are made at the same time, and every shot is handed to a different agent to check. If something's wrong it goes back to be fixed, so it's not a one-shot generate-and-done.

ReelMimic learns how the reference was made. It doesn't carry over the original footage, characters or assets.

The whole thing runs on your own computer, with your own Claude Code or Codex.

ReelMimic home page

How ReelMimic works

What it does

Good to know

Roadmap

Getting started

You'll need Node.js 22.18+, Python 3.10+, FFmpeg, Chrome, and either Claude Code or Codex CLI (logged in).

git clone https://github.com/edenfunf/reelmimic.git && cd reelmimic
./install.sh      # on Windows, double-click install.bat
./start.sh        # on Windows, double-click start.bat

Then open http://localhost:4318. The install script checks your setup and tells you if anything's missing. You can run the check again any time with cd app && npm run doctor. Claude Code picks up the skills in this repo on its own, and Codex reads AGENTS.md, so there's nothing else to set up.

Your first video

  1. On the home page, drop in a reference video or paste a link, say what you want, and pick Claude Code or Codex.
  2. Wait for the breakdown and the plan. If you want changes, say so in the chat on the right. Screenshots work too.
  3. If the plan asks you for something (lyrics, say), add it or skip it, then hit Approve and start.
  4. The Production line tab shows where each character and each part of the video is, with the review screenshots.
  5. When it's done, leave a note at whatever second looks off.

Settings

API keys and a few paths go in ~/.reelmimic/secrets.json. That file lives outside the repo, so it never gets committed. See secrets.example.json for the format.

Key What it's for
YATING_KEY Yating's Taiwanese Mandarin voices, for narration
PIXABAY_KEY, FREESOUND_KEY More images, music and sound effects you're allowed to use (optional, Openverse works without a key)
FFMPEG_DIR, CHROME_PATH, CODEX_BIN, PYTHON Where to find these tools if they're not on your PATH
CODEX_SANDBOX Codex sandbox mode (default danger-full-access, like Claude Code with Bash allowed; workspace-write blocks the Chrome renderer)
BUILDERS, MAX_AGENTS How many agents work on one video at once (default 6), and the limit across all projects (default 12)
PORT Web port (default 4318)

Docs

Ground rules

License

The code is MIT. Third-party skills and assets bundled here keep their own licenses, listed in THIRD_PARTY_NOTICES.md.

reelmimic (edenfunf/reelmimic)

Searching Database…

Что это?ReelMimic смотрит на референсное видео, которое вам нравится, — файл, съёмку с телефона или ссылку на YouTube — и с помощью AI-команды из агентов Claude Code или Codex планирует, создаёт и проверяет совершенно новый 2D-анимационный ролик в том же стиле.
Это хостинговый сервис или он работает на моей машине?Это локальное приложение, которое вы запускаете сами: всю работу выполняют веб-сервер на Node.js плюс ваш собственный аккаунт Claude Code или Codex — без облачного бэкенда и SaaS-хостинга.
Как создать первое видео?На главной странице вы добавляете референсное видео или вставляете ссылку, описываете желаемое и выбираете Claude Code или Codex. Затем вы просматриваете и обсуждаете сгенерированный план до одобрения производства и следите за прогрессом каждого кадра во вкладке Production line.
Что мне нужно установить перед началом?Понадобятся Node.js 22.18 или новее, Python 3.10+, FFmpeg, Chrome и залогиненный Claude Code или Codex CLI. Входящий в комплект установочный скрипт проверит вашу систему и укажет на недостающее.
Сколько времени занимает рендер видео?Клип на 30-60 секунд после одобрения плана обычно занимает от 1 до 3,5 часов, причём стили акварели и восковых мелков самые медленные, поскольку каждый кадр рисуется кистями вручную. Работа идёт через ваш собственный тариф Claude Code или Codex, поэтому расходуется лимит использования этого аккаунта.
Он работает на macOS и Linux или только на Windows?В принципе он кроссплатформенный, но пока тестировался в основном на Windows; macOS и Linux должны работать, хотя реальных проверок на них было меньше.
Какие стили анимации он умеет создавать?Семь 2D-движков рисования: векторная/motion-графика, рисованная акварель, книжка восковыми мелками, пиксель-арт, бумажная перекладка в духе stop-motion, дудл по белой доске и аниме-целл. Если референс не подходит ни под один из них, выбирается ближайший движок и предлагается новый стиль.
Как устроен процесс мультиагентного ревью?До 6 AI-агентов делят работу над разными частями видео, и каждый готовый кадр проверяет другой агент, а не тот, кто его делал. Исправления должны прилагать скриншоты «до и после», чтобы ревьюер мог их проверить.
Он переиспользует кадры или персонажей из референсного видео?Нет. ReelMimic учится у референса только технике — темпу, кадрированию, переходам, цвету, — но никогда не берёт исходные кадры, персонажей, логотипы или ассеты. Созданные им персонажи оригинальны, если только вы не предоставите собственные дизайны.
Нужен ли мне API-ключ Anthropic или OpenAI?Отдельный API-ключ для самого AI не нужен — ReelMimic работает через ваш уже залогиненный аккаунт/тариф Claude Code или Codex, поэтому использование идёт в счёт этого тарифа. При желании можно добавить опциональные ключи вроде YATINGKEY или PIXABAYKEY в secrets.json — для дополнительных голосов или стоковых ассетов.
Creator
edenfunf
Size
42.5 MB
Stars
3.4K
Updated
CommitOct 16
Age
19d
Commits · 90 Days