ai-code-battle/starters/python

AI Code Battle - Python Starter Bot

A minimal Python bot for AI Code Battle. This starter kit includes:

• HTTP server with HMAC authentication
• Game state type definitions
• Stub strategy function (you fill this in!)
• Dockerfile for containerization

Quick Start

1. Copy this bot to your own repository
2. Edit strategy.py to implement your bot's logic
3. Build and run locally: docker build -t my-bot . && docker run -p 8080:8080 -e SHARED_SECRET=test my-bot
4. Test: curl http://localhost:8080/health should return "OK"
5. Register your bot at https://ai-code-battle.pages.dev/#/register

Strategy Interface

Edit strategy.py to implement your bot. The compute_moves() function receives:

• state: GameState object with visible bots, energy, cores, walls
• config: Game configuration (grid size, attack radius, etc.)

Return a list of move objects:

{
    "position": {"row": 5, "col": 10},  # Current position of bot to move
    "direction": "N"                    # One of: "N", "E", "S", "W", or "" for no move
}

Game Protocol

• Your bot receives POST /turn requests each turn with fog-filtered game state
• Request is signed with HMAC-SHA256 (verify for security)
• Respond with moves within 1 second timeout
• See protocol.md for full specification

Deployment

Push to your container registry and register the bot with the platform.