Moham440/algeria-food-price-intelligence
Domain:
agriculturesocioeconomicRecord type:
project
Creator:
Moh
Host:
AI-powered food price monitoring system for Algeria with anomaly detection and forecasting
# 🌾 Algeria Food Price Intelligence System
**An end-to-end Data Science platform for monitoring, detecting anomalies in,
and forecasting food prices across Algerian regions.**
*Data sources: FAO · WFP · HDX*
---
## 📋 Table of Contents
- Overview
- Architecture
- Features
- Installation
- Usage
- Dashboard Screenshots
- ML Models
- Results Interpretation
- Configuration
- Docker Deployment
- Running Tests
- Project Structure
- Contributing
---
## 🌍 Overview
The **Algeria Food Price Intelligence System** is a production-grade data science
platform that:
1. **Collects** real food price data from the FAO FAOSTAT API and WFP/HDX datasets.
2. **Cleans & Engineers** features including Ramadan seasonality, rolling statistics,
and regional price ratios.
3. **Detects Anomalies** using an Isolation Forest + One-Class SVM ensemble to flag
sudden price spikes.
4. **Forecasts Prices** using a Prophet + LSTM ensemble model with up to 24-month
horizons.
5. **Visualises** everything in an interactive Streamlit dashboard with choropleth
maps, trend charts, and an alert board.
### Monitored Products
| Category | Products |
|---|---|
| 🥦 Vegetables | Tomates · Pommes de terre · Oignons · Carottes |
| 🍗 Proteins | Poulet · Viande rouge (mouton & bœuf) · Oeufs |
| 🌾 Cereals | Pain · Semoule · Farine · Riz |
| 🫙 Staples | Huile végétale · Sucre · Lait · Beurre |
### Covered Regions (Wilayas)
Alger · Oran · Constantine · Annaba · Tlemcen · Sétif · Blida · Batna · Biskra · Béjaïa
---
## 🏗️ Architecture
```
algeria-food-price-intelligence/
├── data/
│ ├── raw/ # Original FAO/WFP Parquet files
│ ├── processed/ # Cleaned + feature-engineered data
│ └── external/ # Weather, CPI, exchange rate data
├── notebooks/
│ ├── 01_data_collection.ipynb
│ ├── 02_eda_analysis.ipynb
│ ├── 03_feature_engineering.ipynb
│ ├── 04_anomaly_detection.ipynb
│ └── 05_price_forecasting.ipynb
├── src/
│ ├── data_ingestion/
│ │ ├── fao_connector.py # FAO …