Geopolitical Analyst

📦 Installation

Prerequisites

• Python 3.9+
• pip package manager
• Internet connection (for cloning + API access)
• ~100 MB disk space

Step-by-Step

# 1. Clone repository
git clone https://github.com/nimaansari/geopolitical-analyst-skill
cd geopolitical-analyst-skill

# 2. Install dependencies
pip install -r requirements.txt

# 3. Run the skill
python3 geopolitical_analyst_agent.py

What Gets Installed

• requests (2.31.0+) — HTTP requests library
• python-dateutil (2.8.2+) — Date/time parsing

Both are well-maintained, popular packages with no known security issues.

🔗 API Integrations

All APIs Are Public

No API keys, tokens, or credentials required.

🔒 Security & Privacy

✅ No credentials stored — Uses only public APIs
✅ No authentication required — All endpoints are public
✅ No cloud secrets — Nothing in platform credentials
✅ Open source code — MIT license, fully auditable
✅ Local processing only — No data sent to external servers

The skill reads public data from news sources, conflict databases, humanitarian reports, and government sanctions lists. No sensitive or personal data is processed.

⚠️ Risk Assessment

Medium Risk Because:

1. External code fetch — GitHub clone brings code from internet
2. pip install — Installs external Python packages
3. Network access — Calls 5 external APIs
4. Filesystem writes — Creates local cache/logs

Mitigations:

1. Auditable code — MIT open source, review on GitHub
2. Trusted dependencies — requests, python-dateutil are standard
3. Rate-limited APIs — Can't make unlimited requests
4. Local operation — No data sent externally

Recommendations:

• Review GitHub repository before installing
• Test in sandbox/VM first if security-critical
• Run with restricted network if possible
• Monitor network calls during first run

🚀 Usage

Interactive Mode

python3 interactive_monitor.py
# Then enter: Gaza, Ukraine, Taiwan, etc.

Command Line

python3 interactive_monitor.py "South China Sea" FULL
python3 interactive_monitor.py Ukraine BRIEF

Python API

from geopolitical_analyst_agent import run_analysis

result = run_analysis(
    country="Ukraine",
    keywords=["Ukraine", "Russia", "military"],
    depth="FULL"
)

📄 License

MIT License — Open source, fully auditable.

You can: Use commercially, Modify, Distribute

🔗 Links

• GitHub: https://github.com/nimaansari/geopolitical-analyst-skill
• Issues: https://github.com/nimaansari/geopolitical-analyst-skill/issues
• Documentation: See README.md in repository

This skill is production-ready and safe to use if you understand the requirements above.