{"id":24929933,"url":"https://github.com/hridesh-net/turons_agent","last_synced_at":"2025-06-23T21:38:49.004Z","repository":{"id":269835674,"uuid":"907990375","full_name":"hridesh-net/Turons_agent","owner":"hridesh-net","description":"A Latest News Filter and Notifier! 🚀 Keep yourself updated with the latest news in the easiest way possible. Whether you’re into tech, fashion, sports, or any other topic, this project lets you stay informed with customized news updates and concise content summaries.","archived":false,"fork":false,"pushed_at":"2024-12-29T18:10:01.000Z","size":1039,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T13:44:28.664Z","etag":null,"topics":["ai","aiagentsframework","automation","langgraph-python","llms","news","python","technology"],"latest_commit_sha":null,"homepage":"https://github.com/hridesh-net/Turons_agent","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hridesh-net.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-12-24T19:51:44.000Z","updated_at":"2025-03-18T19:50:48.000Z","dependencies_parsed_at":"2025-03-28T13:40:27.597Z","dependency_job_id":"b70ccafe-69f9-4456-a43f-e537160520ee","html_url":"https://github.com/hridesh-net/Turons_agent","commit_stats":null,"previous_names":["hridesh-net/turons_agent"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/hridesh-net/Turons_agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hridesh-net%2FTurons_agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hridesh-net%2FTurons_agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hridesh-net%2FTurons_agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hridesh-net%2FTurons_agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hridesh-net","download_url":"https://codeload.github.com/hridesh-net/Turons_agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hridesh-net%2FTurons_agent/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261560799,"owners_count":23177457,"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":["ai","aiagentsframework","automation","langgraph-python","llms","news","python","technology"],"created_at":"2025-02-02T13:52:24.639Z","updated_at":"2025-06-23T21:38:48.964Z","avatar_url":"https://github.com/hridesh-net.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Header Image](images/Turons%20Letter%20(2).png)\n\n# 📰 Turons Agent\nLatest News Filter and Notifier\n\nWelcome to the Latest News Filter and Notifier! 🚀\nKeep yourself updated with the latest news in the easiest way possible. Whether you’re into tech, fashion, sports, or any other topic, this project lets you stay informed with customized news updates and concise content summaries.\n\n----\n\n### 🌟 Features\n\n#### 1.\tPersonalized News Updates:\n\nDefault category is Technology, but you can change it to any topic you like (e.g., health, business, entertainment).\n\n#### 2.\tAI-Powered Filtering\n\nNot all “tech” news is actually about tech. Our built-in AI filters ensure you get relevant, high-quality articles.\n\n#### 3.\tHalf-Minute Reads\n\nDon’t have time to read long articles? The project summarizes news into easy-to-read, concise content so you can stay informed in just 30 seconds.\n\n#### 4.\tSeamless Integration with DynamoDB\n\nAll filtered news articles are stored in AWS DynamoDB with their content and status for easy management and tracking.\n\n#### 5.\tNotifications for Latest Articles\n\nThe project keeps you up-to-date by notifying you whenever new, relevant articles are available.\n#### 6.\tTwo Modes to Run\n\n- main.py: For a straightforward execution.\n\n- lg_app.py: The LangGraph-powered version, offering a modular, state-based workflow for advanced use cases.\n-----\n\n### 🏗️ Project Structure\n\nHere’s a breakdown of the project directory:\n```bash\n.\n├── main.py                 # The simple version of the application\n├── lg_app.py               # The LangGraph-powered version\n├── nodes/                  # State nodes for LangGraph\n│   ├── db_node.py          \n│   ├── filter_tech_article.py \n│   ├── generate_article.py \n│   ├── generate_prompt.py  \n│   ├── state_manager.py    \n├── utils/                  # Utility functions and classes\n│   ├── aws_utils.py        \n│   ├── base_utils_class.py \n│   ├── data_utils.py       \n└── README.md\n```\n----\n\n\n### 🚀 How It Works\n\n#### 1️⃣ Fetch News\n\nUsing the NewsData API, the project fetches the latest news articles from the selected category (default: technology).\n\n#### 2️⃣ AI-Powered Filtering\n\nArticles are passed to an AI agent to identify the most relevant ones for your chosen category.\n\n#### 3️⃣ Content Summarization\n\nFiltered articles are summarized into concise, engaging pieces that you can read in half a minute. AI ensures summaries are simple, understandable, and free of clutter.\n\n#### 4️⃣ Store and Notify\n\nFiltered articles are stored in AWS DynamoDB with their summaries and status. Notifications ensure you’re always updated.\n\n----\n\n### 🛠️ How to Use\n\n#### Prerequisites\n- Python 3.12+\n- AWS account with DynamoDB configured\n- NewsData API key\n- Groq API key\n\n#### Installation\n1.\tClone this repository:\n```bash\ngit clone https://github.com/your-repo/latest-news-filter.git\ncd latest-news-filter\n```\n\n2.\tInstall dependencies:\n```bash\npip install -r requirements.txt\n```\n\n3.\tConfigure environment variables:\nCreate a .env file with the following variables:\n\n```bash\nNEWS_API_KEY=your_newsdata_api_key\nGROQ_API_KEY=your_groq_api_key\nAWS_REGION=your_aws_region\nAWS_ACCESS_KEY=your_aws_access_key\nAWS_SECRET_KEY=your_aws_secret_key\nDYNAMODB_TABLE=TechNews\n```\n\n\n#### Running the Application\n\n1. Simple Mode\n```bash\npython main.py\n```\n2. LangGraph Mode\n```bash\npython lg_app.py\n```\n----\n\n### ✨ Why Choose This Project?\n1.\tScalable and Modular\n\nWhether you’re a beginner or an advanced user, this project is easy to use and extend.\n\n2.\tStay Updated\n\nGet personalized, summarized news updates every day without spending hours scrolling.\n\n3.\tAI-Powered Precision\n\nLeverages cutting-edge AI for content filtering and summarization.\n\n4.\tCustomizable\n\nEasily switch categories to focus on what matters to you.\n\n----\n\n# 🤝 Contribution\n\nWe love contributions! If you have ideas to improve this project or want to fix something, feel free to fork the repo and create a pull request.\n\n---\n\n# 🛡️ Disclaimer\n\nThis project uses external APIs and services. Ensure you comply with their terms of use.\n\nEnjoy staying informed effortlessly with Latest News Filter and Notifier! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhridesh-net%2Fturons_agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhridesh-net%2Fturons_agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhridesh-net%2Fturons_agent/lists"}