i151-arena-sdk 0.2.2

SDK étudiant pour la compétition IA i151

i151-arena-sdk

SDK étudiant pour la compétition IA i151 — développez, testez et emballez votre bot sans cloner le dépôt.

Le moteur de jeu i151-engine est installé automatiquement.

Prérequis : Python 3.11+

Installation

python3 -m venv .venv && source .venv/bin/activate
pip install i151-arena-sdk

Vérifier :

arena --help

Option ML local : pip install "i151-arena-sdk[ml]" (ajoute numpy).

Démarrage rapide

arena init mon-bot
cd mon-bot
pip install -r requirements.txt
arena test bot.py
arena match bot.py --vs random --seed 42
arena pack .

arena pack produit un ZIP prêt pour le dashboard (inscription → upload).

Interface bot

Votre bot.py doit définir :

from arena_sdk import PlayerView, Action

def decide(view: PlayerView, legal_actions: list[Action], time_left_ms: int) -> Action:
    return legal_actions[0]

Fonctions optionnelles pour charger un modèle ML :

from pathlib import Path

def setup(submission_dir: Path) -> None:
    ...

def teardown() -> None:
    ...

Retournez toujours une action de legal_actions, sinon forfait.

CLI

Commande	Description
arena init [dossier]	Créer un projet (bot.py, requirements.txt, …)
arena test bot.py	Smoke test vs builtin:random
arena match bot.py --vs random	Match complet (jusqu'à 151 pts)
arena match bot.py --vs basic	Affronter l'exemple glouton
arena match bot.py --replay-out replay.json	Enregistrer le replay JSON
arena pack .	ZIP de soumission (bot.py + imports locaux + requirements + modèles)
arena pack . --entry ml_bot.py --model champion.pt	Entry et modèle explicites (champion.pt → model.pt dans le ZIP)

Options utiles pour arena match : --seed, --target-score, --cards-per-player, --json.

Exemples inclus dans le package

Alias	Description
starter	Première action légale
basic	Heuristique gloutonne
medium	Basic+ (scoring contextuel, pression couleurs)

arena test starter
arena match basic --vs random --seed 42
arena match medium --vs basic --seed 42

Adversaires CLI : random, starter, basic, medium, builtin:random, ou chemin vers bot.py.

ML (local)

from arena_sdk.features import encode_view, action_from_index

Entraînement en local ; seule l'inférence est autorisée en match. Packages pip autorisés : voir la whitelist.

API réexportée

Depuis i151-engine : PlayerView, Action, ActionType, MatchConfig, MatchResult, play_match.

Documentation

Ressource	Lien
Plateforme (inscription, matchs, ELO)	i151.djamma.dev
Tutoriel complet	docs/tutorial
Règlement	docs/reglement
Architecture (PlayerView, replays)	docs/architecture

Classement

Les matchs contre builtin:random ne comptent pas au classement (calibration). Les matchs bot vs bot entre équipes sont notés (Elo initial 1500).