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.
This commit is contained in:
Earl Potters 2025-05-18 21:59:12 +00:00
parent b9a1940d12
commit 7101aad190
20 changed files with 1810 additions and 310 deletions

View file

@ -0,0 +1,73 @@
# 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:
```bash
# 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
```bash
# 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:**
```bash
cd environments/dynastai
python test_card_generation.py
```
2. **API Endpoints:**
```bash
cd environments/dynastai
# Start the server in one terminal
python dynastai_server.py
# In another terminal
python test_dynastai_api.py
```
3. **Environment Integration:**
```bash
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.