hyperion-reels
Horosheff · Horosheff/hyperion-reels
Plugin Cursor này sử dụng hơn 20 subagent, Whisper và FFmpeg để tự động cắt các video dài thành các clip ngắn dọc cho mạng xã hội.
Hyperion — công cụ cắt ghép Shorts/Reels bằng subagent: hơn 20 agent Cursor, Whisper, FFmpeg, 4 chế độ chỉnh sửa, bàn xuất bản và xuất bản song song lên YouTube, Instagram, TikTok, VK, RuTube và Zen.
Xem trước
Bạn có thể làm gì với nó
- Tự động tạo YouTube Shorts từ các buổi webinar.
- Chuyển đổi podcast thành Instagram Reels.
- Sản xuất video TikTok từ các cảnh quay talking head.
Kiểm tra an toàn
Không thấy dấu hiệu rủi ro trong các file đã quét.
Quét tự động các file trong repo. Luôn xem lại code trước khi chạy.
Trích từ README
Гиперион
Субагентская система для нарезки Shorts / Reels · режимы монтажа · publish desk · YouTube · Instagram · TikTok · VK · RuTube · Дзен
Гиперион · 20+ субагентов · Cursor Agent · Whisper · FFmpeg · обложки · параллельная публикация
Что это
Гиперион (hyperion) — плагин для Cursor, который превращает длинное видео (вебинар, эфир, урок, подкаст, talking head) в набор вертикальных клипов для YouTube Shorts / Instagram Reels / TikTok / Telegram / VK / Дзен.
Система не режет «по таймеру». Субагенты понимают речь, выбирают законченные мысли в диапазоне min–max из UI (например 30–90 с), отбраковывают слабое, уточняют границы и только потом режут, субтитруют и упаковывают.
Что нового в 0.4.8
| Возможность | Суть |
|---|---|
| Чёткость Q1 | Все даунскейлы — scale:flags=lanczos + лёгкий unsharp после кадрирования: картинка перестаёт «мылить» |
| Цвет Q2 | HDR-исходники (iPhone smpte2084/HLG) — zscale+tonemap=hable → bt709, больше никакой «серой» картинки; SDR — лёгкий грейд |
| Encode-полировка | level 5.1 (4.1 ломал 1080×1920@60), потолок битрейта 12M/24M release, fps-cap 60 для slow-mo источников |
| Отключаемо | VIDEOSHORTS_SHARPEN=0, VIDEOSHORTS_COLOR_GRADE=0 |
Что нового в 0.4.7
| Возможность | Суть |
|---|---|
| Логи в файл | scripts/vs_logging.py: каждый ключевой скрипт пишет videoshorts-memory/logs/<script>.log (ротация 3×2 МБ), crash-traceback больше не теряется; VIDEOSHORTS_LOG_LEVEL / VIDEOSHORTS_LOG_DIR |
| Лимиты API платформ | validate metadata отклоняет заведомо непроходящие поля: YouTube title 100 / description 5000 / tags 500, Instagram/TikTok caption 2200, Telegram caption 1024, VK/RuTube title 100 |
| Data-flow контракты | docs/DATA-FLOW.md: входы/выходы каждого субагента, гейты, все env-ручки в одной таблице |
| P1-остатки | Таймаут стадий run_pipeline.py, атомарная запись pipeline-fix-queue.md |
| Тесты | 54 юнит-теста: json_store, UI security, лимиты метаданных, agent_gate, vs_logging |
Что нового в 0.4.6
| Возможность | Суть |
|---|---|
| Атомарные JSON | scripts/json_store.py: tmp + os.replace + межпроцессный lock — publish-queue.json, latest-results.json, run-status.json больше не бьются при параллельной публикации |
| Security UI bridge | Path confinement /ui/ → ui/ только, denylist secrets/.env/.git, same-origin CSRF gate на POST, CORS вместо * — echo только localhost-Origin |
| Таймауты везде | ffmpeg/whisper/Playwright publish/login больше не висят вечно: VIDEOSHORTS_FFMPEG_TIMEOUT, VIDEOSHORTS_WHISPER_TIMEOUT, VIDEOSHORTS_PUBLISH_TIMEOUT, VIDEOSHORTS_PUBLISH_CLIENT_TIMEOUT, VIDEOSHORTS_LOGIN_TIMEOUT + stderr tail в логах |
| Playwright в deps | ensure_dependencies.py проверяет и ставит playwright + chromium браузер |
| Editorial-bundle gate | boundary-refiner и cutter обязаны прогонять validate_agent_artifacts.py editorial-bundle перед резкой |
Что нового в 0.4.5
| Возможность | Суть |
|---|---|
| YouTube Shorts | Playwright Studio: recommended hashtags, теги Shift+Enter, плейлист, Public |
| Instagram Reels | Playwright Reels без Windows file dialog |
| Мультипубликация | Results UI: галочки → все платформы стартуют параллельно |
| TikTok / VK / RuTube / Дзен | Встроенные Playwright-клиенты в том же «Опубликовать по галочкам» |
| 4 режима монтажа | Обычный · Вебинар · Подкаст · Продажи |
| Slim Agent P0 | Решения пишет агент (decision_source=agent), не эвристика |
| Длина клипов из brief | clip_count / min_sec / max_sec — spread short/mid/long |
| Publish desk | Results UI → галочки → обложки → очередь READY_TO_PUBLISH |
| UI Гиперион | Локальный bridge http://127.0.0.1:8765/ — загрузка, параметры, результаты |
20+ субагентов работают как монтажная студия: intake, transcriber, editor, boundary-refiner, cutter, guardian, metadata, packager, cover-writer, publish-prep и другие.
Кнопки
Схема работы
flowchart LR
A[📹 Длинное видео] --> B[🧠 Whisper + смысл]
B --> C[✂️ Редакция субагентов]
C --> D[🎬 Монтаж 9:16 · 4 режима]
D --> E[🔤 Субтитры]
E --> F[✅ Guardian QA]
F --> G[📝 SEO titles]
G --> H[📦 Publish bundle]
H --> I[☑️ Выбор клипов]
I --> J[🖼 Обложки + очередь]
J --> K[🚀 YouTube / IG / TikTok / VK / RuTube / Дзен]
Подробная схема: docs/ARCHITECTURE.md
Роли агентов: docs/AGENTS.md
Публикация (SEO → галочки → обложки → очередь → параллельный publish): docs/PUBLISH.md
Монитор Playwright (по умолчанию №1 = правый): docs/PLAYWRIGHT-DISPLAY.md
Пайплайн одной строкой
Intake → Whisper → Cleanup∥Candidates → Moments → Editor
→ Boundary(+montage) → Cutter(+loudnorm, layout) → Subtitles∥Metadata
→ Burn → Guardian → Packager → Results UI → Covers → Publish queue
→ YouTube∥Instagram∥TikTok∥VK∥RuTube∥Дзен
Slim P0: scorekeeper / virality / dramaturg / audio-polisher / post-render — внутри editor / boundary / cutter / guardian (отдельные Task только для ремонта).
⚡ Быстрая установка
Windows (рекомендуется)
git clone https://github.com/Horosheff/hyperion-reels.git
cd hyperion-reels
.\bootstrap-videoshorts.ps1
.\install-plugin.ps1
Затем перезапустите Cursor.
Полная инструкция без ошибок (для людей и для нейросетей):
👉 docs/INSTALL.md
Что делает bootstrap
| Шаг | Действие |
|---|---|
| 1 | Проверяет Python 3.10+ |
| 2 | Ставит pip-зависимости (faster-whisper, OpenCV, MediaPipe…) |
| 3 | Пытается установить FFmpeg (winget install Gyan.FFmpeg) |
| 4 | Пишет отчёт videoshorts-memory/dependencies-report.json |