📧 Inviter - бот для пиара нового поколения

🐛 Сообщить о баге • 💡 Предложить идею

---

📑 Содержание

• 📧 Inviter - бот для пиара нового поколения
  • 📑 Содержание
  • 📖 Описание проекта
    • Идея и концепция
    • Полное описание
    • Для кого этот проект
  • ✨ Реализованные фичи
  • 🚀 Быстрый старт
    • Предварительные требования
    • Установка
    • Конфигурация
    • Деплой
    • Проверка
  • 🏗️ Архитектура проекта
  • 🛠️ Технологический стек
  • 📊 Статистика проекта
  • 🤝 Контрибьюция
  • 👥 Авторы и благодарности
  • 📄 Лицензия

📖 Описание проекта

Идея и концепция

Inviter - это проект, созданный для решения целого спектра задач:

• Перегонка трафика из - в
• Рассылки пользователям в личные сообщения
• Инвайтинг живого, реального трафика
• Продвинутая автоматизация пиара любым способом
• Удешивление живого трафика и рекламы
• Продвижение своих продуктов и/или себя самого

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

Полное описание

Inviter - проект продвинутого бота-инвайтера, который умеет не только добавлять пользователей из одного чата в другой, но также может рассыласть рекламу как в чаты так и в ЛС, выбирает всегда реально активных и живых пользователей, имеет фильтры и повышенный уровень легитимности относительно Anti-bot систем.

Проект ориентирован на траферов и решает следующие задачи:

• Пиар
• Рассылки
• Реклама
• Инвайтинг

Ключевые принципы проекта:

1. Простота - упрощение сложных процессов
2. Удобство - сделать выполнение задачи максимально удобным
3. Надёжность - максимальная устойчивость к любому сценарию использования
4. Гибкость - максимально гибкие настройки

Для кого этот проект

• Траферы
• Индивидуальные пользователи
• Администраторы любых проектов

Но на этом аудитория не ограничивается. Она ограничивается лишь вашей фантазией.

---

✨ Реализованные фичи

Реализовано и работоспособно:

• Инвайтинг с нескольких аккаунтов
• БД чатов на SQLite с валидацией и очисткой
• Массовая рассылка по чатам и в личные сообщения
• Режим червя для сбора чатов по ссылкам из сообщений
• Планировщик задач с очередью, паузой, возобновлением и отменой
• Human-like поведение и рандомизация задержек
• Адаптивные задержки и обработка FloodWait
• Кэширование сущностей, участников и приглашений
• Автоматический выход из чатов, куда бот вступил сам
• Мультиязычность (ru, en)
• Доступ по Telegram ID владельца, без ключей и регистрации

Бот работает в режиме одного владельца: список OWNER_USER_IDS в .env задаёт единственных пользователей, которым доступен функционал.

---

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

Предварительные требования

• Зависимости
  • Runtime - Python 3.13.9+ (возможно и старше, тестирование не проводилось)
  • Библиотеки из requirements.txt
  • Docker (для деплоя)
• Железо (выделеное под бота, минимум для запуска и корректной работы)
  • CPU 1 ядро 1Ггц
  • RAM 200мб
  • ROM 250мб

Установка

# Клонируйте репозиторий
git clone https://github.com/Major-Woolfi/Inviter.git
cd Inviter

Конфигурация

# Скопируйте файл переменных окружения
cp .env.example .env
# Отредактируйте .env под ваши нужды

Обязательные переменные:

Переменная	Описание
BOT_TOKEN	Токен бота от BotFather
API_ID	Числовой api_id с my.telegram.org
API_HASH	api_hash с my.telegram.org
OWNER_USER_IDS	Telegram ID владельца через запятую, например 111111,222222

Полный список настроек с комментариями находится в .env.example.

Деплой

# Разово перенесите проект в нужную папку и настройте PROJECT_DIR при необходимости
bash deploy_bot.sh

Скрипт собирает образ, пересоздаёт контейнер и пробрасывает data, sessions, logs и .env. Вручную:

docker build -t inviter_bot .
docker rm -f inviter_bot 2>/dev/null || true
docker run -d --name inviter_bot --restart always --env-file .env \
  -v "$(pwd)/data":/app/data -v "$(pwd)/sessions":/app/sessions \
  -v "$(pwd)/logs":/app/logs inviter_bot

Замените путь в cd или переместите бота в соответствующую папку

---

Проверка

Перед запуском убедитесь, что:

• Вы настроили все .env
• python main.py запускается без ошибок конфигурации
• python -m pytest tests -q проходит

Тесты покрывают конфигурацию, переводы, разбор ссылок и все базы данных.

---

🏗️ Архитектура проекта

├── data/
│  ├── tasks.db
│  ├── chats.db
│  ├── cache.db
│  └── users.db
├── sessions/
│  └── *.session
├── langs/
│  ├── en.json
│  └── ru.json
├── logs/
│  └── bot_YYYY-MM-DD.log
├── tests/
│  └── test_main.py
├── .env
├── .env.example
├── main.py
├── requirements.txt
├── Dockerfile
├── deploy_bot.sh
├── .gitignore
├── LICENSE
└── README.md

---

🛠️ Технологический стек

Категория	Технологии
Backend	aiogram 3, Telethon
Database	aiosqlite (SQLite)
Config	python-dotenv
DevOps	Docker
Quality	pytest, Ruff

Все указанные технологии - библиотеки Python, т.к. это единственный язык, который тут используется, не считая языков, на которых написаны сами библиотеки.

---

📊 Статистика проекта

Метрика	Значение
⭐ Stars
🍴 Forks
🐛 Issues
👥 Contributors

---

🤝 Контрибьюция

Приветствуем любые вклад в проект! Перед созданием PR обязательно прочитай:

• 📋 CONTRIBUTING - правила участия
• 💬 CODE OF CONDUCT - кодекс поведения
• 🐛 ISSUE TEMPLATE - шаблоны багов и фич
• 🔀 PULL REQUEST TEMPLATE - требования к PR

Все общие правила хранятся в репозитории .github в папке community.

---

👥 Авторы и благодарности

---

📄 Лицензия

Этот проект распространяется под лицензией MIT. Подробности в файле LICENSE.

---

⭐ Поставь звезду, если проект понравился!

📧 Telegram