https://github.com/leviobrabo/channel-historys-bot
A Telegram bot that retrieves and displays historical data, including events and images. Built with Python, it features well-structured logging, configuration management, and database interaction.
https://github.com/leviobrabo/channel-historys-bot
channel-history history mongodb pytelegrambotapi wikipedia wikipedia-api wikipedia-scraper
Last synced: 3 months ago
JSON representation
A Telegram bot that retrieves and displays historical data, including events and images. Built with Python, it features well-structured logging, configuration management, and database interaction.
- Host: GitHub
- URL: https://github.com/leviobrabo/channel-historys-bot
- Owner: leviobrabo
- Created: 2023-12-05T03:24:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-03T23:29:43.000Z (9 months ago)
- Last Synced: 2025-01-21T09:48:36.921Z (4 months ago)
- Topics: channel-history, history, mongodb, pytelegrambotapi, wikipedia, wikipedia-api, wikipedia-scraper
- Language: Python
- Homepage: https://t.me/history_channels
- Size: 12.6 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: history/__init__.py
Awesome Lists containing this project
README
# Telegram Historical Bot
This project is a Telegram bot designed to fetch and display historical data and events. It supports multiple features such as fetching historical images, events, and other related data. The bot is built using Python and leverages several libraries to manage data retrieval and processing.
## Features
- **Historical Data Fetching:** Retrieves historical data such as events, birthdays, and other relevant information.
- **Image Handling:** Supports fetching and processing historical images.
- **Logging and Configuration:** Well-structured logging and configuration files to manage the bot's operations.
## Project Structure
- `data/`: Directory containing the data files.
- `history/`: Contains scripts to update and manage historical data.
- `imgs/`: Stores images used or fetched by the bot.
- `.gitignore`: Git ignore file for excluding unnecessary files.
- `Procfile`: Configuration file for deploying on Heroku.
- `README.md`: Project documentation.
- `bot.conf`: Main configuration file for the bot.
- `bot.py`: Core bot logic and event handling.
- `db.py`: Database interaction script.
- `get_historical.py`: Script for fetching historical data.
- `logger.py`: Handles logging across the application.
- `main.py`: Main entry point for running the bot.
- `requirements.txt`: Python dependencies required for the project.
- `sample.bot.conf`: Sample configuration file for reference.
## How to Use
1. **Install dependencies:**
```bash
pip install -r requirements.txt
```
2. **Configure the bot:**
- Edit the `bot.conf` or use the `sample.bot.conf` to set up your bot's configuration.
3. **Run the bot:**
```bash
python main.py
```
## Contributing
Contributions are welcome! Feel free to submit pull requests, report issues, or suggest improvements.
## License
This project is licensed under the MIT License.