Skip to content

HelpFreedom/kadr

Repository files navigation

Kadr

ИИ-нативный видеоредактор с GPU-ускорением — и с Claude Code прямо в таймлайне.

English version → · Полное руководство по функциям → · Video →

Демо Kadr

Kadr — многодорожечный видеоредактор (Electron + React + TypeScript), построенный вокруг одной идеи: ИИ-агент должен монтировать видео рядом с вами, на том же таймлайне, теми же инструментами. Нажмите 🤖, напишите «добавь сюда анимированные субтитры» — и смотрите, как это происходит вживую в превью.

Возможности

  • 🎬 Полноценный многодорожечный монтаж — видео/аудио/текстовые дорожки, трим, скорость, луп, фейды, связанные AV-клипы, полная история отмен.
  • GPU-композитинг (WebGL2) — превью и есть рендер: один и тот же компоновщик рисует оба, экспорт пиксель-в-пиксель WYSIWYG.
  • 🔑 Ключевые кадры везде — позиция, масштаб, поворот, прозрачность, громкость, маски; рабочий процесс в стиле After Effects.
  • 🧊 Настоящее 3D — наклоны и глубина клипа, «полёт камеры» целой дорожкой, перспективно-корректные текстуры.
  • 🎭 Маски — анимируемые кромки + до 8 фигур с растушёвкой (прямоугольник/эллипс/треугольник, инверсия).
  • 🌫️ Дымное внешнее сияние — не плоский ореол: клубы billow-шума, рваные щупальца, уносящиеся искры; всё параметрично и идентично в превью и рендере.
  • 🔀 26 переходов — 14 переходов наложения (Vegas-стиль: просто перекройте два клипа) и 12 кинематографичных торцевых (вип-паны, зум-блюры, RGB-расхождение, глитч…) со спектральным смазом.
  • 🗣️ Локальное распознавание речи — faster-whisper (large-v3) с пословными таймкодами и серьёзной защитой от галлюцинаций (чистый тон обязан дать ноль реплик — закреплено тестами). Редактор SRT/TXT встроен.
  • Авто-субтитры — один диалог: распознавание → анимированные караоке-титры (пословная подсветка, появления поп/подъём/фейд); позиция и размер — мышью прямо в превью.
  • ⚛️ Remotion-фрагменты — программируемая моушн-графика (React/TSX) как клипы таймлайна. Живое превью с hot reload (никаких рендеров во время итераций!), автоматический режим захвата пикселей для GL-эффектов, 3D и переходов на фрагменте, и ровно один настоящий рендер при экспорте (кэш по хешу содержимого).
  • 🤖 Встроенный Claude Code — настоящая интерактивная сессия Claude в терминальной панели, подключённая к живому проекту через MCP: читает таймлайн, правит клипы, транскрибирует, создаёт и дорабатывает Remotion-фрагменты, пока вы смотрите превью.
  • 📤 Быстрый и бережный экспорт — аппаратное кодирование WebCodecs, быстрый декод на mp4box (~8× быстрее перемоток, с автоматическим откатом), 8-сэмпловый motion blur, frame blending для исходников с «чужим» fps, пресеты YouTube/Shorts/WebM/MP3.
  • 🛟 Забота о работе — фоновые 540p-прокси для превью, автосохранение раз в 5 минут (атомарное, не мешает рендеру и ИИ-сессиям), пресеты эффектов и поз, общие для всех проектов, интерфейс RU/EN.

Требования

Компонент Для чего Примечание
Node.js ≥ 20 всё
ffmpeg + ffprobe импорт, аудиомикс, экспорт любая свежая сборка в PATH
python3 + faster-whisper распознавание речи, авто-субтитры pip install faster-whisper; модели скачаются при первом запуске
Claude Code CLI панель 🤖 опционально; использует ваш существующий вход
сеть (один раз) workspace Remotion-фрагментов ~/kadr-fragments, ~150 МБ

Запуск

git clone https://github.com/HelpFreedom/kadr.git && cd kadr
npm install        # postinstall пересоберёт node-pty под Electron
npm run dev

Импортируйте медиа, монтируйте, жмите «Экспорт». Для ИИ-ассистента нажмите 🤖 (CLI claude должен быть установлен и залогинен). Если для Claude/npm нужен прокси — создайте ~/.config/kadr/claude-env.json:

{ "env": { "HTTPS_PROXY": "http://127.0.0.1:1080", "NO_PROXY": "127.0.0.1,localhost" } }

Как устроена ИИ-интеграция

Kadr поднимает локальный мост в рендерер и отдаёт Claude MCP-сервер с пятью инструментами:

Инструмент Что делает
kadr_state весь живой проект: дорожки, клипы, пути медиа, транскрипты, пресеты
kadr_eval выполнить JS против API редактора (каждая правка — в истории отмен)
kadr_export отрендерить проект или диапазон и дождаться файла
kadr_transcribe локальный Whisper по файлу или диапазону таймлайна
kadr_fragment_create создать Remotion-композицию как клип таймлайна

Главный цикл: Claude создаёт фрагмент, правит его TSX обычными файловыми инструментами — vite горячо перезагружает превью за ~2 секунды. Вы даёте правки обычным языком; рендер один — финальный.

Тесты

E2E-тесты управляют настоящим приложением через Chrome DevTools Protocol:

npx electron-vite dev -- --remote-debugging-port=9777   # терминал 1
node scripts/e2e13.mjs                                  # терминал 2 (и т. д.)

Покрыто: переходы, сияние, пресеты, прокси, точность экспорта (PSNR быстрого пути против отката), motion blur, каденс frame blending, MCP-мост, антигаллюцинационный контракт транскрипции, фрагменты и режим захвата, семантика автосохранения, авто-субтитры.

Документация

  • FEATURES.md — полное руководство по функциям (1200+ строк).
  • CLAUDE.md — карта архитектуры (её же читает Claude Code).

Лицензия

GPL-3.0

About

AI-native GPU-accelerated video editor with Claude Code built into the timeline

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors