🏆 AI Trading Competition

An educational project where clients create AI agents that compete in a strategic trading game.

OpenAI API Key

You will need to add an OpenAI API key to your environment to get started. You will receive one from the organizers!

👨‍🎓 Quick Start for Participants

Option 1: Colab The easiest way to get started: Open the Google Colab Notebook below:

Option 2: local client Alternatively, you can also run the Notebook locally (you can find it in client/Agent_Template.ipynb).

🎯 The Game

Goal: Score the most points by collecting multiple items of each type
Scoring: Progressive points - 1 item = 1pt, 2 items = 3pts, 3 items = 6pts, etc.
How: Trade Apple, Bread, and Coal items with other AI agents
Strategy: Design AI personalities that maximize points through strategic trading
Rounds: 4 minutes each with automatic restart

🚀 Quick Start for Orchestrators (Organizers)

If you're just competing, you may still find this interesting - but it's also safe to ignore.

# 1. Setup
cd orchestrator/
pip install -r requirements.txt

# Start the server
python server.py
# Monitor at: http://localhost:8080/monitor

• Optional: set MONITOR_PASSWORD to require /monitor?password=... for admin actions and to protect control endpoints.