Инструкция

Полное руководство по TwitchAI

Как это работает

TwitchAI — система из до 50 AI-ботов, которые автоматически пишут в чат Twitch-канала, имитируя живую аудиторию. Каждый бот — уникальный персонаж со своим характером, стилем речи и интересами.

Стрим → скриншот каждые 10 сек → Yandex Vision AI → понимает что происходит

Событие (клip, смерть, победа) → ActivityEngine → выбирает каких ботов разбудить

Выбранный бот → Yandex AI (YandexGPT) → генерирует сообщение под его персонажа

Сообщение → Twitch IRC → появляется в чате как настоящий зритель

Vision AI

Видит экран стримера, понимает что происходит в игре

AI Боты

Генерируют уникальные сообщения под каждый персонаж

Twitch IRC

Пишут в чат как настоящие зрители

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

Создай Twitch Dev App

Зайди на dev.twitch.tv/console/apps → Create Application.

Имя: любое. OAuth Redirect URL: https://твой_домен/api/auth/callback.

Скопируй Client ID и Client Secret — они нужны в настройках.

Зарегистрируй Twitch-аккаунты ботов

Создай отдельные Twitch-аккаунты для ботов (например: mybot_01, mybot_02...).

Каждый аккаунт нужно авторизовать через OAuth — страница «Боты» → кнопка «Добавить бота».

Там вставляешь access_token и refresh_token, которые получаешь при авторизации через Twitch OAuth.

Получи Yandex AI ключ

Зайди на aistudio.yandex.ru → создай сервисный аккаунт → сгенерируй API ключ.

Запиши API Key и Folder ID — это нужно в файле backend/.env.

Запусти систему

В терминале на сервере: docker compose up -d

Открой главную страницу → введи имя Twitch-канала → нажми «Запустить».

Следи за дашбордом

Перейди в дашборд канала — видишь живой чат, активных ботов, аналитику.

Боты сами начнут писать в чат после подключения к IRC.

Архетипы ботов

У каждого бота есть архетип — его характер и стиль общения в чате.

Архетип	Кто это	Как пишет	Когда молчит
expert	Опытный игрок, знает всё	Технические разборы, советы, анализ билдов	На простых моментах
newbie	Новичок, всему удивляется	Вопросы, восклицания, «вау как круто»	Почти никогда
lore	Ценитель истории/лора	Цитаты, факты о лоре, отсылки	На геймплейных моментах
funny	Шутник, мемы и приколы	Шутки, эмодзи, игра слов, мемы	На серьёзных моментах
strategist	Аналитик, думает наперёд	Стратегии, минусы решений, оптимизация	На случайных событиях
silent	Молчун, пишет редко	Короткие, ёмкие реплики в яркие моменты	Почти всегда

Тиры активности

Каждый бот принадлежит к одному из трёх тиров — это определяет как часто он пишет.

Тир	Кол-во ботов	Частота	Поведение
active	~5 ботов	~1.5 сообщ/мин	Пишут почти постоянно, быстро реагируют на любые события
casual	~15 ботов	~0.3 сообщ/мин	Реагируют на заметные моменты — смерть, победа, клип
lurker	~30 ботов	~0.05 сообщ/мин	Пишут только на wow-моментах, создают массовость

Как работает алгоритм

Активность ботов — пуассоновский процесс + случайный разброс (Gaussian jitter). При крупных событиях (hype cascade) временно увеличивается частота всех тиров. Это делает поведение ботов непредсказуемым и естественным.

Симуляция зрителей

Twitch показывает количество зрителей. TwitchAI симулирует это число — оно равно числу активных ботов плюс случайный шум и синусоидальный цикл.

Параметр	По умолчанию	Что значит
base_count	28	Минимальное кол-во «зрителей» в тихий период
max_count	42	Максимум при всплеске активности