Show it a video you love. Get a new video in the same style. An AI crew (Claude Code or Codex) plans, builds and reviews it with you.
JavaScript 2d-animationai-agentsai-videoanimationclaude-codecodexmulti-agentstyle-transfervideo-generation
// Checks everything ReelMimic needs and says how to fix what's missing. npm run doctor
// Plain JavaScript on purpose: it must run (and say "upgrade Node") even on a Node too old to run the TypeScript server.
// @ts-check
import { execFileSync } from 'node:child_process';
import { existsSync, readFileSync, statfsSync } from 'node:fs';
import { homedir, platform } from 'node:os';
import { join } from 'node:path';
// The server runs its TypeScript directly (Node's built-in type stripping, on by default from 22.18).
const [major, minor] = process.versions.node.split('.').map(Number);
if (major < 22 || (major === 22 && minor < 18)) { console.log(`
[31m✗[0m Node ${process.versions.node}: ReelMimic needs Node 22.18 or newer
→ https://nodejs.org
`); process.exit(1); }
await import('../server/env.ts'); // same secrets and Python choice as the server
const IS_WIN = platform() === 'win32';
/** @param {string} m */
const ok = (m) => console.log(` \x1b[32m✓\x1b[0m ${m}`);
/** @param {string} m @param {string} [fix] */
const bad = (m, fix) => { console.log(` \x1b[31m✗\x1b[0m ${m}${fix ? `\n → ${fix}` : ''}`); failed++; };
/** @param {string} m @param {string} [fix] */
const opt = (m, fix) => console.log(` \x1b[33m○\x1b[0m ${m}${fix ? ` (${fix})` : ''}`);
let failed = 0;
// .cmd shims (claude, codex, npx) need a shell on Windows; real executables must not go through one (it would split `-c "import x"`)
/** @param {string} cmd @param {string[]} args */
const run = (cmd, args, shell = IS_WIN && !/python|ffmpeg|ffprobe|blender/i.test(cmd)) => { try { return execFileSync(cmd, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], shell, timeout: 20000 }).trim(); } catch { return null; } };
const PY = process.env.PYTHON || 'python';
console.log('\nReelMimic — environment check\n');
console.log('Core');
ok(`Node ${process.versions.node}`);
// env.ts only sets PYTHON for a 3.10+ interpreter; the 'python' fallback may be older, so check the version here too
const pyv = run(PY, ['-c', 'import sys; assert sys.version_info >= (3, 10); print("Python", sys.version.split()[0])']);
pyv ? ok(pyv) : bad('Python 3.10+ not found', 'install Python 3.10 or newer, or set PYTHON=/path/to/python');
const ff = run('ffmpeg', ['-version']);
const ffDir = process.env.FFMPEG_DIR && existsSync(join(process.env.FFMPEG_DIR, IS_WIN ? 'ffmpeg.exe' : 'ffmpeg'));
ff || ffDir ? ok(`FFmpeg ${(ff || '').split('\n')[0].split(' ')[2] || `(FFMPEG_DIR)`}`) : bad('FFmpeg not found', 'install FFmpeg and put it on PATH, or set FFMPEG_DIR');
// analyze.py, motion_check.py and align_lyrics.py read duration, size and frame rate with ffprobe
const fp = run('ffprobe', ['-version']);
const fpDir = process.env.FFMPEG_DIR && existsSync(join(process.env.FFMPEG_DIR, IS_WIN ? 'ffprobe.exe' : 'ffprobe'));
fp || fpDir ? ok(`ffprobe ${(fp || '').split('\n')[0].split(' ')[2] || `(FFMPEG_DIR)`}`) : bad('ffprobe not found (reads video length, size and frame rate)', 'it ships with FFmpeg: put it on PATH, or set FFMPEG_DIR to the folder holding both');
const chromes = [process.env.CHROME_PATH, 'C:/Program Files/Google/Chrome/Application/chrome.exe', 'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser'].filter(/** @returns {p is string} */ (p) => !!p);
const chrome = chromes.find((p) => existsSync(p));
chrome ? ok(`Chrome ${chrome}`) : bad('Chrome/Chromium not found (renders frames headlessly)', 'install Chrome, or set CHROME_PATH');
console.log('\nPython packages');
const mods = [['numpy', 'numpy'], ['cv2', 'opencv-python'], ['scenedetect', 'scenedetect'], ['librosa', 'librosa'], ['PIL', 'Pillow'], ['yt_dlp', 'yt-dlp']];
const optMods = [['faster_whisper', 'faster-whisper', 'lyrics auto-timing'], ['opencc', 'opencc-python-reimplemented', 'lyrics simplified→traditional']];
if (pyv) {
const probe = (/** @type {string} */ m) => run(PY, ['-c', `import ${m}`]) !== null;
for (const [m, pkg] of mods) probe(m) ? ok(pkg) : bad(pkg, `${PY} -m pip install -r requirements.txt`);
for (const [m, pkg, why] of optMods) probe(m) ? ok(pkg) : opt(`${pkg} not installed`, why);
}
// Renders write frames, previews and the encode next to the projects: a real run got down to 66 MB free mid-production.
try {
const f = statfsSync(join(import.meta.dirname, '..', '..')), gb = (f.bavail * f.bsize) / 2 ** 30;
gb >= 5 ? ok(`Disk: ${gb.toFixed(0)} GB free`) : bad(`Disk: only ${gb.toFixed(1)} GB free`, 'free at least 5 GB before making a video (old projects/*/build/out/frames can go)');
} catch { /* statfs unsupported */ }
console.log('\nAI director (at least one)');
const claude = run('claude', ['--version']);
const codexBin = process.env.CODEX_BIN || 'codex';
const codex = run(codexBin, ['--version']);
claude ? ok(`Claude Code ${claude}`) : opt('Claude Code CLI not found', 'npm i -g @anthropic-ai/claude-code, then run `claude` once to log in');
codex ? ok(`Codex ${codex}`) : opt('Codex CLI not found', 'npm i -g @openai/codex, then `codex login`');
if (!claude && !codex) bad('no agent CLI available', 'install Claude Code or Codex (see above)');
console.log('\nOptional');
const secretsPath = [join(homedir(), '.reelmimic', 'secrets.json'), join(homedir(), '.clone-studio', 'secrets.json')].find((p) => existsSync(p)) || join(homedir(), '.reelmimic', 'secrets.json');
/** @type {Record<string, unknown>} */
let secrets = {};
try { secrets = JSON.parse(readFileSync(secretsPath, 'utf8')); } catch {}
const has = (/** @type {string} */ k) => process.env[k] || secrets[k];
has('YATING_KEY') ? ok('YATING_KEY (Taiwan TTS voices)') : opt('YATING_KEY not set', `natural Taiwan Mandarin narration; put it in ${secretsPath}`);
has('PIXABAY_KEY') ? ok('PIXABAY_KEY') : opt('PIXABAY_KEY not set', 'more stock images/music; Openverse works without a key');
has('FREESOUND_KEY') ? ok('FREESOUND_KEY') : opt('FREESOUND_KEY not set', 'more sound effects');
const blenderEnv = process.env.BLENDER;
run('blender', ['--version']) || (blenderEnv && existsSync(blenderEnv)) ? ok('Blender (3D track)')
: opt(blenderEnv ? `BLENDER points to a missing file: ${blenderEnv}` : 'Blender not found', 'only needed for the paused 3D product track');
run('npx', ['--no-install', 'hyperframes', '--version']) ? ok('hyperframes CLI cached') : opt('hyperframes CLI not cached yet', 'downloaded automatically by npx on first use');
console.log(failed ? `\n${failed} required item(s) missing.\n` : '\nAll required items present. Start with: npm start\n');
process.exit(failed ? 1 : 0);