Haive Games Overview

Welcome to haive-games, the comprehensive AI gaming research platform! 🎮

Note

Looking for other Haive packages? The complete framework documentation will be available at the Haive root documentation.

🎯 Strategy Games

Chess, Go, Checkers, and more with advanced AI strategies and planning algorithms.

Explore Games →

Game Categories - Complete Collection
🧠 Social Psychology

Among Us, Mafia, and Clue with deception detection and social reasoning.

View Social Games →

Social Psychology Games
🎰 Card & Probability

Poker, Blackjack, and UNO with sophisticated probability calculations.

Card Games →

Game Categories - Complete Collection
🏆 Tournament System

Multi-provider tournaments with cross-game performance analytics.

Tournament Docs →

Tournament System - Multi-Agent & LLM Benchmarking

Quick Start 🏃‍♂️

# Install haive-games
pip install haive-games

# Or with Poetry (recommended)
poetry add haive-games

from haive.games.chess import ChessAgent
from haive.core.engine import AugLLMConfig

# Configure your AI
config = AugLLMConfig(
    model="gpt-4",
    temperature=0.7
)

# Create game agent
chess_ai = ChessAgent(
    name="ChessBot",
    engine=config
)

from haive.games.tournament import Tournament
from haive.games.among_us import AmongUsAgent
from haive.games.poker import PokerAgent

# Create tournament
tournament = Tournament()
tournament.add_agent(AmongUsAgent(name="SocialBot"))
tournament.add_agent(PokerAgent(name="BluffMaster"))
tournament.run()

Game Categories 🎮

Board Games ♟️

  • ChessAgent

  • GoAgent

  • CheckersAgent

  • ReversiAgent

Social Games 🕵️
Card Games 🃏

  • PokerAgent

  • BlackjackAgent

  • UNOAgent

  • HoldEmAgent

Architecture Overview 🏗️

        graph TB
   A[Application Layer] --> B[haive-games]
   B --> C[Game Engines]
   B --> D[AI Agents]
   B --> E[Tournament System]
   B --> F[Analytics]

   C --> G[Board Games]
   C --> H[Card Games]
   C --> I[Social Games]

   D --> J[Strategy AI]
   D --> K[Probability AI]
   D --> L[Social AI]

   E --> M[Multi-Provider]
   E --> N[Cross-Game]

   F --> O[Performance Metrics]
   F --> P[Research Data]

   style B fill:#2563eb,stroke:#1d4ed8,color:#fff
   style C fill:#60a5fa,stroke:#3b82f6
   style D fill:#60a5fa,stroke:#3b82f6
   style E fill:#60a5fa,stroke:#3b82f6
   style F fill:#60a5fa,stroke:#3b82f6

Key Features ✨

🎮 19+ Game Implementations

Comprehensive collection of board games, card games, social deduction games, and puzzles.

🤖 Advanced AI Strategies

Sophisticated AI agents with game-specific strategies and learning capabilities.

🏆 Tournament System

Multi-provider tournaments with cross-game rankings and performance analytics.

📊 Research Analytics

Detailed performance metrics, behavioral analysis, and research-grade data collection.

🧠 Social Psychology

Deception detection, trust modeling, and social reasoning in multiplayer games.

⚡ High Performance

Optimized for real-time gameplay with async support and efficient state management.

Integration Examples 🔗

from haive.games.chess import ChessAgent
from haive.agents import ReactAgent

# Combine game AI with reasoning
chess_ai = ChessAgent(name="ChessBot")
reasoning_agent = ReactAgent(
    name="strategist",
    tools=[chess_ai]
)

from haive.games.tournament import Tournament
from haive.games import ChessAgent, PokerAgent, GoAgent

# Run cross-game tournament
tournament = Tournament(
    agents=[
        ChessAgent(name="Bot1"),
        PokerAgent(name="Bot1"),
        GoAgent(name="Bot1")
    ]
)
results = tournament.run_all()

from haive.games.analytics import GameAnalyzer
from haive.games.among_us import AmongUsGame

# Analyze social dynamics
game = AmongUsGame(players=10)
analyzer = GameAnalyzer(game)

# Get behavioral metrics
trust_network = analyzer.get_trust_network()
deception_rates = analyzer.get_deception_metrics()

Resources 📚

📖 Game Documentation

Complete guide to all game implementations

Game Categories - Complete Collection
🎓 Tutorials

Step-by-step guides and examples

Getting Started
💬 Community

Join discussions and share strategies

https://github.com/haive-ai/haive/discussions

Need Help? 🤝