ViralMint_presentation_ru

1.

GITHUB · OPEN SOURCE · AGPL-3.0
ViralMint
Локальный open-source видео-пайплайн для авторов контента
Установка · Настройка · Использование
Python 3.11+
FastAPI
github.com/openclaw-easy/ViralMint
React 18
Whisper
FFmpeg
yt-dlp

2.

ОБЗОР
Что такое ViralMint
ViralMint — это открытый (AGPL-3.0) локальный конвейер для создания вирусного
видео-контента. Он берёт на себя то, что авторы обычно делают вручную в
десятке вкладок и приложений: поиск трендовых роликов, их анализ, генерацию
Полный цикл
1
Scout — найти тренд
2
Analyze — разобрать, что сработало
3
Generate — создать своё видео
4
Clip Studio — нарезать шортсы
5
Publish — опубликовать на платформы
собственных видео и публикацию — всё в едином рабочем процессе.
Поиск трендов YouTube, TikTok, Douyin и 1800+ сайтов через yt-dlp
Локальный анализ Транскрибация и инсайты через Whisper и ИИ
Генерация видео Сценарий → озвучка → футаж → субтитры → музыка
Автопубликация Прямая загрузка на YouTube и TikTok
ViralMint · Установка и настройка
2

3.

КЛЮЧЕВЫЕ ПРЕИМУЩЕСТВА
Почему ViralMint
100% локально
BYOK — свои ключи
Агенты, а не чат-обёртка
SQLite, локальный Whisper, локальный FFmpeg.
Сценарии, транскрипты и видео никогда не
покидают ваш компьютер.
Anthropic / OpenAI / OpenRouter / YouTube /
Pexels. Ключи идут напрямую провайдеру,
сервера-посредника нет.
Шесть агентов — Planner, Scout, Download,
Analyzer, Generator, Uploader — реально
выполняют работу.
Публикует за вас
Управление с телефона
Бесплатно из коробки
Прямая загрузка на YouTube и TikTok с ИИзаголовками, описаниями, тегами и превью.
Двусторонний чат через Telegram, WhatsApp,
Discord или Slack, включая уведомления о
задачах.
Whisper, Edge TTS (400+ голосов), музыка, стоквидео и 18 FFmpeg-инструментов — без затрат.
ViralMint · Установка и настройка
3

4.

КАК ЭТО УСТРОЕНО
Архитектура системы
React 18 + MUI 7 SPA
Chat · Channels · Library · Clip Studio · Tools · Settings
HTTP + WebSocket
FastAPI · localhost:16888
Planner
Scout
Download
Analyzer
Generator
Uploader
Messaging: Telegram · WhatsApp · Discord · Slack
SQLite (локально)
storage/ на диске
Внешние API
Зашифрованные учётные данные
Видео, аудио, превью, эффекты
BYOK, обращение напрямую
ViralMint · Установка и настройка
4

5.

ПЕРЕД УСТАНОВКОЙ
Системные требования
Компонент
macOS
Linux
Windows
Python 3.11+
brew install python
apt install python3.11
python.org
Node.js 18+
brew install node
apt install nodejs npm
nodejs.org
FFmpeg
brew install ffmpeg
apt install ffmpeg
ffmpeg.org
ImageMagick
brew install imagemagick
apt install imagemagick
imagemagick.org
Все четыре компонента обязательны — без FFmpeg не будет ни субтитров, ни рендера, ни нарезки клипов.
ViralMint · Установка и настройка
5

6.

КЛОНИРОВАНИЕ И ОКРУЖЕНИЕ
Установка — шаг 1
git clone https://github.com/openclaw-easy/ViralMint.git
cd ViralMint
1. Скачайте исходный код репозитория
Команда git clone копирует весь проект (backend, frontend, docs, тесты) в папку ViralMint и сразу переходит в неё.
python -m venv venv && source venv/bin/activate
# Windows: venv\Scripts\activate
2. Создайте и активируйте виртуальное окружение Python
Изолирует зависимости ViralMint от остальной системы Python. На Windows команда активации другая — она указана в комментарии.
ViralMint · Установка и настройка
6

7.

ЗАВИСИМОСТИ, КЛЮЧИ И ЗАПУСК
Установка — шаг 2
pip install -r requirements.txt
cp .env.example .env
# необязательно — ключи можно задать и в UI
python run.py
3
Установите Python-зависимости
pip install -r requirements.txt подтягивает FastAPI, SQLAlchemy, faster-whisper, SDK Anthropic/OpenAI и другие пакеты backend'а.
4
Скопируйте файл окружения
.env.example → .env. Ключи API можно прописать здесь заранее, либо добавить позже прямо в веб-интерфейсе.
5
Запустите приложение
python run.py — единая точка входа: устанавливает зависимости фронтенда, собирает SPA, поднимает API и открывает браузер.
ViralMint · Установка и настройка
7

8.

ЧТО ПРОИСХОДИТ ПОСЛЕ PYTHON RUN.PY
Первый запуск
Автоматический старт
Устанавливает зависимости фронтенда (npm)
Собирает SPA (React + Vite)
Совет
Нет API-ключа? Не проблема.
Откройте Settings → AI Provider после запуска и вставьте
ключ Anthropic, OpenAI или OpenRouter.
Запускает FastAPI-сервер на localhost
Автоматически открывает браузер
Edge TTS, Whisper, FFmpeg и yt-dlp работают офлайн
вообще без какой-либо настройки — с них и можно
начать.
http://localhost:16888
Адрес, по которому доступен веб-интерфейс ViralMint — чат, библиотека, Clip
Studio, инструменты и настройки.
ViralMint · Установка и настройка
8

9.

НЕОБЯЗАТЕЛЬНЫЙ ШАГ
Сборка desktop-приложения
Если вместо команды в терминале вы хотите получить кликабельное приложение — соберите его из исходников через PyInstaller.
Браузер по-прежнему остаётся интерфейсом.
PYTHON_BIN=./venv/bin/python VIRALMINT_VERSION=0.1.0-dev \
bash desktop/scripts/build-app.sh
.dmg
.tar.gz
.zip
macOS
Linux (Ubuntu, Debian, Fedora)
Windows
Результат появится в desktop/release/. Первая сборка занимает ~10–15 минут (упаковка PyInstaller — самая долгая часть). Флаги пропуска шагов, переменные
подписи/нотаризации и сценарий smoke-теста описаны в desktop/README.md.
ViralMint · Установка и настройка
9

10.

BRING YOUR OWN KEYS
Настройка API-ключей (BYOK)
Каждый ключ задаётся в .env или в приложении в разделе Settings — что указано, то и используется. Ключи пользователя шифруются AES-256; посредника между
вами и провайдером нет.
Назначение
Провайдер
Где получить
Стоимость
ИИ-чат, сценарии, анализ
Anthropic / OpenAI / OpenRouter
Settings → AI Provider
Оплата по факту
Скаутинг YouTube
YouTube Data API v3
Settings → Service API Keys
10 000 ед./день бесплатно
Сток-видео
Pexels
pexels.com/api
Бесплатно
Премиум-озвучка
OpenAI TTS
platform.openai.com
Оплата по факту
Скаутинг TikTok / Douyin
TikHub API (рекомендуется)
tikhub.io
Есть бесплатный тариф
Загрузка на YouTube/TikTok
OAuth
В один клик в Settings
Бесплатно
⚠ Скаутинг TikTok/Douyin через cookie-сессию — резервный вариант в Settings, но он нарушает условия использования платформ. Используйте TikHub API, если не приняли этот
риск осознанно (подробности — в LEGAL.md).
ViralMint · Установка и настройка
10

11.

ЛОКАЛЬНЫЕ ВОЗМОЖНОСТИ
Что работает бесплатно без ключей
Самая ресурсоёмкая часть пайплайна — бесплатна и работает локально. Платить нужно только за тот ИИ, который вы решите подключить.
Функция
Технология
Стоимость
Скачивание видео с 1800+ сайтов
yt-dlp
$0
Транскрибация аудио
Локальный faster-whisper
$0
Озвучка (400+ голосов, 70+ языков)
Edge TTS
$0
Пословные анимированные субтитры
FFmpeg + ASS
$0
Библиотека фоновой музыки
Локальная, royalty-free
$0
Автоматическое наложение звуковых эффектов
FFmpeg
$0
Реframe, GIF, скорость, тримминг, вотермарк и др.
FFmpeg + Whisper
$0
YouTube / TikTok / Pexels по-прежнему требуют бесплатных API-ключей — см. таблицу BYOK.
ViralMint · Установка и настройка
11

12.

УПРАВЛЕНИЕ С ТЕЛЕФОНА
Настройка мессенджеров
Подключите мессенджер в Settings → Messaging, чтобы командовать Planner-агентом и получать уведомления о задачах прямо в чате.
Telegram
Discord
Slack
WhatsApp
Bot-токен
Bot-токен
Bot-токен
QR-код
Создаётся в Discord Developer
Создаётся как Slack App,
Сопряжение сканированием QR-
Portal, приглашается на сервер
подключается через OAuth-токен
кода — как WhatsApp Web
Создаётся через @BotFather,
вставляется в Settings →
Messaging
Один и тот же Planner-агент, разный способ доставки — команды и результаты синхронизированы с веб-интерфейсом.
ViralMint · Установка и настройка
12

13.

ПОИСК И АНАЛИЗ ТРЕНДОВ
Использование: Scout и Analyze