https://github.com/mscbuild/telegram-bot-examples
Telegram bot examples. The examples in this folder are small bots meant to show you how a bot that is written with python-telegram-bot looks like.
https://github.com/mscbuild/telegram-bot-examples
api development email-sender example finance python task telegram telegrambot
Last synced: 6 months ago
JSON representation
Telegram bot examples. The examples in this folder are small bots meant to show you how a bot that is written with python-telegram-bot looks like.
- Host: GitHub
- URL: https://github.com/mscbuild/telegram-bot-examples
- Owner: mscbuild
- License: mit
- Created: 2025-07-11T12:28:03.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-07-11T14:12:03.000Z (7 months ago)
- Last Synced: 2025-07-11T15:27:07.878Z (7 months ago)
- Topics: api, development, email-sender, example, finance, python, task, telegram, telegrambot
- Language: Python
- Homepage:
- Size: 27.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Telegram-bot-examples python
This repository contains example Python scripts for building Telegram bots using the `python-telegram-bot` library. These examples demonstrate various functionalities, such as responding to messages, handling commands, and integrating with Telegram's API.
## Table of Contents
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage](#usage)
- [Examples](#examples)
- [Contributing](#contributing)
- [License](#license)
## Prerequisites
- Python 3.8 or higher
- A Telegram account and a bot token from [BotFather](https://t.me/BotFather)
- Basic knowledge of Python and Telegram's Bot API
## Installation
1. **Clone the repository**:
```bash
git clone https://github.com/mscbuild/Telegram-bot-examples.git
cd Telegram-bot-examples
```
2. **Create a virtual environment** (optional but recommended):
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. **Install dependencies**:
```bash
pip install -r requirements.txt
```
4. **Set up your bot token**:
- Create a `.env` file in the project root.
- Add your bot token:
```env
TELEGRAM_BOT_TOKEN=your-bot-token-here
```
## Usage
1. Ensure your environment is activated and dependencies are installed.
2. Run any example script:
```bash
python examples/echo_bot.py
```
3. Interact with your bot on Telegram by sending commands or messages as described in each example.
## Examples
The `examples/` directory contains the following scripts:
- **`echobot.py`**: A simple bot that echoes back any text message it receives.
- **`task.py`**: A Telegram bot for assigning tasks.
- **`email.py`**: This bot is an email client that works right inside Telegram.
- **`finances.py`**: This bot that allows you to keep track of finances.
- **`chatbot.py`**: The free chatbot by AI .
Each script includes comments explaining the code and its functionality. To run an example, ensure your bot token is set in the `.env` file, then execute the script.
## Contributing
Contributions are welcome! To contribute:
1. Fork the repository.
2. Create a new branch.
3. Make your changes and commit.
4. Push to the branch.
5. Open a pull request.
Please ensure your code follows PEP 8 style guidelines and includes appropriate comments.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.