mirror of
https://github.com/NousResearch/atropos.git
synced 2026-04-23 16:54:56 +00:00
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:
parent
b9a1940d12
commit
7101aad190
20 changed files with 1810 additions and 310 deletions
73
environments/dynastai/ATROPOS_INTEGRATION.md
Normal file
73
environments/dynastai/ATROPOS_INTEGRATION.md
Normal 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue