🎉 Hacktoberfest 2025 – Open Source Telegram Bots

Open-source Telegram Bots Repository
A collection of Telegram Bot source codes organized by programming language and framework.

---

💡 About Hacktoberfest 2025

Hacktoberfest is an annual global celebration of open source software, powered by DigitalOcean, Appwrite, and Docker.

From October 1 to October 31, 2025, you can participate by contributing to open source projects on GitHub or GitLab.
Make 4 or more quality pull requests (PRs) and you’ll earn exclusive rewards — either a limited-edition Hacktoberfest T-shirt or have a tree planted in your name 🌱.

✅ Participation Rules (as per Hacktoberfest 2025)

• Register anytime between October 1–31, 2025 at hacktoberfest.com.
• Submit 4 accepted pull requests to public repositories labeled with:
  • hacktoberfest, or
  • hosted on an opt-in repository (this repo is participating ✅).
• Contributions must be meaningful and follow the project’s guidelines.
• Spammy, low-effort, or duplicate PRs will be marked as invalid and disqualified.

Note: PRs that are labeled as invalid, spam, or do not follow contribution rules will not count toward Hacktoberfest.

---

🧠 What Is This Repository?

This repository contains open-source Telegram bot projects written in various programming languages using official and third-party frameworks.

You can contribute by:

• Adding your own Telegram bot source code.
• Improving existing projects (fix bugs, refactor, or enhance documentation).
• Adding new examples using different Telegram frameworks.

---

🚀 How Can I Contribute?

1. Fork this repository.
2. Add your bot’s code under the corresponding language folder.
   • Example:

     python/my_telegram_bot/
     javascript/weather_bot/
     

   • If the folder does not exist, create it.
   • For framework-based projects, create a subfolder (e.g., python/aiogram/).
3. Add a README.md inside your folder describing:
   • Bot’s name & purpose
   • Setup instructions
   • Dependencies
4. Commit your changes with a clear message.
5. Push your branch and open a Pull Request (PR) to main with a descriptive title.

Example PR title:

Added Telegram Weather Bot in Python using Aiogram

---

⚙️ Contribution Guidelines

• Ensure your code runs successfully before submitting.
• Keep your code clean and well-documented.
• Avoid adding large files, sensitive data, or API keys.
• Use .gitignore where necessary.
• One bot per pull request (makes reviewing easier).
• Respect the Code of Conduct.

💬 If you’re a beginner, don’t worry! Small contributions such as improving docs or fixing typos are also valuable.

---

🌱 Get Started with Open Source

If you’re new to contributing, here are some helpful guides:

• How to Contribute to Open Source on GitHub
• DigitalOcean: How to Create a Pull Request
• Git Cheat Sheet
• Understanding Open Source Licenses

---

📜 Code of Conduct

By participating in this project, you agree to uphold our Code of Conduct.
We are committed to maintaining a welcoming and inclusive environment for everyone.

---

⭐ Support & Share

If you find this repository helpful:

• Star ⭐ it on GitHub.
• Share it with your friends.
• Encourage more developers to contribute and learn open source!

---

Contributors Hall of Fame

---

Let’s make open-source better together 💪

Happy Hacking & Happy Hacktoberfest 2025! 🎃