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 链接——然后用 Claude Code 或 Codex 智能体组成的 AI 团队,规划、制作并审校一部同风格的全新 2D 动画视频。
这是托管服务,还是在我自己的电脑上运行?它是你自己运行的本地应用:由 Node.js Web 服务器加上你自己的 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 绘制引擎:矢量/动态图形、手绘水彩、蜡笔绘本、像素艺术、剪纸定格动画、白板涂鸦和赛璐璐动画。如果参考视频与哪一种都不匹配,它会挑选最接近的引擎并提出新的风格。
多智能体审校流程是怎么运作的?最多 6 个 AI 智能体分担视频不同部分的工作,每个完成的镜头都由与制作者不同的另一个智能体检查。修复必须附上修改前后的截图,以便审校者核实。
它会复用参考视频中的画面或角色吗?不会。ReelMimic 只从参考中学习技法——节奏、构图、转场、色彩——绝不复用原始画面、角色、标志或素材。它创造的角色都是原创的,除非你提供自己的设计。
我需要 Anthropic 或 OpenAI 的 API 密钥吗?AI 本身不需要单独的 API 密钥——ReelMimic 通过你已登录的 Claude Code 或 Codex 账号/套餐运行,用量计入该套餐。如果需要额外的语音或图库素材,你可以在 secrets.json 中添加 YATINGKEY 或 PIXABAYKEY 等可选密钥。
Creator
edenfunf
Size
42.5 MB
Stars
3.6K
Updated
CommitOct 16
Age
20d
Commits · 90 Days