> For the complete documentation index, see [llms.txt](https://falah.gitbook.io/byethost-support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://falah.gitbook.io/byethost-support/telegram-bot-documentation.md).

# Telegram Bot - Documentation

Telegram Leak Checker Bot – Powered by AI 📡

**Developer:** [@0xFaLaH](https://t.me/Xfff0800)\
**Platform:** Python 3 (Linux - <mark style="color:yellow;">VPS</mark>)\
Version: `3.0v`

<figure><img src="https://sp-ao.shortpixel.ai/client/to_auto,q_lossless,ret_img/https://bye-thost.com/wp-content/uploads/2023/05/img_5168.jpeg" alt="" width="375"><figcaption><p><a href="https://bye-thost.com/product/bot_telegram/">https://bye-thost.com/product/bot_telegram</a></p></figcaption></figure>

A smart Telegram bot that helps users check for leaked credentials using email or username, powered by Snusbase API and OpenAI (ChatGPT)

> ✅ VPS-only support for performance, security, and 24/7 uptime

***

#### 🔧 Features

* 🔍 **Email Leak Lookup**: Check if your email appears in known data breaches.
* 🔍 **Username Leak Lookup**: Find if usernames are associated with compromised accounts.
* 🤖 **AI Chat Assistant**: Built-in GPT support for asking questions or debugging data.
* ⚙️ **Snusbase API integration**: Real-time leak data from reputable databases.
* 🚀 Optimized for VPS: Efficient performance and persistent uptime.

***

#### 📨 Step 1: Download the Bot File

* Check your email inbox for a message titled `Telegram Leak Bot – Source Code`.
* Download the attached ZIP file (e.g., `bot-telegram.zip`) to your **local computer** (Windows or Mac).

***

#### 📂 Step 2: Transfer Files to Your VPS using FileZilla

1. **Download FileZilla Client**\
   → <https://filezilla-project.org/download.php>
2. **Open FileZilla**, and connect to your VPS:
   * **Host**: Your VPS IP address
   * **Username**: e.g., `root`
   * **Password**: Your VPS root password
   * **Port**: 22
3. After successful login:
   * On the **left panel**, browse to where you saved `bot-telegram.zip`.
   * On the **right panel**, browse to `/root/` or `/home/youruser/`.
4. **Drag and drop** the ZIP file from left to right to upload it to the VPS.

***

#### 💻 Step 3: Connect to VPS & Extract the Files

1. Open **Terminal** (Linux) or **PuTTY** (Windows) and SSH into your server:

```bash
ssh root@your-vps-ip
```

2. After login, go to the location where you uploaded the file:

```bash
cd /root
unzip bot-telegram.zip
cd bot-telegram
```

> If unzip isn't installed, run: `apt install unzip`

***

#### 📦 Step 4: Set Up the Bot Environment

```bash
# Install Python and pip if not already installed
apt update && apt install python3 python3-pip python3-venv -y

# Create virtual environment (optional)
python3 -m venv venv
source venv/bin/activate

# Install required libraries
pip install -r requirements.txt
```

#### 🔑 Configuration Step 5: Add Your API Keys

Edit `main.py` and replace the following:

```python
API_TOKEN = 'your_telegram_api_key'
api_key = 'your_snusbase_api_key'
openai.api_key = "your_openai_api_key"
```

Use `nano` or any text editor:

```bash
nano main.py
```

***

#### 🚀 Step 6: Run the Bot in Background

This bot supports **daemon mode** to keep it running in the background:

```bash
python3 main.py
```

The bot will now respond to your Telegram commands.

***

#### 🔁 To Restart or Stop the Bot

```bash
# Stop the bot
pkill -f main.py

# Restart
python3 main.py
```

***

#### 🤖 Telegram Commands

| Command  | Description                        |
| -------- | ---------------------------------- |
| /start   | Bot introduction and feature guide |
| /help    | Support information                |
| /email   | Check leaks using email            |
| /twitter | Check leaks using username         |
| /chatgpt | Talk to AI assistant               |
| /stop    | Stop and restart bot               |
| /back    | Go back to main menu               |

***

#### 📚 Notes

* Bot is optimized for use on a **VPS only** to ensure continuous performance and privacy.
* Your keys (Telegram, Snusbase, OpenAI) must remain secure.
* AI support via ChatGPT (GPT-3.5 Turbo) is integrated and auto-responds within the bot.
* This tool is educational and security-oriented. Use ethically and legally.

***