AI Recruitment Telegram Bot

Understood, my mistake. Let's make it denser: without unnecessary empty lines, but **not as one continuous block**, rather in normal paragraphs. Below — neatly and compactly.

---

Advanced Telegram bot for recruiting agencies working with streaming platforms. The bot includes AI responses, automatic application processing, photo verification, OCR for data extraction from documents, and a full admin panel.
Note: the bot is specifically designed for agencies recruiting models for the streaming application Halo.

Functionality.

User capabilities.
AI chat with intelligent responses based on g4f (GPT-4 Free) with automatic FAQ matching. Smart handling of photos with support for single and grouped uploads. Step-by-step application process. Feedback system with an image gallery for social trust. Multilingual interface in Russian and Ukrainian with a natural communication style.

Administrator capabilities.
Control panel with real-time statistics and AI performance metrics. Application verification with the ability to approve or reject. Monitoring all user dialogues and exporting chat history. Automatic AI training on administrator responses. Flexible customization of welcome messages and solution templates. Management of prohibited topics. Export of logs for debugging.

Technical capabilities.
OCR integration for automatic data extraction from document screenshots using Tesseract. FSM for controlling user scenarios. SQLite with aiosqlite for asynchronous operation. AI confidence assessment with automatic escalation to the administrator. Proper handling of media groups. Mechanism for repeated AI requests with fallback.

Requirements.
Python 3.8 or higher. Telegram bot token. Installed Tesseract OCR.

Installation.
Cloning the repository and navigating to the project folder. Creating and activating a virtual environment. Installing dependencies from requirements.txt. Installing Tesseract OCR (Windows — via installer, macOS — brew install tesseract, Linux — apt-get install tesseract-ocr).

Environment setup.
Creating a .env file in the root of the project specifying BOT_TOKEN and ADMIN_ID.

Additional files.
Goods folder for review images. Images folder with halo_download.jpg file for a screenshot example.

Running.
Running the main.py file. Upon startup, the bot initializes the database, loads FAQ and settings, starts receiving messages, and logging. Stopping via Ctrl+C.

Usage for candidates.
Starting via /start. Communicating with AI. Sending 2–3 photos. Answering questions about schedule and experience. Waiting for verification. Receiving instructions upon approval. Sending a screenshot with a document. Activating the account on the next working day.

Usage for administrator.
Command /admin to enter the admin panel. Viewing statistics. Checking applications. Answering questions forwarded to AI. Exporting conversations and logs. Customizing messages and settings.

Configuration.
Through config.py, you can change the number of photos, AI confidence threshold, prohibited topics, and universal responses. SYSTEM_PROMPT allows managing the style and logic of AI.

Database.
Tables used include users, messages, photos, applications, faq, ai_learning, settings, forbidden_topics, and pending_questions.

AI system.
A multi-level approach is used: direct FAQ matching, context building, confidence assessment, automatic escalation, and a training system based on administrator responses. g4f (GPT-4 Free) is used as the AI provider.

Adaptation.
The bot can be adapted to other niches by changing texts, scenarios, questions, languages, and adding new functionality.

License.
The project is distributed under the GNU GPL license.

Support.
Questions and suggestions are accepted via Issues on GitHub.

Repository link:
https://github.com/fedyaqq34356/HR-AI-Telegram-Bot.git