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

За 5 минут до первого видео

1️⃣ Установка (2 минуты)

# Клонируйте и перейдите в папку
git clone https://github.com/your-repo/kontent-factory.git
cd kontent-factory

# Создайте виртуальное окружение
python -m venv venv

# Активируйте окружение
# Windows
venv\Scripts\activate
# macOS/Linux  
source venv/bin/activate

# Установите зависимости
pip install -r requirements.txt

2️⃣ Настройка API (2 минуты)

# Скопируйте конфигурацию
cp env.example .env

# Отредактируйте .env файл
# Добавьте OpenAI API ключ (обязательно!)
OPENAI_API_KEY=sk-your-openai-api-key-here

3️⃣ Запуск (1 минута)

# Запустите систему
python admin_panel.py

# Откройте браузер
# http://localhost:5000

🎬 Создание первого видео

1. Загрузите видео - перетащите MP4 файл в область загрузки
2. Выберите настройки - выберите пресет "TikTok Vertical"
3. Запустите обработку - нажмите "Начать обработку"
4. Получите результат - готовое видео в папке output/

🎯 Готовые пресеты

🔧 Установка

📋 Системные требования

🐍 Установка Python

Windows:

1. Скачайте с python.org
2. Установите с галочкой "Add Python to PATH"

macOS:

brew install python@3.9

Ubuntu/Debian:

sudo apt install python3.9 python3.9-venv python3.9-pip

📦 Установка зависимостей

# Создайте виртуальное окружение
python -m venv venv

# Активируйте окружение
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

# Обновите pip
python -m pip install --upgrade pip

# Установите зависимости
pip install -r requirements.txt

🎬 Установка FFmpeg

Windows (автоматически):

python download_ffmpeg.py

macOS:

brew install ffmpeg

Ubuntu/Debian:

sudo apt install ffmpeg

✅ Проверка установки

# Проверьте Python
python --version

# Проверьте FFmpeg
ffmpeg -version

# Запустите систему
python admin_panel.py

📖 Полная документация

Исчерпывающее руководство по всем аспектам системы "Контент Завод".

📋 Содержание

1. Обзор проекта - архитектура и возможности
2. Установка и настройка - детальная настройка системы
3. Описание модулей - назначение каждого компонента
4. API документация - полное описание API
5. Работа с админ-панелью - руководство по интерфейсу
6. Настройка параметров - детальная настройка
7. Социальные сети - интеграция с платформами
8. Ограничения системы - технические ограничения
9. Устранение проблем - решение частых проблем
10. Примеры использования - практические сценарии

🎯 Для кого предназначена

• Контент-мейкеры - создатели коротких видео
• Блогеры - авторы образовательного контента
• Маркетологи - специалисты по продвижению
• Студии - агентства по производству контента
• Разработчики - интеграция и расширение
• Администраторы - развертывание и обслуживание

📊 Статистика документации

• Объем: 60,000+ слов
• Разделы: 150+
• Примеры кода: 100+
• Схемы и диаграммы: 20+

🔌 API Reference

Полная документация по API системы "Контент Завод".

🌐 Базовый URL

http://localhost:5000

📡 Основные endpoints

⚙️ Настройки

GET  /api/settings          # Получение настроек
PUT  /api/settings          # Обновление настроек

🎬 Обработка видео

POST /api/process           # Запуск обработки
GET  /status/{task_id}      # Статус задачи
DELETE /status/{task_id}    # Отмена задачи

📱 Социальные сети

GET  /api/social/status     # Статус платформ
POST /api/social/auto-publish  # Автопубликация
POST /api/social/publish    # Ручная публикация
GET  /api/social/posts      # История публикаций

📊 Статистика

GET  /api/stats            # Общая статистика
GET  /api/stats/tasks      # Статистика задач
GET  /api/health           # Состояние системы
GET  /api/logs             # Логи системы

💡 Примеры использования

Обработка видео

curl -X POST http://localhost:5000/api/process \
  -H "Content-Type: application/json" \
  -d '{
    "video_path": "/path/to/video.mp4",
    "settings": {
      "jumpcut_mode": true,
      "vertical": true
    }
  }'

Автопубликация

curl -X POST http://localhost:5000/api/social/auto-publish \
  -H "Content-Type: application/json" \
  -d '{
    "highlights_dir": "output",
    "platforms": ["tiktok", "youtube"]
  }'

🐍 Python интеграция

import requests

class KontentFactoryAPI:
    def __init__(self, base_url="http://localhost:5000"):
        self.base_url = base_url
    
    def process_video(self, video_path, settings=None):
        response = requests.post(f"{self.base_url}/api/process", json={
            "video_path": video_path,
            "settings": settings or {}
        })
        return response.json()

# Использование
api = KontentFactoryAPI()
result = api.process_video("/path/to/video.mp4", {
    "jumpcut_mode": True,
    "vertical": True
})

🎛️ Руководство по админ-панели

Подробное руководство по работе с веб-интерфейсом системы.

🏠 Обзор интерфейса

Интерфейс разделен на три основные области:

• 📱 Левая панель - настройки обработки
• 🎬 Центральная область - загрузка и обработка
• 📊 Правая панель - мониторинг и логи

⚙️ Настройки обработки

🎨 Пресеты настроек

🔧 Детальные настройки

• Jumpcut настройки - удаление пауз и тишины
• Вертикальные настройки - адаптация для мобильных
• Настройки субтитров - стиль и позиционирование
• Настройки баннеров - брендинг и водяные знаки

🎬 Загрузка и обработка

📤 Поддерживаемые форматы

• MP4 (рекомендуется)
• AVI
• MOV
• MKV
• WebM

⚙️ Процесс обработки

1. Анализ видео - извлечение метаданных
2. Обработка аудио - анализ звука
3. Создание субтитров - генерация текста
4. Jumpcut обработка - удаление пауз
5. Вертикальная конвертация - изменение пропорций
6. Наложение баннеров - добавление брендинга
7. Экспорт видео - финальная обработка

📱 Социальные сети

🔗 Настройка платформ

• 🟢 Готово - платформа настроена и доступна
• 🔴 Не настроено - отсутствуют API ключи
• ⚠️ Ошибка - проблемы с подключением

🚀 Автопубликация

1. Выберите платформы чекбоксами
2. Укажите папку с хайлайтами
3. Нажмите "Запустить автопубликацию"
4. Следите за прогрессом в логах

⚙️ Руководство по настройке

Детальное руководство по установке и настройке системы.

📋 Системные требования

🔑 Настройка API ключей

🤖 OpenAI API (обязательно)

1. Перейдите на platform.openai.com
2. Создайте аккаунт
3. Получите API ключ
4. Добавьте в .env: OPENAI_API_KEY=sk-your-key-here

🎵 TikTok API

1. Перейдите на developers.tiktok.com
2. Создайте приложение
3. Получите ключи
4. Запустите python scripts/get_tiktok_token.py

🎬 YouTube API

1. Перейдите в Google Cloud Console
2. Создайте проект
3. Включите YouTube Data API v3
4. Создайте OAuth credentials
5. Запустите python scripts/get_youtube_token.py

📱 ВКонтакте API

1. Перейдите на dev.vk.com
2. Создайте приложение
3. Получите access token
4. Добавьте в .env файл

🔧 Конфигурация системы

📁 Структура .env файла

# OpenAI API (ОБЯЗАТЕЛЬНО)
OPENAI_API_KEY=sk-your-openai-api-key-here

# TikTok API
TIKTOK_CLIENT_KEY=your_tiktok_client_key
TIKTOK_CLIENT_SECRET=your_tiktok_client_secret
TIKTOK_ACCESS_TOKEN=your_tiktok_access_token
TIKTOK_REFRESH_TOKEN=your_tiktok_refresh_token

# YouTube API
YOUTUBE_CLIENT_ID=your_youtube_client_id
YOUTUBE_CLIENT_SECRET=your_youtube_client_secret
YOUTUBE_REFRESH_TOKEN=your_youtube_refresh_token

# ВКонтакте API
VK_ACCESS_TOKEN=your_vk_access_token
VK_GROUP_ID=your_vk_group_id

✅ Проверка работоспособности

🔍 Диагностика системы

# Проверка API ключей
python check_api_keys.py

# Проверка веб-интерфейса
# Откройте http://localhost:5000

# Тестирование обработки
python test_simple_video.py

🔑 API ключи

Получение и настройка всех необходимых API ключей.

🤖 OpenAI API (обязательно)

🎵 TikTok API

🎬 YouTube API

📱 ВКонтакте API

🔧 Автоматическое получение токенов

# TikTok
python scripts/get_tiktok_token.py

# YouTube
python scripts/get_youtube_token.py

# Проверка всех ключей
python check_api_keys.py

📱 Социальные платформы

Настройка и управление автопубликацией в социальных сетях.

🎵 TikTok

🎬 YouTube

📱 ВКонтакте

🚀 Настройка автопубликации

1. Настройте API ключи для нужных платформ
2. Выберите платформы чекбоксами в админ-панели
3. Укажите папку с хайлайтами (по умолчанию "output")
4. Нажмите "Запустить автопубликацию"
5. Следите за прогрессом в логах

⚙️ Настройки публикации

• Задержка между постами: 5-60 минут
• Автоматические хештеги: включено/выключено
• Кастомные подписи: включено/выключено
• Планирование: отложенная публикация

📊 Мониторинг публикаций

• История публикаций - все опубликованные посты
• Статистика - просмотры, лайки, комментарии
• Управление - повторная публикация, удаление
• Аналитика - эффективность контента

❓ Часто задаваемые вопросы

Ответы на самые популярные вопросы о системе "Контент Завод".

🚀 Установка и настройка

❓ Какие системные требования?

Минимальные: Python 3.8+, 4 ГБ RAM, 10 ГБ места, Windows 10+/macOS 10.14+/Ubuntu 18.04+

Рекомендуемые: Python 3.9+, 8+ ГБ RAM, 50+ ГБ места, SSD диск

❓ Что делать, если "ModuleNotFoundError"?

# Убедитесь, что виртуальное окружение активировано
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

# Переустановите зависимости
pip install -r requirements.txt

🔑 API ключи

❓ Где получить OpenAI API ключ?

1. Перейдите на platform.openai.com
2. Создайте аккаунт
3. Перейдите в "API Keys"
4. Создайте новый ключ
5. Скопируйте ключ (начинается с sk-)

❓ Что делать, если API ключ не работает?

1. Проверьте правильность ключа
2. Убедитесь, что ключ активен
3. Проверьте баланс (для OpenAI)
4. Перезапустите приложение
5. Запустите python check_api_keys.py

🎬 Обработка видео

❓ Какие форматы видео поддерживаются?

MP4 (рекомендуется), AVI, MOV, MKV, WebM

❓ Что такое jumpcut?

Jumpcut - это автоматическое удаление пауз и тишины из видео для создания динамичных роликов.

❓ Почему обработка занимает много времени?

Факторы: длительность видео (1 мин ≈ 2-5 мин обработки), сложность настроек, мощность компьютера

Ускорение: используйте SSD диск, увеличьте RAM, выберите "Fast Jumpcut" пресет

📱 Социальные сети

❓ Какие платформы поддерживаются?

TikTok, YouTube, ВКонтакте

❓ Какие ограничения по публикации?

• TikTok: 10 видео/день, 1/час, до 287 МБ
• YouTube: 6 загрузок/день, до 128 ГБ
• ВКонтакте: 5000 запросов/день, до 2 ГБ

🔧 Устранение проблем

❓ "Port 5000 is already in use"

# Найдите процесс
netstat -ano | findstr :5000

# Завершите процесс
taskkill /PID  /F

# Или измените порт в .env
PORT=5001

❓ "FFmpeg not found"

# Windows
python download_ffmpeg.py

# macOS
brew install ffmpeg

# Ubuntu
sudo apt install ffmpeg

💰 Стоимость

❓ Сколько стоит использование?

OpenAI API: зависит от использования (~$0.01-0.10 за минуту видео)

Социальные сети: бесплатно в рамках лимитов

🔧 Устранение проблем

Решения частых проблем и ошибок системы.

❌ Частые ошибки

🔑 Проблемы с API ключами

🎬 Проблемы с обработкой видео

# Windows
python download_ffmpeg.py

# macOS
brew install ffmpeg

# Ubuntu
sudo apt install ffmpeg

🌐 Проблемы с сетью

# Найдите процесс
netstat -ano | findstr :5000

# Завершите процесс
taskkill /PID  /F

# Или измените порт в .env
PORT=5001

🔍 Диагностика

🔧 Проверка системы

# Проверка API ключей
python check_api_keys.py

# Проверка зависимостей
pip list
pip check

# Проверка Python окружения
python -c "import sys; print(sys.version)"
python -c "import sys; print(sys.path)"

📊 Мониторинг ресурсов

# Windows
tasklist /fi "imagename eq python.exe"

# macOS/Linux
ps aux | grep python

# Проверка дискового пространства
# Windows
dir /s

# macOS/Linux
du -sh *

📝 Анализ логов

# Основные логи
tail -f logs/content_factory.log

# Логи ошибок
tail -f logs/content_factory_errors.log

# Поиск по логам
grep "ERROR" logs/content_factory.log
grep "WARNING" logs/content_factory.log

🛠️ Профилактика

📁 Регулярное обслуживание

• Очистка временных файлов - регулярно удаляйте старые файлы
• Мониторинг дискового пространства - следите за свободным местом
• Обновление API ключей - регулярно обновляйте токены
• Резервное копирование - сохраняйте важные настройки

⚡ Оптимизация производительности

• Используйте SSD диск для временных файлов
• Увеличьте RAM до 16+ ГБ
• Закройте ненужные программы во время обработки
• Используйте проводное соединение для стабильности

📞 Поддержка

Получение помощи и поддержки по системе "Контент Завод".

🆘 Способы получения помощи

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

Перед обращением в поддержку обязательно проверьте документацию:

• FAQ - ответы на частые вопросы
• Устранение проблем - решения ошибок
• Полная документация - исчерпывающее руководство
• API Reference - документация по API

🐛 Сообщение об ошибках

При сообщении об ошибке укажите:

• Версию системы - текущая версия
• Операционную систему - Windows/macOS/Linux
• Логи ошибок - содержимое файлов логов
• Шаги для воспроизведения - как воспроизвести ошибку
• Ожидаемое поведение - что должно происходить
• Фактическое поведение - что происходит на самом деле

💡 Предложения по улучшению

Мы приветствуем предложения по улучшению системы:

• Новые функции - что добавить в систему
• Улучшения интерфейса - как сделать удобнее
• Оптимизация производительности - как ускорить работу
• Исправления багов - что исправить

📞 Контакты поддержки

⏰ Время ответа

• Telegram: В течение нескольких часов
• GitHub Issues: В течение 1-2 дней
• Email: В течение 2-3 дней

🤝 Сообщество

Присоединяйтесь к сообществу пользователей "Контент Завод":

• Обмен опытом - делитесь успешными кейсами
• Взаимопомощь - помогайте другим пользователям
• Обратная связь - влияйте на развитие продукта
• Новости - узнавайте о новых возможностях

💡 Совет: Чем подробнее вы опишете проблему, тем быстрее мы сможем помочь!