Telegram - News AI Bot

TeleNewsPy🕊️

Description

The Telegram News AI Bot is an intelligent bot that fetches and delivers the latest news to users on Telegram. It leverages Gemini AI to process NLP queries and provide interactive news updates based on user queries (topics & keywords). This project is built using AIOgram, FastAPI and other python libraries!

It uses NewsAPI to fetch recent news data!

BOT GIFs

           

Features

• Recent news articles
• NLP Prompt with AI
• Quick & Personalized Updates
• Concise, readable chunks of news
• Easy Interface with Telegram

Usage

There are two ways to use the Telegram News AI Bot:

1. Live Deployed Bot:

   • Interact with the live bot on Telegram: TeleNewsPy🕊️
   • Simply start the bot and follow the prompts to receive news updates.

2. Local Installation:

   • Follow the installation instructions below to set up and run the bot on your local machine.

Setup

Prerequisites

• Python 3.8+
• pip (Python package installer)

Installation

1. Clone the repository:

git clone https://github.com/DarkDk123/News_AI_BOT.git
cd News_AI_BOT

2. Install the required dependencies:

pip install -r "requirements.txt"

3. Set up environment variables:

Create a .env file in the root directory and add the necessary environment variables. Refer to the env_example file for guidance.

Running the Bot

1. Run the main.py file from root directory:

python "TelegramBot/main.py" # Command should be the same!

Once the server is running, the bot will deliver articles to the configured Telegram chat. You can interact with the bot using the Telegram app to make NLP queries and receive interactive news updates based on your queries.

Contributing Guidelines

We welcome contributions! Follow these steps:

1. Fork the repository and clone your fork locally:

   git clone https://github.com/your-username/News_AI_BOT.git
   cd News_AI_BOT

2. Set up the project:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   pip install -r requirements.txt

3. Set up pre-commit hooks:

   pip install pre-commit
   pre-commit install # Checks code quality & other formatting.

4. Create a branch:

   git checkout -b feature-branch

5. Ensure code quality:

   • Format: ruff format --check .
   • Lint: ruff check .

6. Make your changes, then commit and push:

   git commit -m "Describe your changes"
   git push origin feature-branch

7. Open a pull request on GitHub.

For any questions or feedback, please open an issue on GitHub or contact the project maintainers.

License

This project is licensed under the GPL 3.0 License. See the LICENSE file for more details.