Skip to content

Latest commit

 

History

History
213 lines (140 loc) · 19.2 KB

File metadata and controls

213 lines (140 loc) · 19.2 KB
AutoClip

AutoClip

Превращайте длинные видео в моменты, которыми хочется поделиться.

简体中文 · English · 日本語 · 한국어 · Español · Português · Русский · Français

GitHub release GitHub stars GitHub forks GitHub issues License: MIT

Сайт проекта · Discussions · Сообщить о проблеме

Установщики приложения: macOS · Apple Silicon · Windows · x64

Установка и первые клипы (English) · Полное руководство по устранению неполадок (английский)

Начиная с v1.3.1, приложение, сайт и README доступны на китайском, английском, японском, корейском, испанском, португальском, русском и французском языках. Выберите язык в верхней панели или используйте язык системы. Язык ваших материалов и созданного контента не меняется.

AutoClip с помощью ИИ анализирует субтитры, находит яркие моменты, придумывает заголовки и автоматически создаёт клипы и подборки. Подходит для интервью, подкастов, лекций и записей трансляций. Доступны настольное приложение, веб-интерфейс через Docker и CLI / MCP.

Интерфейс приложения

AutoClip v1.3.0 — local video import

Реальный веб-интерфейс v1.3.0: добавьте локальное видео в области импорта и при необходимости субтитры SRT.

Признание сообщества

AutoClip — GitHub Trending AutoClip — Trendshift Python daily ranking AutoClip — Trendshift daily ranking, all languages

Эти значки предоставляет Trendshift. Нажмите на них, чтобы посмотреть достижения AutoClip. GitHub Trending и Trendshift — разные рейтинги; значки показывают зафиксированные достижения, а не текущую позицию.

Возможности

Возможность Описание
Импорт видео Локальные файлы, ссылки YouTube и Bilibili, а также необязательные субтитры SRT.
Поиск ярких моментов Создание плана, временных интервалов по темам, оценок фрагментов и заголовков на основе субтитров.
Клипы и подборки Автоматическое создание клипов и рекомендуемых подборок с ручным изменением порядка.
Публикация (v1.3.2) Когда клипы готовы, откройте «Публикация» у клипа. Доступно в v1.3.2. Зарубежные площадки — те, что подключены в вашем собственном аккаунте Upload-Post: TikTok, Instagram, YouTube, Facebook, LinkedIn, X, Threads, Pinterest, Bluesky, Discord, Telegram и Google Business, по факту подключения. Bilibili — один аккаунт: один раз вставьте Cookie в настройках. Нужны SESSDATA, bili_jct и DedeUserID. Можно отправить сейчас или по расписанию. Заголовок и описание необязательны и по умолчанию берутся из названия клипа. Вшитые субтитры включены по умолчанию, как и титульная карточка примерно на 4 секунды. Видимость по умолчанию — только я / private там, где площадка это поддерживает. AutoClip обещает это только для TikTok, YouTube и Bilibili. Файл можно скачать без публикации. На странице проекта есть история и календарь, а ещё отмена расписания, которое ещё не вышло. «Составить неделю» только для зарубежных площадок: понедельник, среда и пятница в 09:00, без Bilibili. Вертикальные аккаунты рендерятся в 9:16 без обрезки до 60 секунд. Только Bilibili — альбомная ориентация. Только LinkedIn или X — исходный кадр. Вертикаль и Bilibili в одной отправке рендерятся по отдельности.
Автообложка (v1.3.2) При публикации обложку можно создать автоматически, чтобы Bilibili не отклонил пустую обложку. Подробности обложки и титульной карточки по умолчанию — в пояснении к установщику этого выпуска. Доступно в v1.3.2.
Экспорт для публикации Профили Douyin, Xiaohongshu, YouTube Shorts и Bilibili, вшитые субтитры и титульные карточки.
Выбор моделей Qwen, OpenAI-совместимые API, Gemini, SiliconFlow и локальные модели через Ollama / LM Studio.
Автоматизация Организация запусков через CLI или вызов того же конвейера обработки из клиента MCP.

Импорт видео → Субтитры / распознавание речи → Анализ и оценка ИИ → Клипы и подборки → Экспорт

Быстрый старт

1. Настольное приложение

Скачайте подходящий установщик из GitHub Releases:

Платформа Установка
macOS · Apple Silicon .dmg
Windows 10 / 11 · x64 -setup.exe
Intel Mac / Linux Используйте Docker или CLI ниже

Установщики включают Python и FFmpeg. Доступные платформы и порядок первого запуска указаны в соответствующем релизе. После установки выберите провайдера модели в настройках, проверьте соединение, сохраните настройки и импортируйте видео.

2. Docker / Web

Требуются Docker и Docker Compose v2. Выполняйте команды из корня репозитория:

git clone https://github.com/zhouxiaoka/autoclip.git
cd autoclip
cp env.example .env

Перед запуском отредактируйте .env: задайте LLM_PROVIDER, соответствующий API-ключ и имя модели. Провайдера также можно настроить в интерфейсе после запуска.

mkdir -p data logs uploads
docker compose up -d --build

Откройте веб-интерфейс. Документация API доступна после запуска сервера. Подробности — в руководстве по Docker на китайском языке.

Если в Linux возникают ошибки доступа к примонтированным каталогам, исправьте владельца каталогов данных проекта следующей командой и снова запустите сервисы:

docker compose run --rm --no-deps --user root --entrypoint sh autoclip -c 'chown -R autoclip:autoclip /app/data /app/logs /app/uploads'
docker compose up -d

3. CLI / MCP

Нужны Python 3.10+ (рекомендуется 3.11) и FFmpeg в PATH. Пример рассчитан на оболочку macOS / Linux; в Windows PowerShell активируйте окружение командой venv\Scripts\Activate.ps1. Для локальной обработки через CLI Redis не требуется.

git clone https://github.com/zhouxiaoka/autoclip.git
cd autoclip
python3 -m venv venv
source venv/bin/activate
python -m pip install -r requirements.txt
python -m pip install -e .

Пример с локальной моделью: установите и запустите Ollama, затем скачайте модель. Для видео без субтитров нужен faster-whisper; речевая модель загружается при первом использовании. Для готовых субтитров добавьте --srt talk.srt.

ollama pull qwen2.5:7b
python -m pip install faster-whisper
autoclip doctor --provider ollama
autoclip run talk.mp4 --provider ollama --json

Замените PROJECT_ID на идентификатор проекта из результата обработки, чтобы экспортировать видео для Shorts. Команда autoclip mcp запускает MCP-сервер через stdio:

autoclip export PROJECT_ID --preset shorts
autoclip mcp

В клиенте MCP укажите абсолютный путь к autoclip в виртуальном окружении в поле command, а ["mcp"] — в поле args. См. руководство по CLI / MCP и навык для агентов на китайском языке.

Настройка моделей

Вариант Настройка
Облачные модели Выберите Qwen, OpenAI-совместимый API, Gemini или SiliconFlow и введите API-ключ. Для совместимых сервисов можно задать Base URL.
Ollama Адрес по умолчанию: http://localhost:11434/v1; модель: qwen2.5:7b. API-ключ не нужен.
LM Studio Загрузите модель и запустите Local Server, по умолчанию на http://localhost:1234/v1. Выберите модель, доступную на вашем сервере.

В Docker адрес localhost указывает на сам контейнер. Для доступа к модели на хосте задайте адрес, доступный из контейнера; см. руководство по CLI / MCP. Нарезка видео выполняется локально, но при анализе облачной моделью текст субтитров отправляется выбранному провайдеру. Для скачивания видео и моделей нужен интернет.

Частые вопросы

Это бесплатно? Нужен API-ключ?

Сам AutoClip по-прежнему бесплатен и открыт по лицензии MIT. Облачные провайдеры взимают плату за использование моделей и требуют ваш API-ключ. Для Ollama / LM Studio облачный ключ не нужен, но необходимы модели и подходящее оборудование. С v1.3.2 зарубежная отправка требует ваш собственный аккаунт Upload-Post. Бесплатные и платные тарифы, а также дневные лимиты TikTok, YouTube, Instagram и других площадок, берутся со страниц самого Upload-Post. Это не обещания AutoClip.

Мои видео загружаются на сервер?

Монтаж остаётся на вашем устройстве. Облачной модели отправляется текст субтитров. Готовый клип покидает компьютер только после нажатия «Публикация» и только на подключённые площадки. Его также можно скачать без публикации. Эта страница доступна в v1.3.2. Статистика и отчёты об ошибках зависят от версии и настроек; см. сведения о конфиденциальности.

Можно работать без субтитров?

Да, после установки локальных компонентов Whisper и речевой модели. Можно также импортировать готовый SRT. Точные субтитры помогают сократить ожидание и ошибки распознавания.

Почему клипы не созданы?

Проверьте этап сбоя: пустые субтитры, подключение к модели, слишком высокий порог оценки, FFmpeg и свободное место. Можно снизить порог с 0.7 до 0.5, но это не гарантирует создание клипов.

Какие видео подходят и сколько времени занимает обработка?

Анализ опирается на субтитры, поэтому подходят интервью, подкасты, лекции и речевые комментарии. Для визуального действия или музыки результат может быть ограничен. Время зависит от длительности, оборудования, модели и экспорта; начните с короткого образца.

Полное руководство по устранению неполадок (английский) · Известные проблемы

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

README доступен на восьми языках; подробные руководства ниже в основном написаны на китайском. Языки перевода README не определяют языки интерфейса приложения или моделей распознавания речи.

Участие и обратная связь

Приветствуются исправления, отзывы и улучшения переводов. В сообщении об ошибке укажите ОС, версию, модель, шаги воспроизведения и журналы ошибок без конфиденциальных данных.

Проект поддерживает один человек в свободное время. Срок ответа не фиксирован; мгновенная поддержка и индивидуальная помощь с развёртыванием не предоставляются. Перед обращением прочитайте FAQ и список известных проблем.

Идеи, сценарии и запросы моделей публикуйте в GitHub Discussions. Воспроизводимые ошибки оформляйте через шаблон issue. Правила доски: community board (на китайском).

Спасибо проектам FastAPI, React, Tauri, FFmpeg, yt-dlp, Whisper и всем участникам. Проект распространяется по лицензии MIT. Если AutoClip вам помогает, поддержите проект звездой.

Star History