atropos/environments/dynastai/ATROPOS_INTEGRATION.md
Earl Potters 7101aad190 Add DynastAI integration documentation and setup scripts
- Introduced `ATROPOS_INTEGRATION.md` for detailed instructions on using DynastAI with Atropos.
- Added `INSTALL_AND_RUN.md` to guide users through installation and running the game.
- Created `run_dynastai.py` for a simplified testing experience without full Atropos setup.
- Implemented `setup.py` to manage dependencies and ensure compatibility.
- Updated `requirements.txt` to include additional dependencies and version constraints.
- Enhanced `README.md` with new sections on installation, running the game, and integration with Atropos.
- Added installation verification script `verify_install.py` to check for required packages.
- Updated game logic to support local card generation and improved API integration.
- Enhanced web interface with new features for user interaction and game metrics display.
2025-05-18 21:59:12 +00:00

1.8 KiB

DynastAI Integration with Atropos

This document provides instructions on how to use DynastAI with Atropos.

Quick Start Guide

Option 1: Using the Web Interface (No Atropos Required)

This is the simplest way to test the game mechanics:

# Navigate to the dynastai directory
cd environments/dynastai

# Run the quick start script
python run_dynastai.py

Your browser will open automatically to http://localhost:3000.

Option 2: Using with Atropos

# From the atropos root directory
python environments/dynastai_environment.py serve --web-ui

The environment will start and be available for Atropos trainers.

Testing Components

You can test individual components:

  1. Card Generation:

    cd environments/dynastai
    python test_card_generation.py
    
  2. API Endpoints:

    cd environments/dynastai
    # Start the server in one terminal
    python dynastai_server.py
    # In another terminal
    python test_dynastai_api.py
    
  3. Environment Integration:

    cd environments/dynastai
    python test_dynastai_env.py
    

Directory Structure

  • dynastai_environment.py: Main entry point for Atropos integration
  • dynastai/: Environment package
    • src/dynastai_env.py: Atropos environment implementation
    • src/game_logic.py: Core game mechanics
    • src/web/: Web interface
    • src/data/: Game data including cards.json

Troubleshooting

  • Missing cards.json: Run test_card_generation.py to generate it
  • API errors: Ensure server is running on port 9001
  • Import errors: Make sure you're in the correct directory and have installed dependencies
  • Web UI not loading: Check that the server is running and the ports are correct

Feedback and Issues

Report any issues on GitHub or contact the maintainer directly.