🤖 Telegram Bot Template

A clean and scalable Telegram bot template using Pyrotgfork (a forked version of Pyrogram) with multi-language support and SQLite database.

Personal purpose to take advantage from telegram token finder channels and make my due diligences to buy and sell in Solana.

✨ Features

• 🌐 Multi-language support with easy switching
• 💾 SQLite database with SQLAlchemy ORM
• 📅 Task scheduling with APScheduler
• 📁 Clean and organized folder structure
• ⚙️ Environment variables management
• ⚡️ Astral(uv) - extremely fast Python package and project manager
• 🎯 Decorator-based user handling
• 💬 Catch messages from selected telegram chats (groups, channels, etc)
• 🔍 Message handler to find pump fun token
• 🛍️ Buy and Sell token as specific PNL
• Twitter(X) API integration to make due diligences

🚀 Installation

1. Clone the repository:

   git clone https://github.com/espinozasenior/pump-not-fun.git

2. Install requirements:

   uv sync

3. Configure environment variables: Create a .env file with:

   API_ID=your_api_id
   API_HASH=your_api_hash
   BOT_TOKEN=your_bot_token
   SESSION_STRING=your session string token

4. Run the bot:

   uv run main.py

📖 How to Use

Follow these simple steps to customize the bot:

1. Add your commands in the commands folder
2. Add your callbacks in the callbacks folder
3. Add your messages handler in the messages folder
4. Register commands, callbacks and messages handlers in handlers.py file
5. Register tasks in tasks.py file
6. Add new languages in the languages folder
7. Create database models in the database folder

📈 Scaling to PostgreSQL (Optional)

To upgrade to PostgreSQL:

1. Install PostgreSQL adapter:

   uv add psycopg2-binary

2. Update database configuration: In settings.py, modify the DATABASE_URL:

   DATABASE_URL=postgresql://user:password@localhost/dbname

📝 Note

This template follows Telegram bot development best practices and can be customized to suit your needs. For custom implementations, please reach out to us at any of the following links:

• Telegram
• Discord

🤝 Contributing

• Create a new branch for your features
• Submit pull requests for improvements
• Open issues for bugs or suggestions

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.