{"id":18736980,"url":"https://github.com/darkdk123/news_ai_bot","last_synced_at":"2025-07-20T10:32:57.944Z","repository":{"id":232092195,"uuid":"772528956","full_name":"DarkDk123/News_AI_BOT","owner":"DarkDk123","description":"A Small project for Telegram BOT, providing concise, digestible chunks of news updates from various sources as per desired news topics","archived":false,"fork":false,"pushed_at":"2025-06-25T20:16:34.000Z","size":14698,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-25T21:19:58.052Z","etag":null,"topics":["aiogram-bot","function-calling","gemini-api","google-gemini-ai","news-api-org","news-bot","newsapi","python-bot","python3","telegram-bot"],"latest_commit_sha":null,"homepage":"https://web.telegram.org/k/#@TeleNewsPy_Bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DarkDk123.png","metadata":{"files":{"readme":"README.md","changelog":"NewsFetchClasses/Fetch_news.py","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-03-15T11:21:51.000Z","updated_at":"2025-06-25T20:19:53.000Z","dependencies_parsed_at":"2024-04-15T13:58:02.010Z","dependency_job_id":"b1fb2bfe-e670-4a10-8816-af2a8848d6a1","html_url":"https://github.com/DarkDk123/News_AI_BOT","commit_stats":null,"previous_names":["darkdk123/news_ai_bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DarkDk123/News_AI_BOT","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarkDk123%2FNews_AI_BOT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarkDk123%2FNews_AI_BOT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarkDk123%2FNews_AI_BOT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarkDk123%2FNews_AI_BOT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DarkDk123","download_url":"https://codeload.github.com/DarkDk123/News_AI_BOT/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarkDk123%2FNews_AI_BOT/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266111431,"owners_count":23877980,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiogram-bot","function-calling","gemini-api","google-gemini-ai","news-api-org","news-bot","newsapi","python-bot","python3","telegram-bot"],"created_at":"2024-11-07T15:23:14.525Z","updated_at":"2025-07-20T10:32:57.897Z","avatar_url":"https://github.com/DarkDk123.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n  # \u003cspan align=\"center\"\u003e Telegram - News AI Bot\u003c/span\u003e\n  \u003cimg src=\"./images/Bot_Profile.jpeg\" alt=\"Bot Profile\" width=\"30%\"\u003e\n\n\u003c/div\u003e\n\u003cbr\u003e\n\u003ch1 align=\"center\"\u003e\n\n[TeleNewsPy🕊️](https://web.telegram.org/k/#@TeleNewsPy_Bot)\n\n[![TeleNewsPy Status](https://cronitor.io/badges/WwEpyi/production/_tkad06ybaR-xchTipqEpYL9_10.svg)](https://news-ai-bot.onrender.com)\n\n![GitHub stars](https://img.shields.io/github/stars/DarkDk123/News_AI_BOT?style=plastic\u0026label=Stars\u0026color=blue\u0026labelColor=grey\u0026logo=github)\n[![license](https://img.shields.io/github/license/DarkDk123/News_AI_BOT?color=blue\u0026label=License\u0026style=plastic)](https://github.com/DarkDk123/News_AI_BOT/blob/main/LICENSE)\n[![developer](https://img.shields.io/static/v1?label=Author\u0026message=DarkDk123\u0026color=blue\u0026style=plastic)](https://github.com/DarkDk123)\n\u003c/h1\u003e\n\n\n\n## Description\n\nThe **Telegram News AI Bot** is an intelligent bot that fetches and delivers the latest news to users on Telegram.\nIt leverages [Gemini AI](https://ai.google.dev/gemini-api) to process **NLP queries** and\nprovide interactive news updates based on user queries (topics \u0026 keywords). This project is built using\n[AIOgram](https://github.com/aiogram/aiogram), [FastAPI](https://github.com/tiangolo/fastapi) and other python libraries!\n\nIt uses [NewsAPI](https://newsapi.org) to fetch recent news data!\n\n\n\u003cdiv align=\"center\"\u003e\n\n### BOT GIFs\n\n\u003cimg src=./images/demo.gif height=400\u003e\u003c/img\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003cimg src=./images/demo2.gif height=400\u003e\u003c/img\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003cimg src=./images/demo3.gif height=400\u003e\u003c/img\u003e\n\u003c/div\u003e\n\n## Features\n\n- Recent news articles\n- NLP Prompt with AI\n- Quick \u0026 Personalized Updates\n- Concise, readable chunks of news\n- Easy Interface with Telegram\n\n## Usage\n\nThere are two ways to use the Telegram News AI Bot:\n\n1. **Live Deployed Bot**:\n   - Interact with the live bot on Telegram: [TeleNewsPy🕊️](https://web.telegram.org/k/#@TeleNewsPy_Bot)\n   - Simply start the bot and follow the prompts to receive news updates.\n\n2. **Local Installation**:\n   - Follow the installation instructions below to set up and run the bot on your local machine.\n\n\n## Setup\n\n### Prerequisites\n\n- Python 3.8+\n- pip (Python package installer)\n\n### Installation\n\n#### 1. Clone the repository:\n\n   ```sh\n   git clone https://github.com/DarkDk123/News_AI_BOT.git\n   cd News_AI_BOT\n   ```\n\n#### 2. Install the required dependencies:\n\n   ```sh\n   pip install -r \"requirements.txt\"\n   ```\n\n#### 3. Set up environment variables:\n   \u003e Create a `.env` file in the root directory and add the necessary environment variables. Refer to the [`env_example`](https://github.com/DarkDk123/News_AI_BOT/blob/main/env_example) file for guidance.\n\n### Running the Bot\n\n#### 1. Run the `main.py` file from root directory:\n\n   ```sh\n   python \"TelegramBot/main.py\" # Command should be the same!\n   ```\n\nOnce the server is running, the bot will deliver articles to the configured Telegram chat.\nYou can interact with the bot using the Telegram app to make NLP queries and receive\ninteractive news updates based on your queries.\n\n## Contributing Guidelines\n\nWe welcome contributions! Follow these steps:\n\n1. **[Fork](https://github.com/DarkDk123/News_AI_BOT/fork) the repository** and **clone your fork** locally:\n\n   ```sh\n   git clone https://github.com/your-username/News_AI_BOT.git\n   cd News_AI_BOT\n   ```\n\n2. **Set up the project**:\n\n   ```sh\n   python -m venv .venv\n   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\n   pip install -r requirements.txt\n   ```\n\n3. **Set up pre-commit hooks**:\n\n   ```sh\n   pip install pre-commit\n   pre-commit install # Checks code quality \u0026 other formatting.\n   ```\n\n4. **Create a branch**:\n\n   ```sh\n   git checkout -b feature-branch\n   ```\n\n5. **Ensure code quality**:\n\n   * Format: `ruff format --check .`\n   * Lint: `ruff check .`\n\n6. **Make your changes**, then commit and push:\n\n   ```sh\n   git commit -m \"Describe your changes\"\n   git push origin feature-branch\n   ```\n\n7. **Open a pull request** on GitHub.\n\n\nFor any questions or feedback, please open an issue on GitHub or contact the [project maintainers](https://github.com/DarkDk123/News_AI_BOT/contributors).\n\n## License\n\nThis project is licensed under the ***GPL 3.0*** License. See the [`LICENSE`](https://github.com/DarkDk123/News_AI_BOT/blob/main/LICENSE) file for more details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarkdk123%2Fnews_ai_bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarkdk123%2Fnews_ai_bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarkdk123%2Fnews_ai_bot/lists"}