Skip to content

marialasa/DPRK_EPU

Repository files navigation

πŸ‡°πŸ‡΅ DPRK UPR Response Prediction Tool

Machine learning–based estimation of DPRK recommendation acceptance patterns in the Universal Periodic Review (UPR) process.


Overview

This project uses historical Universal Periodic Review (UPR) recommendation data and machine learning models to estimate the probability that the Democratic People’s Republic of Korea (DPRK) will accept or reject a recommendation during the UPR process.

The system combines political, thematic, and discursive variables to generate probabilistic predictions based on historical behavioral patterns observed in previous UPR cycles.

The tool is designed for:

  • academic research,
  • policy analysis,
  • human rights monitoring,
  • and exploratory scenario simulation.

⚠️ Predictions generated by this application are probabilistic and should be interpreted as analytical scenarios rather than deterministic forecasts.


Features

  • 🌐 Bilingual interface (English / Spanish)
  • πŸ€– Machine learning–based prediction engine
  • 🧭 Political sensitivity classification
  • πŸ›οΈ Thematic area classification
  • πŸ“Š Alignment score integration using UNGA voting data
  • πŸ“ Recommendation text analysis
  • βš–οΈ Scenario simulation modes
  • πŸ“ˆ Probabilistic prediction outputs
  • πŸŽ›οΈ Interactive Streamlit dashboard

Methodological Framework

The model estimates DPRK response behavior using structured variables derived from UPR recommendations and political indicators.

Core Variables

Variable Description
Political Sensitivity Degree of regime sensitivity associated with the recommendation
Thematic Area Main substantive issue addressed
Alignment Score Ideological proximity between the recommending State and the DPRK
Recommendation Length Discursive complexity and density
Recommendation Text Semantic content of the recommendation
Recommending State Country issuing the recommendation

Political Sensitivity Framework

The project operationalizes political sensitivity using a three-level analytical framework.

Level Description
Low Sensitivity Social and humanitarian issues generally tolerated by the regime
Medium Sensitivity Institutional or normative issues implying moderate political pressure
High Sensitivity Issues directly linked to political control, repression, accountability, or civil liberties

Examples

Low Sensitivity

  • food
  • health
  • education
  • disability rights
  • humanitarian cooperation

Medium Sensitivity

  • gender equality
  • legal reform
  • treaty ratification
  • institutional strengthening

High Sensitivity

  • torture
  • prison camps
  • executions
  • freedom of expression
  • political participation
  • ICC / COI references

Alignment Score

The alignment score captures ideological proximity using United Nations General Assembly voting patterns, following the literature that treats voting behavior as a proxy for state preferences (Voeten, 2013).

In this project, the score is operationalized as the average absolute voting distance between each State and the DPRK:

  • 0 = no ideological proximity
  • 1 = complete alignment

Scenario Logic

The application includes different analytical behavior modes:

Scenario Description
50/50 Coin Flip Dynamic Assumes balanced uncertainty
80/20 Pareto Logic Assumes asymmetric behavioral concentration

These scenarios are designed to explore different predictive distributions and model assumptions.


Technology Stack

  • Python
  • Streamlit
  • scikit-learn
  • pandas
  • numpy
  • plotly

Installation

Clone the repository:

git clone https://github.com/marialasa/dprk-upr-prediction-tool.git
cd dprk-upr-prediction-tool

Install dependencies:

pip install -r requirements.txt

Run the application:

streamlit run app.py

Project Structure

β”œβ”€β”€ app.py
β”œβ”€β”€ data/
β”œβ”€β”€ models/
β”œβ”€β”€ assets/
β”œβ”€β”€ notebooks/
β”œβ”€β”€ requirements.txt
└── README.md

Intended Use

This tool was developed for:

  • academic exploration,
  • human rights research,
  • policy analysis,
  • and computational social science applications.

It is not intended to produce definitive predictions about DPRK behavior.


Disclaimer

This project does not predict future DPRK behavior with certainty. Outputs should be interpreted as probabilistic analytical scenarios derived from historical patterns observed in prior UPR cycles.

The classifications and analytical categories used in this project are simplified operationalizations created for modeling purposes and do not represent official United Nations taxonomies.


Future Improvements

  • SHAP explainability integration
  • Transformer-based NLP models
  • Temporal modeling across UPR cycles
  • Multilingual recommendation embeddings
  • Recommendation clustering analysis
  • Confidence interval estimation

Citation

If you use this project in academic work, please cite:

@software{dprk_upr_prediction_tool,
  title={DPRK UPR Response Prediction Tool},
  author={LASA, María de los Ángeles},
  year={2026},
  url={https://uprnorthkorea.streamlit.app/}
}

License

MIT License

About

πŸ‡°πŸ‡΅ Machine learning model predicting DPRK responses in the Universal Periodic Review (UPR)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages