A sophisticated emotional intelligence system that models regional and global emotional states using V-A-D (Valence-Arousal-Dominance) frameworks enhanced with algorithmic emotional substrates.

• Enhanced Emotional Modeling: V-A-D + Flourishing emotional state representation
• Emotional Geometries Framework: Algorithmic substrates for curiosity, fear, joy, and sorrow
• Real-time Analysis: Sentiment analysis and anomaly detection
• Predictive Modeling: Machine learning-powered forecasting
• Ethical AI Design: Transparency and user control built-in
• Pattern Analysis: Growth, duality, and resonance pattern detection

• Regional emotional state modeling
• Global emotional indices computation
• Real-time data integration
• AI-powered sentiment analysis

• Curiosity substrate for exploration patterns
• Fear substrate for constraint and safety
• Joy substrate for amplification and resonance
• Sorrow substrate for reflection and depth

pip install -e .

from ges_ai import EnhancedGESEngine, create_default_regions

# Initialize the engine
engine = EnhancedGESEngine(enable_emotional_geometries=True)

# Add regions
configs = create_default_regions(["USA", "CHN", "IND"])
for config in configs:
    engine.add_region(config)

# Update regional state
drivers = {
    "economic_index": 0.7,
    "health_index": 0.8, 
    "social_support": 0.6,
    "environmental_quality": 0.5
}

state = engine.update_region_state("USA", drivers)
print(f"Emotional state: V={state.valence:.2f}, A={state.arousal:.2f}")

# Compute global indices
global_indices = engine.compute_global_indices()
print(f"Global Emotional Index: {global_indices.gei:.1f}")

The system follows ethical AI design principles:

• Deontological Ethics: Harm prevention as universal principle
• Virtue Ethics: Wisdom, integrity, empathy, fairness, beneficence
• Utilitarian Ethics: As servant, never master
• Privacy-First: Aggregated data only, individual privacy protected
• Transparency: Explainable decisions and uncertainty communication

MIT License