Author: Oleh Ivchenko, PhD Candidate
Version: 0.2.0 (Updated)
References: Hegre et al. 2019, Mueller & Rauh 2018
Overview
This project uses machine learning to predict the probability of armed conflict for any country, combining multiple data sources and academic research on conflict prediction.
Ivchenko, O. (2026). Spec-Driven AI Development Series. Odessa National Polytechnic University.
DOI: 10.5281/zenodo.18735965
Read Full Paper
Technical Documentation
Jupyter Notebook: War Prediction Model
Complete technical implementation with code examples, model architecture, training process, and usage demonstrations. Includes data preprocessing, feature engineering, ensemble modeling, and SHAP explainability.
- Data loading from ACLED, UCDP, World Bank, SIPRI, V-Dem
- Feature engineering (economic, political, military indicators)
- Ensemble model (XGBoost + Random Forest + LSTM + Logistic Regression)
- Model training with cross-validation
- Performance evaluation and metrics
- SHAP explainability analysis
- Example predictions for multiple countries
- Complete code with documentation
World Conflict Risk Map
Interactive visualization showing conflict probability by country. Click any country or use the dropdown to see detailed risk analysis.
Model Architecture
The prediction model uses an ensemble of machine learning algorithms trained on historical conflict data:
flowchart TB
subgraph Input["📥 Input Features"]
E[Economic Indicators]
P[Political Stability]
M[Military Activity]
G[Geographic Factors]
H[Historical Conflicts]
end
subgraph Model["🤖 Ensemble Model"]
XG[XGBoost]
RF[Random Forest]
LSTM[LSTM Temporal]
LR[Logistic Regression]
end
subgraph Output["📊 Output"]
PROB[Probability 0-1]
CONF[Confidence Score]
FACTORS[Factor Weights]
end
E --> XG & RF & LSTM & LR
P --> XG & RF & LSTM & LR
M --> XG & RF & LSTM & LR
G --> XG & RF & LSTM & LR
H --> XG & RF & LSTM & LR
XG & RF & LSTM & LR --> PROB
XG & RF & LSTM & LR --> CONF
XG & RF & LSTM & LR --> FACTORS
Live Conflict Data Feed
Real-time conflict event visualization from the Geopolitical Risk API, powered by GDELT data.
Global Conflict Events (5-Year Trend)
Checking API status… · Data: GDELT conflict events · API Status ↗
Data Sources
| Source | Data Type | Coverage |
|---|---|---|
| ACLED | Armed conflict events | Global, real-time |
| GDELT | Global events database | Global, historical |
| World Bank | Economic indicators | 195 countries |
| SIPRI | Military expenditure | Global, annual |
| UCDP | Conflict data | 1946-present |
| V-Dem | Democracy indices | 202 countries |
Academic References
- Hegre, H., et al. (2019). “Predicting Armed Conflict, 2010-2050.” Journal of Peace Research, 56(4). DOI: 10.1177/0022343319834048
- Mueller, H., & Rauh, C. (2018). “Reading Between the Lines: Prediction of Political Violence.” American Political Science Review, 112(2). DOI: 10.1017/S0003055417000533
- Ward, M. D., et al. (2013). “Learning from the Past and Predicting the Future.” International Interactions, 39(3). DOI: 10.1080/03050629.2013.782306
- Muchlinski, D., et al. (2016). “Comparing Random Forest with Logistic Regression.” Political Analysis, 24(2). DOI: 10.1093/pan/mpv024
API Dependencies
/geo-risk-api/Status:
Endpoints used:
/api/chart/timeseriesData: GDELT conflict events, country risk scores
If unavailable: tool shows cached/static data
Check API status ↗
📋 Release Notes
• Live Data Feed — Integrated Geo Risk API for real-time GDELT conflict charts
• API Dependencies — Added status indicator for Geo Risk API health
• Design Update — Plain/native styling per platform standard
v0.2.0 (2026-02-25)
• Jupyter Notebook — Added downloadable technical implementation
• Google Colab — One-click open in Colab
• SHAP Explainability — Added factor contribution visualization
v0.1.0 (2026-02-22)
• Initial Release — World map with 87-country coverage
• Country Selector — Select2 searchable dropdown
• Factor Chart — Weighted risk breakdown
• Academic Paper — Published to Zenodo
This is a research project by Stabilarity Research Hub. Predictions are based on publicly available data and academic models. Not financial or political advice.