ai-security-battle/
├── database/                   # Database layer
│   ├── schema.sql              # Database schema
│   ├── db_config.py            # Database manager & repositories
│   ├── models.py               # Data models
│   └── seed_data.py            # Initialize with sample data
│
├── blue_team/                  # Blue Team (Defenders)
│   ├── ml_models/              # ML models for defense
│   ├── defenses/               # Defense mechanisms
│   ├── monitoring/             # Monitoring systems
│   ├── api/                    # API endpoints
│   └── blue_agent.py           # Blue Team orchestrator
│
├── red_team/                   # Red Team (Attackers)
│   ├── attacks/                # Attack implementations
│   ├── reconnaissance/         # Probing and scanning
│   ├── adaptation/             # Strategy adaptation
│   └── red_agent.py            # Red Team orchestrator
│
├── battle_engine/              # Battle coordination
│   ├── orchestrator.py         # Main battle controller
│   ├── round_manager.py        # Round timing
│   ├── scoring_system.py       # Score tracking
│   └── logger.py               # Event logging
│
├── shared/                     # Shared utilities
│   ├── config.py               # Configuration
│   ├── constants.py            # Constants & enums
│   └── utils.py                # Utility functions
│
├── results/                    # Battle results & logs
├── tests/                      # Unit tests
├── docker/                     # Docker configuration
├── requirements.txt            # Python dependencies
├── setup.py                    # Package setup
├── run_battle.py               # Main entry point
└── README.md                   # This file

cd ai-security-battle

# Create virtual environment (recommended)
python -m venv venv
venv\Scripts\activate  # On Windows

# Install dependencies
pip install -r requirements.txt

python database/seed_data.py

# Standard battle (30 minutes, 10 rounds)
python run_battle.py

# Quick battle (10 minutes, 5 rounds)
python run_battle.py --quick

# Custom configuration
python run_battle.py --rounds 8 --duration 20

# Initialize database and run
python run_battle.py --init

pytest tests/ -v