NaturalDisasters / README.md
gk2410's picture
Update README.md
9c58c45 verified

A newer version of the Streamlit SDK is available: 1.54.0

Upgrade
metadata
title: DisasterTracker AI 🌍
emoji: πŸŒͺ️
colorFrom: blue
colorTo: green
sdk: streamlit
sdk_version: 1.44.1
app_file: app.py
pinned: false

🌍 DisasterTracker AI

DisasterTracker AI is a fullstack open-source RAG app that helps you stay updated on recent natural disasters around the world. It combines the power of local embeddings, open-source language models, real-time news, and live weather data.

πŸ” Features

  • βœ… Retrieval-Augmented Generation (RAG) with flan-t5-base
  • βœ… Local vector store using ChromaDB and SentenceTransformers
  • βœ… Live RSS feeds for global natural disaster news
  • βœ… Real-time weather forecasts from Open-Meteo API
  • βœ… Streamlit UI optimized for Hugging Face Spaces (no API keys required)
  • βœ… Runs entirely on CPU β€” 100% open source and deployable for free

πŸš€ How It Works

  1. News is scraped from RSS feeds (NYT, Reuters, Al Jazeera).
  2. Articles are embedded using all-MiniLM-L6-v2 and stored in ChromaDB.
  3. When you ask a question, the system:
    • Finds relevant articles (RAG)
    • Generates an answer using flan-t5-base
    • Fetches live weather for mentioned locations

πŸ› οΈ Setup Instructions

1. Install Dependencies

pip install -r requirements.txt