Update README with Hugging Face metadata

README.md

@@ -1,143 +1,99 @@
-# AI Agent UN
-![alt text](images/banner.jpg)
+---
+title: AI Agent UN - Gaza Ceasefire Resolution
+emoji: 🌍
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 4.44.0
+app_file: app.py
+pinned: false
+license: mit
+---
 
+# 🇺🇳 AI Agent UN: Gaza Ceasefire Resolution Simulation
 
-An experimental Model United Nations simulation populated by AI agents. 
+An experimental Model United Nations simulation where AI agents representing all 195 UN member states vote on a ceasefire resolution for Gaza.
 
-Each agent embodies the foreign policy positions, diplomatic style, and national interests of a specific country.
+## 🎯 The Concept
 
-Motions can be run as tasks and using structured outputs both votes and supporting statements can be collected and then analysed.
+This project explores how large language models can simulate international diplomatic interactions by creating AI agents that embody:
+- **Foreign policy positions** based on historical voting records
+- **Diplomatic style** reflecting each country's approach to multilateral diplomacy
+- **National interests** and regional alliances
+- **Cultural and ideological perspectives**
 
-## Overview
+### How It Works
 
-This is an AI experiment designed to:
-- Simulate international diplomatic interactions and negotiations
-- Model how different countries might approach global issues based on their historical positions and national interests
-- Explore multi-agent AI systems in complex geopolitical scenarios
-- Provide an educational and research tool for understanding international relations dynamics
+1. **Agent System Prompts**: Each of the 195 countries has a detailed system prompt that defines their:
+   - Historical positions on Middle East conflicts
+   - Key alliances and regional groupings
+   - Economic and security interests
+   - Past voting patterns on similar resolutions
 
-## Project Structure
+2. **Structured Voting**: Each AI agent receives the ceasefire resolution text and responds with:
+   - A vote: YES, NO, or ABSTAIN
+   - A diplomatic statement explaining their position
 
-```
-AI-Agent-UN/
-├── agents/
-│   └── representatives/     # AI agent system prompts for each country
-│       ├── united-states/
-│       ├── china/
-│       ├── russia/
-│       └── ...
-├── data/
-│   └── bodies/             # UN membership data
-├── tasks/
-│   ├── motions/            # UN resolutions to vote on
-│   └── reactions/          # Simulation results (votes & statements)
-├── scripts/
-│   └── run_motion.py       # Main simulation runner
-├── .env.example            # Configuration template
-└── requirements.txt        # Python dependencies
-```
+3. **Analysis**: Votes are aggregated and analyzed by region, showing how different parts of the world approach the issue
 
-## Quick Start
+## 📊 The Resolution
 
-### 1. Installation
+**Motion**: Support for Ceasefire Agreement in Gaza and Commitment to Lasting Peace
 
-```bash
-# Clone the repository
-git clone https://github.com/yourusername/AI-Agent-UN.git
-cd AI-Agent-UN
+The resolution calls for:
+- Immediate and comprehensive ceasefire
+- Unhindered humanitarian access
+- Release of hostages and prisoners
+- Lifting of restrictions on Gaza
+- Two-state solution based on pre-1967 borders
+- International monitoring and accountability
 
-# Create virtual environment
-python3 -m venv .venv
-source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+## 🤖 Technical Details
 
-# Install dependencies
-pip install -r requirements.txt
-```
+- **Model**: Claude 3.5 Sonnet (claude-3-5-sonnet-20241022)
+- **Countries**: 195 UN member states
+- **Simulation Date**: October 9, 2025
+- **Vote Distribution**:
+  - ✅ YES: 190 countries (97.4%)
+  - ❌ NO: 3 countries (1.5%)
+  - ⚪ ABSTAIN: 2 countries (1.0%)
 
-### 2. Configuration
+## 🔍 Explore the Results
 
-```bash
-# Copy the example environment file
-cp .env.example .env
+Use the tabs above to:
+- **Vote Summary**: See the overall voting distribution
+- **Regional Analysis**: Compare how different regions voted
+- **Country Details**: Read individual countries' votes and diplomatic statements
+- **All Votes**: Browse the complete voting record
 
-# Edit .env and add your API key
-# For cloud API (OpenAI):
-OPENAI_API_KEY=your_api_key_here
-MODEL_NAME=gpt-4
+## 🎓 Educational Value
 
-# OR for local models (Ollama):
-# Install Ollama from https://ollama.ai
-# Pull a model: ollama pull llama3
-```
+This simulation demonstrates:
+- How AI can model complex geopolitical decision-making
+- The diversity of international perspectives on contentious issues
+- The role of historical context in diplomatic positions
+- Multi-agent AI systems in action
 
-### 3. Run a Motion Simulation
+## ⚠️ Important Disclaimer
 
-```bash
-# Run with cloud API (default)
-python scripts/run_motion.py 01_gaza_ceasefire_resolution
+This is an AI simulation for research and educational purposes only. The positions expressed by the AI agents:
+- Do NOT represent actual government policies
+- Are NOT official diplomatic stances
+- Should NOT be considered authoritative or predictive
+- Are based on historical patterns, not current intentions
 
-# Run with local model
-python scripts/run_motion.py 01_gaza_ceasefire_resolution --provider local
+The simulation is designed to explore how AI models understand and represent different national perspectives based on publicly available information about countries' historical positions.
 
-# Test with only 5 countries
-python scripts/run_motion.py 01_gaza_ceasefire_resolution --sample 5
-```
+## 🔗 Links
 
-### 4. View Results
+- [GitHub Repository](https://github.com/yourusername/AI-Agent-UN)
+- [Full Source Code](https://github.com/yourusername/AI-Agent-UN/blob/main/scripts/run_motion.py)
+- [Agent System Prompts](https://github.com/yourusername/AI-Agent-UN/tree/main/agents/representatives)
 
-Results are saved in `tasks/reactions/` as JSON files:
-- `{motion_id}_{timestamp}.json` - Timestamped result
-- `{motion_id}_latest.json` - Always points to latest simulation
+## 🤝 Contributing
 
-## How It Works
+This is an experimental research project. Contributions, suggestions, and discussions are welcome!
 
-1. **Agent System Prompts**: Each country has a detailed system prompt in `agents/representatives/{country}/system-prompt.md` that defines their foreign policy positions and diplomatic style.
+---
 
-2. **Motion Runner**: The `run_motion.py` script:
-   - Loads the motion text from `tasks/motions/`
-   - Queries each country's AI agent
-   - Collects votes (yes/no/abstain) and statements
-   - Saves results to `tasks/reactions/`
-
-3. **JSON-Constrained Output**: Each agent responds with structured JSON:
-   ```json
-   {
-     "vote": "yes",
-     "statement": "Brief explanation of position..."
-   }
-   ```
-
-## Available Motions
-
-- `01_gaza_ceasefire_resolution` - Support for Ceasefire Agreement in Gaza and Commitment to Lasting Peace
-
-## AI Providers
-
-### Cloud API
-- Supports OpenAI (GPT-4, GPT-3.5-turbo, etc.)
-- Supports Anthropic Claude (with API key)
-- Supports any OpenAI-compatible API
-
-### Local Models
-- Uses Ollama for local inference
-- Supports Llama 3, Mistral, Mixtral, and other Ollama models
-- No API costs, complete privacy
-
-## Use Cases
-
-- Educational demonstrations of international relations concepts
-- Research into multi-agent AI behavior in diplomatic contexts
-- Experimentation with large language models in structured debate scenarios
-- Analysis of how AI systems model complex geopolitical positions
-
-## Contributing
-
-This is an experimental project shared publicly for research, education, and collaborative development. Contributions are welcome!
-
-## License
-
-[To be determined]
-
-## Disclaimer
-
-This is a simulation for research and educational purposes. The AI agents' positions do not represent actual government policies or diplomatic stances. The simulation is designed to model how countries might approach issues based on their historical positions, but should not be considered authoritative or predictive.
+Built with ❤️ using [Gradio](https://gradio.app) and [Claude](https://anthropic.com/claude)

README_GITHUB.md

@@ -0,0 +1,143 @@
+# AI Agent UN
+![alt text](images/banner.jpg)
+
+
+An experimental Model United Nations simulation populated by AI agents. 
+
+Each agent embodies the foreign policy positions, diplomatic style, and national interests of a specific country.
+
+Motions can be run as tasks and using structured outputs both votes and supporting statements can be collected and then analysed.
+
+## Overview
+
+This is an AI experiment designed to:
+- Simulate international diplomatic interactions and negotiations
+- Model how different countries might approach global issues based on their historical positions and national interests
+- Explore multi-agent AI systems in complex geopolitical scenarios
+- Provide an educational and research tool for understanding international relations dynamics
+
+## Project Structure
+
+```
+AI-Agent-UN/
+├── agents/
+│   └── representatives/     # AI agent system prompts for each country
+│       ├── united-states/
+│       ├── china/
+│       ├── russia/
+│       └── ...
+├── data/
+│   └── bodies/             # UN membership data
+├── tasks/
+│   ├── motions/            # UN resolutions to vote on
+│   └── reactions/          # Simulation results (votes & statements)
+├── scripts/
+│   └── run_motion.py       # Main simulation runner
+├── .env.example            # Configuration template
+└── requirements.txt        # Python dependencies
+```
+
+## Quick Start
+
+### 1. Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/AI-Agent-UN.git
+cd AI-Agent-UN
+
+# Create virtual environment
+python3 -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+### 2. Configuration
+
+```bash
+# Copy the example environment file
+cp .env.example .env
+
+# Edit .env and add your API key
+# For cloud API (OpenAI):
+OPENAI_API_KEY=your_api_key_here
+MODEL_NAME=gpt-4
+
+# OR for local models (Ollama):
+# Install Ollama from https://ollama.ai
+# Pull a model: ollama pull llama3
+```
+
+### 3. Run a Motion Simulation
+
+```bash
+# Run with cloud API (default)
+python scripts/run_motion.py 01_gaza_ceasefire_resolution
+
+# Run with local model
+python scripts/run_motion.py 01_gaza_ceasefire_resolution --provider local
+
+# Test with only 5 countries
+python scripts/run_motion.py 01_gaza_ceasefire_resolution --sample 5
+```
+
+### 4. View Results
+
+Results are saved in `tasks/reactions/` as JSON files:
+- `{motion_id}_{timestamp}.json` - Timestamped result
+- `{motion_id}_latest.json` - Always points to latest simulation
+
+## How It Works
+
+1. **Agent System Prompts**: Each country has a detailed system prompt in `agents/representatives/{country}/system-prompt.md` that defines their foreign policy positions and diplomatic style.
+
+2. **Motion Runner**: The `run_motion.py` script:
+   - Loads the motion text from `tasks/motions/`
+   - Queries each country's AI agent
+   - Collects votes (yes/no/abstain) and statements
+   - Saves results to `tasks/reactions/`
+
+3. **JSON-Constrained Output**: Each agent responds with structured JSON:
+   ```json
+   {
+     "vote": "yes",
+     "statement": "Brief explanation of position..."
+   }
+   ```
+
+## Available Motions
+
+- `01_gaza_ceasefire_resolution` - Support for Ceasefire Agreement in Gaza and Commitment to Lasting Peace
+
+## AI Providers
+
+### Cloud API
+- Supports OpenAI (GPT-4, GPT-3.5-turbo, etc.)
+- Supports Anthropic Claude (with API key)
+- Supports any OpenAI-compatible API
+
+### Local Models
+- Uses Ollama for local inference
+- Supports Llama 3, Mistral, Mixtral, and other Ollama models
+- No API costs, complete privacy
+
+## Use Cases
+
+- Educational demonstrations of international relations concepts
+- Research into multi-agent AI behavior in diplomatic contexts
+- Experimentation with large language models in structured debate scenarios
+- Analysis of how AI systems model complex geopolitical positions
+
+## Contributing
+
+This is an experimental project shared publicly for research, education, and collaborative development. Contributions are welcome!
+
+## License
+
+[To be determined]
+
+## Disclaimer
+
+This is a simulation for research and educational purposes. The AI agents' positions do not represent actual government policies or diplomatic stances. The simulation is designed to model how countries might approach issues based on their historical positions, but should not be considered authoritative or predictive.

README_HF.md

@@ -1,99 +0,0 @@
----
-title: AI Agent UN - Gaza Ceasefire Resolution
-emoji: 🇺🇳
-colorFrom: blue
-colorTo: green
-sdk: gradio
-sdk_version: 4.44.0
-app_file: app.py
-pinned: false
-license: mit
----
-
-# 🇺🇳 AI Agent UN: Gaza Ceasefire Resolution Simulation
-
-An experimental Model United Nations simulation where AI agents representing all 195 UN member states vote on a ceasefire resolution for Gaza.
-
-## 🎯 The Concept
-
-This project explores how large language models can simulate international diplomatic interactions by creating AI agents that embody:
-- **Foreign policy positions** based on historical voting records
-- **Diplomatic style** reflecting each country's approach to multilateral diplomacy
-- **National interests** and regional alliances
-- **Cultural and ideological perspectives**
-
-### How It Works
-
-1. **Agent System Prompts**: Each of the 195 countries has a detailed system prompt that defines their:
-   - Historical positions on Middle East conflicts
-   - Key alliances and regional groupings
-   - Economic and security interests
-   - Past voting patterns on similar resolutions
-
-2. **Structured Voting**: Each AI agent receives the ceasefire resolution text and responds with:
-   - A vote: YES, NO, or ABSTAIN
-   - A diplomatic statement explaining their position
-
-3. **Analysis**: Votes are aggregated and analyzed by region, showing how different parts of the world approach the issue
-
-## 📊 The Resolution
-
-**Motion**: Support for Ceasefire Agreement in Gaza and Commitment to Lasting Peace
-
-The resolution calls for:
-- Immediate and comprehensive ceasefire
-- Unhindered humanitarian access
-- Release of hostages and prisoners
-- Lifting of restrictions on Gaza
-- Two-state solution based on pre-1967 borders
-- International monitoring and accountability
-
-## 🤖 Technical Details
-
-- **Model**: Claude 3.5 Sonnet (claude-3-5-sonnet-20241022)
-- **Countries**: 195 UN member states
-- **Simulation Date**: October 9, 2025
-- **Vote Distribution**:
-  - ✅ YES: 190 countries (97.4%)
-  - ❌ NO: 3 countries (1.5%)
-  - ⚪ ABSTAIN: 2 countries (1.0%)
-
-## 🔍 Explore the Results
-
-Use the tabs above to:
-- **Vote Summary**: See the overall voting distribution
-- **Regional Analysis**: Compare how different regions voted
-- **Country Details**: Read individual countries' votes and diplomatic statements
-- **All Votes**: Browse the complete voting record
-
-## 🎓 Educational Value
-
-This simulation demonstrates:
-- How AI can model complex geopolitical decision-making
-- The diversity of international perspectives on contentious issues
-- The role of historical context in diplomatic positions
-- Multi-agent AI systems in action
-
-## ⚠️ Important Disclaimer
-
-This is an AI simulation for research and educational purposes only. The positions expressed by the AI agents:
-- Do NOT represent actual government policies
-- Are NOT official diplomatic stances
-- Should NOT be considered authoritative or predictive
-- Are based on historical patterns, not current intentions
-
-The simulation is designed to explore how AI models understand and represent different national perspectives based on publicly available information about countries' historical positions.
-
-## 🔗 Links
-
-- [GitHub Repository](https://github.com/yourusername/AI-Agent-UN)
-- [Full Source Code](https://github.com/yourusername/AI-Agent-UN/blob/main/scripts/run_motion.py)
-- [Agent System Prompts](https://github.com/yourusername/AI-Agent-UN/tree/main/agents/representatives)
-
-## 🤝 Contributing
-
-This is an experimental research project. Contributions, suggestions, and discussions are welcome!
-
----
-
-Built with ❤️ using [Gradio](https://gradio.app) and [Claude](https://anthropic.com/claude)