📰 Current Affairs Feed - UPSC/SSC Exam Preparation

Your AI-powered daily current affairs companion for competitive exam preparation

🚀 Quick Start

Try the live app: current-affairs-app.streamlit.app

No installation needed! Just click and start practicing.

✨ Features

🤖 AI-Powered Processing

Dual AI System:
- Groq Llama-3.1 (Bulk Processing) - Lightning-fast article analysis
- Google Gemini (Premium Chat) - Intelligent Q&A responses
Smart Relevance Scoring - AI rates each article 1-10 for exam relevance
Automatic Filtering - Only shows high-quality, exam-focused content

📚 Interactive Learning

Interactive MCQs - Click-to-answer with instant feedback
Retry & New Question - Practice multiple questions per article
Exam-Focused Summaries - 3-4 line summaries highlighting key facts
Subject Tags - Identifies syllabus areas (Polity, Economy, etc.)

📅 Advanced Filtering

Date Range Selection - View articles from any date range
Quick Filters - One-click access to Today, Yesterday, Last 7/30 days
Date Statistics - Article count breakdown by date
Multi-Source Support - Filter by The Hindu, PIB, Times of India, etc.

⚡ Automation

Daily Auto-Fetch - GitHub Actions fetches news every day at 6 AM IST
Auto-Processing - AI analyzes and generates MCQs automatically
Auto-Save to Google Sheets - No manual work required
Zero Maintenance - Wake up to fresh content daily

💬 AI Chat Assistant

Ask questions about current affairs
Get exam-focused explanations
Context-aware responses based on today's news

🎯 Who Is This For?

UPSC Aspirants - Civil Services preparation
SSC Candidates - Staff Selection Commission exams
Banking Exams - Current affairs for IBPS, SBI, RBI
State PSC - Regional competitive exams
General Knowledge - Stay updated with relevant news

🛠️ Tech Stack

Component	Technology	Purpose
Frontend	Streamlit	Interactive web interface
Bulk AI	Groq (Llama-3.1)	Fast article processing (unlimited free)
Premium AI	Google Gemini	High-quality chat responses
News API	NewsData.io	Multi-source news aggregation
Backup RSS	The Hindu, PIB	Fallback news sources
Database	Google Sheets	Cloud storage
Automation	GitHub Actions	Daily scheduled tasks
Deployment	Streamlit Cloud	Free hosting

📸 Screenshots

Main Feed with Date Filtering

🔍 Filter Articles
[📅 Today] [📆 Yesterday] [📊 Last 7 Days] [📈 Last 30 Days]

📅 From Date: [Select]    📅 To Date: [Select]

Filter by source: [The Hindu ✓] [PIB ✓] [Times of India ✓]

📄 Articles: 15    ⭐ Avg Score: 8.2/10    📅 Days: 3

Interactive MCQ Practice

❓ Question: Which international organization recently announced...?

[A) United Nations       ]  [B) World Bank          ]
[C) International Monetary Fund]  [D) World Trade Organization]

✅ Correct! Well done!
💡 Explanation: The IMF announced new economic forecasts...

[🔄 Retry This Question]  [🎲 Generate New Question]

🚀 Getting Started

For Users (No Setup Required)

Visit the app: current-affairs-app.streamlit.app
Browse articles - Filtered and ready to study
Practice MCQs - Interactive questions with instant feedback
Use date filters - Revise any past date
Ask questions - Get AI-powered explanations

For Developers (Self-Hosting)

Prerequisites

Python 3.11+
Groq API Key (free at console.groq.com)
Google Gemini API Key (free at aistudio.google.com)
NewsData.io API Key (optional, free at newsdata.io)
Google Sheets with public access

Installation

Clone the repository

git clone https://github.com/Prateekray/current-affairs-app.git
cd current-affairs-app

Install dependencies

pip install -r requirements.txt

Set up secrets

Create .streamlit/secrets.toml:

GROQ_API_KEY = "your-groq-api-key"
GEMINI_API_KEY = "your-gemini-api-key"
NEWSDATA_API_KEY = "your-newsdata-api-key"
SHEET_ID = "your-google-sheet-id"

Run the app

streamlit run streamlit_app.py

Open browser

http://localhost:8501

🤖 Automation Setup (Optional)

The app automatically fetches news daily at 6 AM IST using GitHub Actions.

Enable Automation

Set up Google Sheets API:
- Create a service account at console.cloud.google.com
- Download JSON credentials
- Share your Google Sheet with the service account email
Add GitHub Secrets:
- Go to your repo → Settings → Secrets and variables → Actions
- Add these secrets:
  - GROQ_API_KEY
  - GEMINI_API_KEY
  - NEWSDATA_API_KEY
  - SHEET_ID
  - GOOGLE_CREDENTIALS_JSON (entire JSON file content)
The workflow runs automatically!
- Every day at 6:00 AM IST
- Fetches news from multiple sources
- Processes with AI
- Saves to Google Sheets
- No manual intervention needed

Manual Trigger

You can also manually trigger the workflow:

Go to Actions tab
Click "Daily News Fetch"
Click "Run workflow"

📊 How It Works

graph LR
    A[NewsData.io API] --> B[Fetch Articles]
    C[RSS Feeds] --> B
    B --> D[Groq AI Analysis]
    D --> E[Relevance Scoring]
    E --> F[Filter Top Articles]
    F --> G[Generate Summaries]
    F --> H[Create MCQs]
    G --> I[Google Sheets]
    H --> I
    I --> J[Streamlit App]
    J --> K[User Practice]
    L[GitHub Actions] -.->|Daily 6 AM| B

Daily Workflow:

6:00 AM IST - GitHub Actions triggers
Fetch - Get latest news from NewsData.io + RSS feeds
Analyze - Groq AI scores each article (1-10 relevance)
Filter - Keep only relevant articles (score ≥ 4)
Process - Generate summaries and MCQs
Save - Auto-save to Google Sheets
Done - Fresh content ready in ~2 minutes!

🎨 Features Breakdown

1️⃣ Smart Article Processing

Analyzes 10+ articles from multiple sources
AI relevance scoring (1-10 scale)
Automatic filtering of low-quality content
Processing time: ~2-3 seconds per article

2️⃣ Interactive MCQ System

JSON-based question format
Four-option multiple choice
Instant correct/wrong feedback
Detailed explanations
Retry same question or generate new ones

3️⃣ Date-Based Organization

Quick Filters:
- Today's news
- Yesterday's recap
- Last week's summary
- Last month's overview
Custom Range: Pick any start and end date
Statistics: Article count per date
Grouping: Articles organized by date headers

4️⃣ Premium Chat Interface

Powered by Google Gemini (latest model)
Context-aware responses
Exam-focused explanations
Answers based on loaded articles

📈 Performance

Processing Speed: ~2-3 seconds per article (Groq)
Daily Capacity: Unlimited (Groq has no practical limits)
Uptime: 99.9% (GitHub Actions + Streamlit Cloud)
Cost: $0 (All free tiers)

🔒 Privacy & Security

No user data collection
API keys stored securely in GitHub Secrets
Google Sheets access via service account only
Public read-only sheet access for users

🛣️ Roadmap

🤝 Contributing

Contributions are welcome! Here's how you can help:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit changes (git commit -m 'Add some AmazingFeature')
Push to branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Groq - For providing free, blazing-fast AI inference
Google Gemini - For powerful language model capabilities
NewsData.io - For comprehensive news API
Streamlit - For the amazing app framework
The Hindu & PIB - For RSS feeds

📞 Contact & Support

Live App: current-affairs-app.streamlit.app
GitHub: @Prateekray
Repository: current-affairs-app

⭐ Star This Repository

If you find this helpful for your exam preparation, please ⭐ star this repo!

📚 Additional Resources

For UPSC Aspirants:

For SSC Candidates:

Built with ❤️ for UPSC/SSC Aspirants

🚀 Try Live App • ⭐ Star on GitHub • 📖 Documentation

Name		Name	Last commit message	Last commit date
Latest commit History 34 Commits
.devcontainer		.devcontainer
.github/workflows		.github/workflows
.gitignore		.gitignore
README.md		README.md
fetch_news.py		fetch_news.py
requirements.txt		requirements.txt
streamlit_app.py		streamlit_app.py

Prateekray/current-affairs-app

Folders and files

Latest commit

History

Repository files navigation