devilxsam / telegraph_image_uploader

Telegram Image Uploader Bot

This Telegram bot allows users to upload images, which are then automatically uploaded to Te.legra.ph, providing direct links to the uploaded images. The bot also welcomes users with a personalized message and an image when they start a chat.

Table of Contents

• Installation
• Usage
• Features
• Dependencies
• Hosting on Heroku
• Hosting on VPS with Docker
• Contributing
• License
• Acknowledgements

Installation

To use this bot, follow these steps:

1. Clone this repository to your local machine:

git clone https://github.com/your-username/telegram-image-uploader-bot.git

2. Install the required Python libraries:

pip install -r requirements.txt

3. Set up your Telegram bot token and image path in config.py.
4. Run the bot script:

python bot.py

Usage

• Start a chat with the bot on Telegram.
• Send an image to upload it to Te.legra.ph.
• Receive direct links to the uploaded image.

Features

• Upload images to Te.legra.ph and get direct links.
• Personalized welcome message with an image.
• Supports only image file types.

Dependencies

• Telebot: Python library for interacting with the Telegram Bot API.
• Requests: HTTP library for making requests in Python.

Hosting on Heroku

To host the bot on Heroku, follow these steps:

1. Create a Heroku account if you don't have one already.
2. Install the Heroku CLI on your machine.
3. Login to Heroku via the CLI using heroku login.
4. Set up your project for deployment (e.g., create a Procfile, requirements.txt, etc.).
5. Push your code to a Heroku Git remote.
6. Scale your app using the Heroku dashboard or CLI.

For detailed instructions, refer to the official Heroku Documentation for deploying and scaling applications.

Hosting on VPS with Docker

To host the bot on a VPS using Docker, follow these steps:

1. Install Docker on your VPS by following the official documentation for your operating system.
2. SSH into your VPS and clone the bot repository:

git clone https://github.com/your-username/telegram-image-uploader-bot.git

3. Build the Docker image:

docker build -t telegram-bot .

4. Run the Docker container:

docker run -d --name telegram-bot-container telegram-bot

Contributing

Contributions are welcome! If you have any suggestions, improvements, or bug fixes, feel free to open an issue or create a pull request.

License

This project is licensed under the MIT License.

Acknowledgements

Special thanks to the developers of Telebot and Requests for their excellent libraries.