Avo-k/colver-bid-v6

Colver — Bid v6 : le réseau qui annonce

Donnez-lui une main de 8 cartes, il vous dit quoi annoncer. C'est le modèle d'enchère qui joue contre vous sur colver.net, et la référence contre laquelle tout nouveau bidder du projet est mesuré.

Colver est un moteur de Belote Contrée écrit en Rust, utilisable depuis Python.

Code source · PyPI · Jouer en ligne

Règles appliquées : colver.net/regles — et pourquoi ces choix.

Essayer en 30 secondes

pip install colver

import random
import colver

RANGS = ["7", "8", "9", "V", "D", "R", "10", "A"]
COULEURS = "♠♥♦♣"                # une carte = couleur × 8 + rang

def nom_annonce(a):
    if a == 0:  return "Passe"
    if a <= 36: return f"{80 + (a - 1) // 4 * 10}{COULEURS[(a - 1) % 4]}"
    if a <= 40: return f"Capot{COULEURS[a - 37]}"
    return ("Contre", "Surcontre")[a - 41]

# Une donne au hasard, reproductible
paquet = list(range(32))
random.Random(21).shuffle(paquet)
mains = [sorted(paquet[i * 8:(i + 1) * 8]) for i in range(4)]

# siège 0 : ♠ D      ♥ D 7      ♦ A R V 9   ♣ A
# siège 1 : ♠ V 9 8  ♥ 10 V     ♦ —         ♣ D 9 7
# siège 2 : ♠ A R 7  ♥ —        ♦ 8 7       ♣ R V 8
# siège 3 : ♠ 10     ♥ A R 9 8  ♦ 10 D      ♣ 10

env = colver.Env.deal_with_hands(dealer=3, hands=mains)   # donneur 3 → le siège 0 ouvre

poids = colver.download_bid_model()      # Hub → ~/.cache/colver/models/
env.load_bid_model(poids)

reponse = env.action_bid_nn()
print(nom_annonce(reponse["best_action"]))     # -> 110♦

Le modèle annonce 110 à carreau. C'est là qu'est la main : quatre cartes dont le Valet et le 9, les deux plus fortes à l'atout, et l'As par-dessus.

Voir toutes ses préférences, pas seulement son choix

top = sorted(reponse["q_values"], key=lambda x: -x[1])[:5]
for action, q in top:
    print(f"{nom_annonce(action):>6}  {q:.3f}")

  110♦  0.100
  100♦  0.095
  120♦  0.092
   90♦  0.081
   80♦  0.056

Les quatre premières valeurs tiennent dans 0,02 — c'est un défaut connu et mesuré du modèle, décrit plus bas. Le classement dit clairement « carreau, autour de 110 » ; il ne dit pas grand-chose sur le choix exact entre 100 et 120.

Le modèle est entièrement déterministe : mêmes cartes, mêmes valeurs, à la décimale près.

Lire la réponse

C'est ce que fait nom_annonce ci-dessus :

Action	Signification
0	Passe
1 à 36	annonce — valeur = 80 + (a-1)//4 × 10, couleur = (a-1) % 4
37 à 40	capot, une par couleur
41 / 42	contre / surcontre

Les couleurs sont numérotées ♠ 0, ♥ 1, ♦ 2, ♣ 3, partout et pour tout — cartes comme annonces.

Pensez à masquer par env.legal_actions() avant de prendre l'argmax : le réseau note les 43 actions, y compris celles qui sont interdites dans la position.

Le faire jouer une donne entière

Plutôt que de piloter le réseau à la main, on peut asseoir un bot complet :

spec = f'''
[bid]
strategy = "nn"
model = "{poids}"
hidden = 512
score_aware = true
'''
bot = colver.Agent(spec, seat=0)
bot.init_deal(env)
print(bot.action(env))

score_aware = true compte : ce modèle voit le score de la partie et n'annonce pas pareil à 900-200 qu'à 0-0.

Le modèle en bref

Type	Dueling DQN (MLP), 117 entrées → 43 valeurs Q
Taille	2,4 Mo — 611 372 paramètres
Entraînement	75 M pas, contre un pool de 5 M de donnes étiquetées par IS-DD
Vitesse	quelques microsecondes par décision, sur CPU
sha256	9443671cab1e35bb…

En entrée : la main, l'historique des annonces, la position à table, le score de la partie et 4 bits « j'ai la belote ». Le modèle joue ses propres enchères pendant l'entraînement — l'oracle ne fait que superviser la perte. Le faire annoncer à l'oracle produirait des enchères dégénérées (annonce optimale → 3 passes) qui n'apprennent rien de la dimension de dialogue.

Ce qu'il vaut

Face à son prédécesseur v5, sur des matchs en 2000 points appariés en duplicate :

Adversaire	Jeu de la carte	Résultat
Bid v5 ISDD	DouDou50	55,8 %
Bid v5 ISDD	IS-DD	57,3 %, +181 pts/match

Ce qu'il ne sait pas faire

Trois défauts mesurés, qui motivent une v7 :

1. Il n'est pas indifférent au nom des couleurs. 24,6 % de ses annonces changent si l'on renomme les couleurs, alors que rien ne distingue Pique de Trèfle avant qu'un atout soit nommé.
2. Ses meilleures valeurs sont trop proches — visible dans l'exemple ci-dessus. Le choix entre 100 et 120 est peu informé.
3. Il n'annonce jamais capot : 0 fois sur 3000 enchères.

À noter aussi : une main seule n'explique que ~17 % de la variance de l'issue. L'essentiel du signal vient de l'historique des annonces — ce que partenaire et adversaires ont dit.

Détails d'implémentation

Le fichier est un tableau de flottants 32 bits sans en-tête : la bibliothèque déduit l'architecture de sa taille. Si vous écrivez votre propre chargeur, la disposition des poids et l'ordre exact des 117 entrées sont dans bid_net.rs et bid_obs.rs.

Un point qui n'est pas détectable depuis le fichier : ce modèle attend l'observation physique, pas canonique (la canonicalisation par couleur arrive en v7). Se tromper est silencieux — le réseau rend une annonce légale dans la mauvaise couleur.

Règles

Barème « points faits + demandés », base 162 (252 sur capot réalisé), contre ×2 et surcontre ×3 sur la valeur du contrat seule, aucun arrondi.

Entraîné avant le correctif de règle du 2026-08-02, qui élargit légèrement l'ensemble des coups légaux. Effet mesuré : 0,076 % des décisions concernées, 0,014 % effectivement changées. Le modèle est très légèrement hors-distribution, pas invalide.

Licence

MIT.

@software{colver,
  author = {Avo-k},
  title  = {Colver: a Belote Contrée engine with RL agents},
  url    = {https://github.com/Avo-k/colver}
}