priyanshuksharma/telegram_bot repository overview

⁠Telegram Bot

This project is a simple Telegram bot built with Python. The bot responds to user commands and provides information about the creator, Priyanshu K Sharma. It is containerized using Docker for easy deployment.

⁠Features

• Responds to /start with a welcome message
• /help provides a list of available commands and their descriptions
• /content shares information about the creator
• /contact provides contact links (LinkedIn, GitHub)
• Handles unrecognized messages with a default response

⁠Commands

⁠Getting Started

⁠Prerequisites

• Python 3.9+
• Telegram account (to create a bot and get a token)

⁠Installation

1. Clone the repository:

   git clone <repo-url>
   cd Telegram_Bot
   

   Copy

2. Set up virtual environment:

   # Install venv if not available
   sudo apt install python3.12-venv
   
   # Create virtual environment
   python3 -m venv venv
   
   # Activate virtual environment
   source venv/bin/activate
   

   Copy

3. Install dependencies:

   pip install -r requirement.txt
   

   Copy

4. Set up environment variables:

   • Create a .env file in the project root:

     TOKEN=your_telegram_bot_token_here
     

     Copy

5. Run the bot:

   python tele-bot.py
   

   Copy

⁠Docker Usage

You can run the bot inside a Docker container:

1. Build the Docker image:

   docker build -t telegram_bot:latest .
   

   Copy

2. Run the container:

   docker run --env-file .env telegram_bot:latest
   

   Copy

⁠Project Structure

.
├── Dockerfile
├── README.md
├── requirement.txt
├── tele-bot.py
└── telegram_bot/
     └── README.md

⁠Troubleshooting

If you encounter a ValueError: 'token' or 'bot' must be passed error when running the bot in Docker, ensure the following:

• The .env file contains your token as TOKEN=your_token_here (no quotes).
• The Docker image is rebuilt after any changes to .env or code:

  docker build -t telegram_bot .
  

  Copy
• The container is run with the environment file:

  docker run --env-file .env telegram_bot
  

  Copy
• The code uses os.environ.get("TOKEN") (not load_dotenv()) to read the token. This ensures the token is read from Docker's environment variables.

If you need to update your code, make sure to remove or comment out any load_dotenv() lines and use only os.environ.get("TOKEN") for reading the token.

⁠Credits

Created by Priyanshu K Sharma

• LinkedIn⁠
• GitHub⁠

Feel free to contribute or raise issues!