A powerful multilingual Telegram bot built with Python that uses advanced AI capabilities to provide intelligent conversations, deep thinking analysis, web search, and customizable personality features.
👉 Download Executable (Windows)
👉 Download Source Code
This Telegram bot serves as an intelligent assistant with advanced natural language processing capabilities. It supports multiple languages, maintains conversation memory, offers deep analysis features, and allows users to customize the bot's personality. The bot uses the g4f library to provide AI-powered responses and includes comprehensive user statistics and server monitoring features.
- Multilingual Support - English, Spanish, French, Russian, and Arabic
- Conversation Memory - Remembers previous conversations for 2 days
- Advanced Thinking Modes - Deep analysis with multiple perspectives
- Customizable Personality - Change the bot's behavior and save presets
- Web Search - Internet search across multiple reliable sources
- User Statistics - Track your usage and interaction history
- Feedback System - Share your opinions about the bot
- Server Monitoring - Real-time server performance information
- Preset System - Save and load custom personality configurations
- Automatic Cleanup - Efficient memory management
- Multi-format Support - Source code and executable versions
# 1. Download and extract telegram-bot-source-v1.0.zip
# 2. Navigate to the extracted directory
# 3. Create your token configuration
echo '{"token": "YOUR_TELEGRAM_BOT_TOKEN"}' > token.json
# 4. Run the bot# 1. Download and extract telegram-bot-exe-v1.0.zip
# 2. Navigate to the extracted directory
# 3. Create your token configuration
echo '{"token": "YOUR_TELEGRAM_BOT_TOKEN"}' > token.json
# 4. Run the executable-
Prep & clone
sudo apt update && sudo apt install -y python3 python3-venv git git clone https://github.com/HAKORADev/telegram-bot.git && cd telegram-bot
-
Python environment
python3 -m venv venv && source venv/bin/activate pip install -U pip -r requirements.txt
-
Insert your token
echo '{"token":"YOUR_TELEGRAM_BOT_TOKEN"}' > token.json
-
Run forever (systemd)
# create service sudo tee /etc/systemd/system/telegram-bot.service >/dev/null <<'EOF' [Unit] Description=Telegram AI Bot After=network.target [Service] Type=simple User=$USER WorkingDirectory=$PWD ExecStart=$PWD/venv/bin/python telegram_bot.py Restart=always RestartSec=5 [Install] WantedBy=multi-user.target EOF # enable & start sudo systemctl daemon-reload sudo systemctl enable --now telegram-bot
-
Check live logs
sudo journalctl -u telegram-bot -f
Done—bot survives reboots and updates with a simple sudo systemctl restart telegram-bot.
- Open Telegram and search for @BotFather
- Start a chat with BotFather and send
/newbot - Follow the instructions to name your bot
- Copy the token provided by BotFather
- Paste this token in your
token.jsonfile
| Command | Description |
|---|---|
/start |
Start conversation and show help |
/help |
Show all available commands |
/clear |
Clear conversation memory |
| Command | Description |
|---|---|
/think [text] |
Deep thinking analysis on specific text |
/think_full |
Analyze last 10 messages |
/web [query] |
Search the internet |
/customize |
Customize bot personality |
| Command | Description |
|---|---|
/mystats |
Show your personal statistics |
/users_info |
General user statistics |
/server_info |
Server performance information |
/feedback |
Send feedback about the bot |
/credits |
Developer information |
| Command | Language |
|---|---|
/en |
English |
/sp |
Spanish |
/fr |
French |
/ru |
Russian |
/ar |
Arabic |
The bot uses several JSON files for data storage:
📁 Project Structure
├── 📄 token.json # Bot authentication token
├── 📄 conversations.json # User conversation data
├── 📄 user_stats.json # User statistics
├── 📄 user_feedbacks.json # User feedback data
├── 📄 bot_stats.json # Bot performance statistics
└── 📄 telegram_bot.py # Main bot script
{
"token": "1234567890:ABCdefGhIjKlMnOpQrStUvWxYz"
}🚫 Bot doesn't start
- Ensure your token is correctly formatted in
token.json - Check file permissions
📡 No response from bot
- Check your internet connection
- Verify the bot token is valid
💾 Memory issues
- The bot automatically cleans up old conversations
- Check available disk space
- Ensure you have Python 3.7+ installed
- Run with administrative privileges if needed
- Install required dependencies:
Available in the Read Me file
- The executable may be flagged by antivirus (false positive)
- Add exception for the executable if needed
- Ensure you have .NET Framework installed (if required)
We welcome contributions! Here's how you can help:
# 1. Fork the repository
git fork https://github.com/HAKORADev/telegram-ai-bot
# 2. Create a feature branch
git checkout -b feature/amazing-feature
# 3. Commit your changes
git commit -m 'Add amazing feature'
# 4. Push to the branch
git push origin feature/amazing-feature
# 5. Open a Pull Request- Follow Python PEP 8 style guide
- Add tests for new features
- Update documentation as needed
- Ensure compatibility with Python 3.7+
This project is licensed under the MIT License.
Need help? We've got you covered!
For support and questions:
- 💬 Contact: Reach out via Twitter @HAKORAdev
- 🐍 Built with python-telegram-bot
- 🤖 AI capabilities powered by g4f
- 🌍 Multilingual support with custom translation system
- 🧠 Advanced conversation processing and analysis features
- ✅ Initial release
- ✅ Multilingual support (5 languages)
- ✅ Advanced thinking modes
- ✅ Customizable personality system
- ✅ Web search functionality
- ✅ Comprehensive user statistics
- ✅ Real-time server monitoring
| Self-hosted | Open-source | Zero API fees |
|---|---|---|
| Your server, your rules | MIT-licensed code | Runs on free g4f providers |
After extracting either zip file, please read the included README file for complete installation and setup instructions specific to your version.
👉 Download Executable (Windows)
👉 Download Source Code
Made with ❤️ by HAKORAdev
⭐ Star this repository if you found it helpful! ⭐