milas-melt/morocco-data-stories

Make Morocco's segregated data understandable by everyone. # 🇲🇦 Morocco Data Stories Moroccan public data is fragmented and hard to use. It lives in PDFs, Excel files, scattered portals like data.gov.ma, and ministry websites that most citizens and investors never touch. With a large low-literacy population, even “open data” is rarely truly understandable. **Morocco Data Stories** turns this chaos into **short, simple, multilingual explainer videos** generated fully by AI — built on top of a unified API of Moroccan public data. > Morocco has the data — we make it understandable. --- ## 🚀 What the MVP Does 1. **Scrape & unify Moroccan public data** A scraping layer pulls datasets from segregated online sources (open data portals, CSV/XLS files, etc.), cleans them, and loads them into a single, queryable store. 2. **Expose a public Data API** On top of this store, we expose an HTTP API for Moroccan statistics (starting with education). The goal is to become the **largest public data API in Morocco** by coverage and usability. 3. **Summarise data with OpenAI** For a given topic (e.g. education access 2023), the system aggregates the relevant data and asks an OpenAI model to generate a clear, persona-aware narrative. 4. **Generate narration with ElevenLabs (via fal)** The script is turned into natural-sounding MP3 narration using ElevenLabs Turbo v2.5, orchestrated through fal. 5. **Create a video with VEED (via fal)** Using VEED Fabric 1.0 on fal, the system combines the narration and a visual (e.g. education map/thumbnail) into a short explainer MP4 — always producing a **final video**, not just audio. --- ## 🧩 Architecture Overview ### 1. Scraper Layer - Scrapes Moroccan public datasets from multiple official sources (portals, CSV/XLS, etc.). - Normalises formats and merges them into a consistent schema. - Feeds into the internal data store. ### 2. Data & API Layer - Stores cleaned, structured Moroccan indicators (starting with school infrastructure by region). - Exposes a REST API so other apps can …