How riyad-77/smartfellah works
Smartfellah is an agricultural intelligence backend: it combines crop-reference documents, commune and field data, weather and satellite observations, and serves agronomic advice and risk assessments through an API. A documented document-ingestion workflow extracts PDF content, consolidates crop records, and loads them into PostgreSQL; scheduled workflows gather weather and satellite data. The API and a separate risk engine query stored data. Model training is another capability. Source excerpts are partial and the README is empty, so unverified connections are omitted.
Main entry points: init.sql Agriculture Database · dag_documents_agri.py Document Workflow · ingest_meteo.py Weather Collection · ingest_gee.py Satellite Indices
Components 21
Crop References
- Document Workflow
dags/dag_documents_agri.py - PDF Extraction
extract_agri_to_json.py - Crop Consolidation
Consolidation.py - Crop Data Loader
ingestion_smartfellah.py - Crop JSON Records
FT_Clean - Agronomy PDFs
FT_Vegetal
Data Ingestion
- Agriculture Database
init.sql - Daily Ingestion
dags/bifolia_pipeline.py - Weather Collection
dags/ingest_meteo.py - Satellite Indices
dags/ingest_gee.py - Forecast Workflow
dags/dag_meteo_forecast.py - Commune Seeding
seed_communes.py
Advice Services
- Smartfellah API
api_smartfellah.py - Disease Risk Engine
risk_engine.py
Risk Models
- Disease Model Training
train_disease_model.py - Forecast Model Training
train_models.py - Trained Models
models
Other components
- Farmer or Client
- Open-Meteo
- Google Earth Engine
- OpenWeather
Connections 21
- Farmer or Client → Smartfellah API: requests advice
api_smartfellah.py - Smartfellah API → Agriculture Database: queries
api_smartfellah.py - Disease Risk Engine → Agriculture Database: queries observations
risk_engine.py - Document Workflow → PDF Extraction: runs extraction
dags/dag_documents_agri.py - Document Workflow → Crop Consolidation: runs consolidation
dags/dag_documents_agri.py - Document Workflow → Crop Data Loader: runs loader
dags/dag_documents_agri.py - Document Workflow → Crop Consolidation: orders after extraction
dags/dag_documents_agri.py - Document Workflow → Crop Data Loader: orders after consolidation
dags/dag_documents_agri.py - Crop Data Loader → Agriculture Database: loads crop records
ingestion_smartfellah.py - Daily Ingestion → Weather Collection: runs before satellite
dags/bifolia_pipeline.py - Daily Ingestion → Satellite Indices: runs after weather
dags/bifolia_pipeline.py - Weather Collection → Open-Meteo: fetches weather
dags/ingest_meteo.py - Weather Collection → Agriculture Database: writes observations
dags/ingest_meteo.py - Satellite Indices → Google Earth Engine: fetches indices
dags/ingest_gee.py - Satellite Indices → Agriculture Database: writes indices
dags/ingest_gee.py - Forecast Workflow → OpenWeather: fetches forecasts
dags/dag_meteo_forecast.py - Forecast Workflow → Agriculture Database: stores forecasts
dags/dag_meteo_forecast.py - Commune Seeding → Agriculture Database: updates communes
seed_communes.py - Disease Model Training → Agriculture Database: reads weather
train_disease_model.py - Disease Model Training → Trained Models: saves classifier
- Forecast Model Training → Trained Models: saves models