TgActor управляет сеткой Telegram-аккаунтов через веб-панель. Программа разыгрывает ветки диалогов под постами в каналах, ставит реакции, перехватывает свежие публикации и собирает входящие сообщения со всех профилей в единый инбокс.
- Telegram-канал разработчика: https://t.me/ivanchik_byte (новости, шаблоны сценариев, полезные скрипты).
- Личные сообщения разработчика: https://t.me/ivanchikbyte (вопросы, предложения, связь).
- Что умеет программа
- Скриншоты интерфейса
- Как это работает
- Установка через Docker (Рекомендуемый способ)
- Установка без Docker (Локально)
- Генерация секретного ключа (SECRET_KEY)
- Настройка файла .env
- Устранение частых ошибок
- Контакты и лицензия
- Режим первого комментария (Channel Sniper / «Первонах»):
- Мгновенный снайпинг новых публикаций в целевых каналах (пауза 0-2 сек).
- Публикация комментария от имени вашего Telegram-канала (
Send as Channel) с аватаром и названием канала для привлечения подписчиков, либо от личного профиля. - Автоматическая подгрузка списка каналов выбранного аккаунта (где он является создателем или администратором).
- Встроенный фильтр рекламы (
Anti-Ad Shield): автопропуск спонсорских постов сerid,#рекламаи партнерскими ссылками. - AI Prompt Studio: чипы пресетов («Экспертный тезис», «Вопрос по теме», «Практический опыт», «Ирония / реакция») по строгим правилам Humanizer (1 предложение, без эмодзи, без финальной точки).
- Конструктор сценариев и веток диалогов: создание цепочек сообщений любой длины с ответами ботов друг на друга, рандомизацией пауз и медиавложениями.
- Генерация текста через нейросеть (ИИ):
- Создание готового сценария по вашему описанию в 1 клик.
- Динамический режим: нейросеть сама формулирует уникальный текст ответа прямо во время комментирования поста.
- Мониторинг каналов (Радар): программа следит за каналами и, как только выходит новый пост, автоматически отправляет ботов комментировать его по сценарию или в режиме снайпинга.
- Плавный вход ботов: боты заходят в чаты по очереди с паузами (например, раз в 30-60 секунд), чтобы избежать спам-блокировок Telegram.
- Разделение аккаунтов на пулы: одни аккаунты пишут текст, другие ставят эмодзи-реакции.
- Единый чат (Инбокс): чтение и отправка личных сообщений со всех подключенных аккаунтов в одной вкладке.
- Удобный импорт: добавление аккаунтов через архивы TData (с поддержкой 2FA) или по SMS-коду.
- Поддержка прокси: к каждому аккаунту можно привязать отдельный SOCKS5 или HTTP прокси.
- Дизайн в стиле Linear / Raycast: современный темный интерфейс без навязчивых эмодзи, со строгими статусами и мгновенным откликом.
Удобный визуальный редактор диалогов с живой симуляцией порядка ответов.
Чтение и отправка личных сообщений со всех подключенных аккаунтов в едином окне.
Импорт аккаунтов, привязка прокси и настройка ролей ботов.
Результат работы ботов: связная ветка комментариев с ответами участников друг другу.
Полная галерея всех экранов программы доступна в файле docs/SCREENSHOTS.md.
- Вы загружаете свои Telegram-аккаунты через TData или SMS.
- Создаете сценарий вручную или генерируете его через встроенный ИИ (поддерживаются NVIDIA NIM, DeepSeek, OpenAI).
- Добавляете нужные каналы во вкладку «Мониторинг».
- Программа автоматически находит группу обсуждений под каналом, безопасно добавляет туда ботов и запускает обсуждение по вашему сценарию.
Установка через Docker является самой быстрой и надежной, так как автоматически настраивает базу данных PostgreSQL, брокер Redis, бэкенд и собранный веб-интерфейс.
-
Убедитесь, что на сервере установлены Git и Docker:
sudo apt update && sudo apt install -y git docker.io docker-compose-v2 -
Склонируйте репозиторий:
git clone https://github.com/ivanchik-byte/TgActor.git cd TgActor -
Создайте файл конфигурации
.env:cp .env.example .env
-
Сгенерируйте секретный ключ для шифрования данных:
python3 -c "import secrets; print(secrets.token_urlsafe(32))"Откройте файл
.env(nano .env) и вставьте сгенерированный ключ в строки:SECRET_KEY=вставьте_сгенерированный_ключ ENCRYPTION_KEY=вставьте_сгенерированный_ключ ADMIN_PASSWORD=ваш_пароль_для_входа
-
Запустите проект:
docker compose up -d --build
-
Откройте панель в браузере:
http://IP_ВАШЕГО_СЕРВЕРА:8000.
- Установите Docker Desktop для Windows (при установке оставьте галочку WSL 2).
- Запустите PowerShell или командную строку (CMD) и выполните:
git clone https://github.com/ivanchik-byte/TgActor.git cd TgActor Copy-Item .env.example .env
- Сгенерируйте ключ шифрования:
python -c "import secrets; print(secrets.token_urlsafe(32))"
- Откройте файл
.envв Блокноте и заполните:SECRET_KEYиENCRYPTION_KEY: сгенерированный ключ.ADMIN_PASSWORD: ваш пароль для входа.
- Запустите программу:
docker compose up -d --build
- Откройте в браузере:
http://localhost:8000.
Если вы запускаете проект напрямую через Python и Node.js:
- Python 3.11 или выше
- Node.js 18+ и npm
- Запущенный Redis сервер (или локальный Redis)
-
Клонирование и настройка виртуального окружения:
git clone https://github.com/ivanchik-byte/TgActor.git cd TgActor python3 -m venv venv source venv/bin/activate # На Windows: .\venv\Scripts\activate pip install -r requirements.txt
-
Сборка интерфейса:
cd frontend npm install npm run build cd ..
-
Настройка файла
.env:cp .env.example .env
Укажите ваш
SECRET_KEY,ADMIN_PASSWORDи параметры подключения к БД (по умолчанию для локального запуска без Docker можно использовать SQLite:DATABASE_URL=sqlite+aiosqlite:///./data/tgactor.db). -
Применение миграций базы данных:
alembic upgrade head
-
Запуск сервера:
uvicorn main:app --host 0.0.0.0 --port 8000
Панель будет доступна по адресу:
http://localhost:8000.
Ключ необходим для шифрования Telegram-сессий в базе данных. Выполните команду в терминале:
python3 -c "import secrets; print(secrets.token_urlsafe(32))"Скопируйте полученную строку и вставьте в .env в поля SECRET_KEY= и ENCRYPTION_KEY=.
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
ADMIN_PASSWORD |
Пароль для входа в веб-панель управления | admin |
SECRET_KEY |
Секретный ключ шифрования сессий и токенов | Сгенерированный ключ |
ENCRYPTION_KEY |
Ключ шифрования TData и сессий | Сгенерированный ключ |
DATABASE_URL |
Строка подключения к PostgreSQL или SQLite | postgresql+asyncpg://tgactor:tgactor_password@db:5432/tgactor_db |
REDIS_URL |
Строка подключения к брокеру Redis | redis://redis:6379/0 |
PORT |
Порт для веб-интерфейса (если 8000 занят) | 8000 |
ENABLE_CHANNEL_MONITOR |
Фоновый опрос каналов и авто-запуск сценариев | True |
ENABLE_INBOX_LISTENER |
Фоновое слушание и стриминг входящих ЛС | True |
- Не заходит в панель (Unauthorized): проверьте правильность
ADMIN_PASSWORDв файле.envи очистите куки сайта в браузере. - Порт 8000 уже занят: укажите другой порт в файле
.env(например,PORT=8080) и перезапустите черезdocker compose up -d. - Боты не комментируют: проверьте, что в конструкторе сценариев есть хотя бы один активный сценарий с заполненными шагами, и что у целевого канала открыты комментарии.
- ИИ долго генерирует ответ: в окне «Настройки ИИ» выберите более легкую и быструю модель (например,
meta/llama-3.3-70b-instructилиdeepseek-chat).
Полезные команды для обслуживания:
# Просмотр логов бэкенда в реальном времени
docker compose logs -f backend
# Перезапуск бэкенда
docker compose restart backend
# Остановка всех контейнеров
docker compose down
# Обновление и пересборка контейнеров
docker compose up -d --build- Telegram-канал разработчика: https://t.me/ivanchik_byte: обновления, готовые сценарии, скрипты и кейсы.
- Личные сообщения: https://t.me/ivanchikbyte: вопросы по проекту, баг-репорты и предложения.
- Лицензия: MIT License
Отказ от ответственности: программа разработана для тестирования, исследований и демонстрационных целей. Проект не предназначен и не поддерживает массовую рассылку, спам, накрутку engagement или любые формы манипуляции платформой.