AI Recruitment Telegram Bot

Продвинутый Telegram-бот для рекрутинговых агентств, работающих со стриминговыми платформами. Бот включает AI-ответы, автоматическую обработку заявок, проверку фотографий, OCR для извлечения данных из документов и полноценную админ-панель.
Примечание: бот специально разработан для агентств, набирающих моделей для стримингового приложения Halo.

Функционал.

Возможности для пользователей.
AI-чат с интеллектуальными ответами на базе g4f (GPT-4 Free) с автоматическим сопоставлением FAQ. Умная работа с фотографиями с поддержкой одиночных и сгруппированных загрузок. Пошаговый процесс подачи заявки. Система отзывов с галереей изображений для социального доверия. Мультиязычный интерфейс на русском и украинском языках с естественным стилем общения.

Возможности для администратора.
Панель управления со статистикой в реальном времени и метриками эффективности AI. Проверка заявок с возможностью одобрения или отклонения. Мониторинг всех диалогов пользователей и экспорт истории чатов. Автоматическое обучение AI на ответах администратора. Гибкая настройка приветственных сообщений и шаблонов решений. Управление запрещёнными темами. Экспорт логов для отладки.

Технические возможности.
Интеграция OCR для автоматического извлечения данных из скриншотов документов с помощью Tesseract. FSM для контроля пользовательских сценариев. SQLite с aiosqlite для асинхронной работы. Оценка уверенности AI с автоматической эскалацией администратору. Корректная обработка media group. Механизм повторных AI-запросов с fallback.

Требования.
Python 3.8 или выше. Токен Telegram-бота. Установленный Tesseract OCR.

Установка.
Клонирование репозитория и переход в папку проекта. Создание и активация виртуального окружения. Установка зависимостей из requirements.txt. Установка Tesseract OCR (Windows — через установщик, macOS — brew install tesseract, Linux — apt-get install tesseract-ocr).

Настройка окружения.
Создание файла .env в корне проекта с указанием BOT_TOKEN и ADMIN_ID.

Дополнительные файлы.
Папка goods для изображений отзывов. Папка images с файлом halo_download.jpg для примера скриншота.

Запуск.
Запуск файла main.py. При старте бот инициализирует базу данных, загружает FAQ и настройки, начинает принимать сообщения и вести логирование. Остановка через Ctrl+C.

Использование для кандидатов.
Запуск через /start. Общение с AI. Отправка 2–3 фотографий. Ответы на вопросы о графике и опыте. Ожидание проверки. Получение инструкций при одобрении. Отправка скриншота с документом. Активация аккаунта на следующий рабочий день.

Использование для администратора.
Команда /admin для входа в админ-панель. Просмотр статистики. Проверка заявок. Ответы на вопросы, переданные AI. Экспорт переписок и логов. Настройка сообщений и параметров.

Конфигурация.
Через config.py можно изменить количество фотографий, порог уверенности AI, запрещённые темы и универсальные ответы. SYSTEM_PROMPT позволяет управлять стилем и логикой AI.

База данных.
Используются таблицы users, messages, photos, applications, faq, ai_learning, settings, forbidden_topics и pending_questions.

AI-система.
Используется многоуровневый подход: прямое сопоставление FAQ, построение контекста, оценка уверенности, автоматическая эскалация и система обучения на ответах администратора. В качестве AI-провайдера используется g4f (GPT-4 Free).

Адаптация.
Бот можно адаптировать под другие ниши, изменив тексты, сценарии, вопросы, языки и добавив новый функционал.

Лицензия.
Проект распространяется по лицензии GNU GPL.

Поддержка.
Вопросы и предложения принимаются через Issues на GitHub.

Ссылка на репозиторий:
https://github.com/fedyaqq34356/HR-AI-Telegram-Bot.git](https://github.com/fedyaqq34356/HR-AI-Telegram-Bot.git