Building Telegram Bots Made Simple: A Beginner-Friendly Boilerplate

If you've ever wanted to create a Telegram bot but felt overwhelmed by the complexity, I've got you covered! Let me introduce you to a simple, beginner-friendly boilerplate that makes starting your Telegram bot project a breeze.

Here’s everything you need to know to get started with this boilerplate, step by step.

🛠️ What Is This Boilerplate?

This boilerplate is a ready-to-use framework for creating Telegram bots using Pyrogram, a powerful Python library for interacting with the Telegram Bot API.

It’s designed to:

• Save time by setting up a basic structure for your project.
• Keep your code clean and organized using a modular approach.
• Help you focus on building cool features instead of worrying about setup.

You can check it out here: GitHub Repository

🚀 Why Use This Boilerplate?

1. Simplicity: You don’t need to start from scratch—just plug in your details and go.
2. Modular Design: Commands and features are organized into separate files, making it easy to add or modify functionality.
3. Beginner-Friendly: Even if you’re new to Python or Pyrogram, the structure makes it easy to understand.
4. Quick Setup: With just a few commands, your bot will be up and running in minutes.

📂 Project Structure

Here’s a quick look at how everything is organized:

tgbot-boilerplate/ 
├── plugins/ # All your bot commands and features │ 
├── callback.py # Example for handling button clicks (callbacks) 
│ └── commands.py # Example for basic commands like /start 
├── bot.py # Main file that runs the bot 
├── db.py # Placeholder for database connection (if needed) 
├── vars.py # Handles environment variables like API keys 
├── requirements.txt # Python dependencies 
└── .env # Your API keys and bot credentials (ignored by Git)	

📝 Step-by-Step Guide to Get Started

1. Clone the Repository

First, grab the boilerplate from GitHub and navigate into the project directory:

git clone https://github.com/biisal/tgbot-boilerplate.git  
cd tgbot-boilerplate  

2. Install Dependencies

Make sure you have Python 3.9 or higher installed. Install the required Python libraries using:

pip install -r requirements.txt  

3. Set Up Your Bot Credentials

• Go to Telegram BotFather and create a bot.
• Note down the API ID, API Hash, and Bot Token provided by BotFather.

Next, create a .env file in the project root and add the following:

API_ID=your_api_id  
API_HASH=your_api_hash  
BOT_TOKEN=your_bot_token  
ADMIN=your_telegram_user_id  

4. Run the Bot

Now, it’s time to launch your bot! Just run:

python3 bot.py  

🎉 That’s it! Your bot is now live and ready to respond.

✨ Cool Features in the Boilerplate

Example Command: /start

When users type /start, they get a friendly message along with an inline keyboard:

@Client.on_message(filters.command("start") & filters.incoming)  
async def start(client: Client, message: Message):  
    await message.reply_text(  
        f"**Hello {message.from_user.first_name}!**\nThis boilerplate is ready to go.",  
        reply_markup=InlineKeyboardMarkup(  
            [  
                [  
                    InlineKeyboardButton("Help", url="https://t.me/devdoptpy"),  
                    InlineKeyboardButton("Callback ping", callback_data=f"ping#{message.from_user.id}")  
                ]  
            ]  
        )  
    )  

Example Callback

The boilerplate also includes an example of handling button callbacks using the callback.py file.

🌟 Why This Boilerplate Is Perfect for Beginners

• No Messy Setup: The project is already organized—you can just dive into writing commands.
• Customizable: Add features like databases, APIs, or advanced commands without breaking a sweat.
• Pyrogram Power: Pyrogram simplifies interactions with Telegram, giving you more time to focus on your bot’s logic.

💡 Tips for Expanding Your Bot

1. Add New Commands: Create new Python files in the plugins/ folder for different commands.
2. Integrate Databases: Use db.py to connect your bot to a database like MongoDB or PostgreSQL.
3. Explore Pyrogram Docs: Learn about the full range of features Pyrogram offers here.

🤝 Contribute and Customize

This boilerplate is open-source, and contributions are welcome! If you have ideas or improvements, feel free to fork the repo and create a pull request.

🚀 Ready to Build Your Own Telegram Bot?

Start your journey with this boilerplate:
👉 GitHub Repository

Let’s build something awesome together! 🎉