@@ -2160,7 +2160,7 @@ <h3 id="docker-smoke-test">Docker Smoke Test</h3>
21602160< p > If any of these fail, see < a href ="#docker-issues "> Docker troubleshooting</ a > .</ p >
21612161< h3 id ="test-tournament "> Test Tournament</ h3 >
21622162< p > Run a minimal test tournament with dummy agents (no LLM calls):</ p >
2163- < div class ="highlight "> < pre > < span > </ span > < code > uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/test/battlesnake.yaml
2163+ < div class ="highlight "> < pre > < span > </ span > < code > uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/test/battlesnake.yaml
21642164</ code > </ pre > </ div >
21652165< p > This verifies:</ p >
21662166< ul >
@@ -2214,22 +2214,22 @@ <h2 id="configuration-tiers">Configuration Tiers</h2>
22142214</ table >
22152215< h3 id ="test-configs-free "> Test Configs (Free)</ h3 >
22162216< p > No LLM API calls - uses dummy agents that make no changes:</ p >
2217- < div class ="highlight "> < pre > < span > </ span > < code > uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/test/battlesnake.yaml
2217+ < div class ="highlight "> < pre > < span > </ span > < code > uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/test/battlesnake.yaml
22182218</ code > </ pre > </ div >
22192219< h3 id ="example-configs-quick-experiments "> Example Configs (Quick Experiments)</ h3 >
22202220< p > Short 5-round tournaments for learning and experimentation:</ p >
22212221< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # Claude Sonnet 4.5 vs o3 in BattleSnake (5 rounds)</ span >
2222- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/examples/BattleSnake__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml
2222+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/examples/BattleSnake__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml
22232223
22242224< span class ="c1 "> # Same matchup in other arenas</ span >
2225- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/examples/CoreWar__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml
2226- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/examples/Halite__claude-sonnet-4-5-20250929__o3__r5__s250.yaml
2227- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/examples/RoboCode__claude-sonnet-4-5-20250929__o3__r5__s250.yaml
2225+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/examples/CoreWar__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml
2226+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/examples/Halite__claude-sonnet-4-5-20250929__o3__r5__s250.yaml
2227+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/examples/RoboCode__claude-sonnet-4-5-20250929__o3__r5__s250.yaml
22282228</ code > </ pre > </ div >
22292229< h3 id ="main-configs-full-benchmarks "> Main Configs (Full Benchmarks)</ h3 >
22302230< p > Full 15-round tournaments used in the paper:</ p >
22312231< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # Full BattleSnake tournament</ span >
2232- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/main/BattleSnake__claude-sonnet-4-5-20250929__o3__r15__s1000.yaml
2232+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/main/BattleSnake__claude-sonnet-4-5-20250929__o3__r15__s1000.yaml
22332233</ code > </ pre > </ div >
22342234< div class ="admonition warning ">
22352235< p class ="admonition-title "> Cost Warning</ p >
@@ -2253,23 +2253,23 @@ <h2 id="quick-recipes">Quick Recipes</h2>
22532253< h3 id ="run-your-first-real-tournament "> Run your first real tournament</ h3 >
22542254< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # 1. Make sure you have API keys in .env</ span >
22552255< span class ="c1 "> # 2. Run a short example tournament</ span >
2256- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/examples/BattleSnake__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml
2256+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/examples/BattleSnake__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml
22572257
22582258< span class ="c1 "> # 3. View results</ span >
22592259uv< span class ="w "> </ span > run< span class ="w "> </ span > python< span class ="w "> </ span > scripts/run_viewer.py
22602260</ code > </ pre > </ div >
22612261< h3 id ="try-a-different-arena "> Try a different arena</ h3 >
22622262< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # CoreWar - Assembly-like programming battle</ span >
2263- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/examples/CoreWar__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml
2263+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/examples/CoreWar__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml
22642264
22652265< span class ="c1 "> # RobotRumble - Multi-robot combat</ span >
2266- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/examples/RobotRumble__claude-sonnet-4-5-20250929__o3__r5__s250.yaml
2266+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/examples/RobotRumble__claude-sonnet-4-5-20250929__o3__r5__s250.yaml
22672267</ code > </ pre > </ div >
22682268< h3 id ="create-a-custom-matchup "> Create a custom matchup</ h3 >
22692269< p > Copy an example config and modify:</ p >
22702270< div class ="highlight "> < pre > < span > </ span > < code > cp< span class ="w "> </ span > configs/examples/BattleSnake__claude-sonnet-4-5-20250929__o3__r5__s1000.yaml< span class ="w "> </ span > configs/my_tournament.yaml
22712271< span class ="c1 "> # Edit configs/my_tournament.yaml to change models, rounds, etc.</ span >
2272- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/my_tournament.yaml
2272+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/my_tournament.yaml
22732273</ code > </ pre > </ div >
22742274< h2 id ="troubleshooting "> Troubleshooting</ h2 >
22752275< h3 id ="docker-issues "> Docker Issues</ h3 >
@@ -2297,11 +2297,11 @@ <h3 id="api-key-issues">API Key Issues</h3>
22972297< h3 id ="import-errors "> Import Errors</ h3 >
22982298< p > < strong > "ModuleNotFoundError: No module named 'codeclash'"</ strong > </ p >
22992299< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # Make sure you're using uv run</ span >
2300- uv< span class ="w "> </ span > run< span class ="w "> </ span > python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/test/battlesnake.yaml
2300+ uv< span class ="w "> </ span > run< span class ="w "> </ span > codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/test/battlesnake.yaml
23012301
23022302< span class ="c1 "> # Or activate the virtual environment first</ span >
23032303< span class ="nb "> source</ span > < span class ="w "> </ span > .venv/bin/activate
2304- python < span class ="w "> </ span > main.py < span class ="w "> </ span > configs/test/battlesnake.yaml
2304+ codeclash < span class ="w "> </ span > run < span class ="w "> </ span > configs/test/battlesnake.yaml
23052305</ code > </ pre > </ div >
23062306< h2 id ="next-steps "> Next Steps</ h2 >
23072307< ul >
0 commit comments