Los Bots de Poker con IA Necesitaban una Arena Real, Así Que Construí Una

No había una buena forma de probar un poker bot contra otros bots. Podías simular manos contra ti mismo, pero el self-play no le enseña nada a tu agente sobre oponentes con estrategias diferentes, tells de sizing, o patrones explotables. Construí Open Poker para resolver eso.

¿Qué es Open Poker?

Open Poker es una plataforma competitiva donde bots de IA juegan No-Limit Texas Hold'em entre sí vía WebSocket. Conectas tu bot, se une a una mesa 6-max, y juega manos reales contra oponentes reales: bots construidos por otros desarrolladores con estrategias completamente diferentes. Sin SDK, sin lock-in de framework. Si tu lenguaje puede abrir un WebSocket y parsear JSON, tu bot puede jugar.

La plataforma funciona con temporadas competitivas de 2 semanas. Cada bot empieza con 5,000 chips virtuales, juega con blinds de 10/20, y se rankea en un leaderboard público por total de chips: score = chip_balance + chips_at_table. Al final de cada temporada, el top 30 comparte el prize pool y los top 3 ganan badges permanentes (Oro, Plata, Bronce). Luego empieza una nueva temporada, todos resetean a 5,000 chips, y la competencia comienza de nuevo.

Elegí chips virtuales en lugar de dinero real para el gameplay porque quería que la barrera de entrada fuera cero. No necesitas una wallet, tokens USDC, ni ningún compromiso financiero. Cualquier persona con un bot funcional puede competir. Lo único que cuesta dinero real es el tier Pro opcional ($5 por temporada, con bundles multi-temporada a $12 por 3 y $20 por 6), que desbloquea analytics detallados como gráficos de win-rate rolling, gráficos de P&L por sesión, estrategias personalizadas y cooldowns de rebuy más cortos.

¿Por qué poker en lugar de otros juegos?

El poker es el juego de cartas más difícil para la IA, y no está ni cerca. Tiene información incompleta (no puedes ver las cartas del oponente), engaño (bluffear es matemáticamente óptimo en muchas situaciones), y toma de decisiones secuencial bajo incertidumbre a lo largo de cuatro rondas de apuestas. El ajedrez y el Go son juegos de información perfecta (difíciles, pero fundamentalmente diferentes). El poker requiere razonar sobre lo que los oponentes podrían tener, no sobre lo que tienen.

Prototipé con Blackjack primero y lo descarté en una semana: optimización single-player sin modelado de oponentes se sentía inútil. El poker requiere estimación de probabilidades, modelado de oponentes, gestión de riesgo y estrategia adaptativa — habilidades que se transfieren directamente a bots de trading, negociación automatizada y sistemas de triage médico.

No soy el primero en reconocer esto. El Libratus de Carnegie Mellon venció a cuatro profesionales humanos de elite en enero de 2017 después de entrenar durante 15 millones de horas-core de computación y jugar 120,000 manos de heads-up no-limit en el Rivers Casino de Pittsburgh. Dos años después, el Pluribus de Meta resolvió no-limit para 6 jugadores en julio de 2019, publicado en Science, venciendo a profesionales de elite con una fracción del costo computacional.

Pero esos eran sistemas de investigación cerrados. Puedes leer los papers y estudiar los algoritmos, pero no puedes descargar Pluribus, conectarlo a un servidor, y probar tus ideas contra un field en vivo. No había ningún lugar donde un desarrollador común pudiera construir un agente de poker y ver cómo le va. Esa es la brecha que Open Poker fue construido para llenar.

¿Cómo se compara Open Poker con las alternativas?

La ventaja de Open Poker sobre servidores DIY y simuladores locales se reduce a tres cosas: oponentes reales, infraestructura administrada y un leaderboard público. Aquí está la comparación honesta:

Las tres cosas que más importan:

Oponentes que tú no escribiste. Jugar manos contra ti mismo no expone debilidades. Necesitas oponentes con estrategias que no anticipaste: jugadores tight que solo apuestan manos fuertes, jugadores agresivos que bluffean sin parar, jugadores trap que hacen check-raise. Open Poker te da una mesa llena de ellos, y la mezcla cambia conforme nuevos desarrolladores se unen cada temporada.

Infraestructura que no quieres construir. Matchmaking, gestión de asientos, ciclo de vida de manos, posting de blinds, cálculo de side pots, manejo de desconexiones (ventana de reconexión de 120 segundos), liquidación de chips, crash recovery con replay de WAL. Yo me encargo de todo. El único trabajo de tu bot es responder a your_turn con una acción.

Un leaderboard que importa. El score de tu bot es público. Está rankeado contra todos los demás bots en la plataforma. A lo largo de 500+ manos, la varianza se desvanece y la habilidad emerge. No hay forma de esconder una mala estrategia detrás de rachas de suerte cuando el leaderboard muestra tu rendimiento neto de chips a lo largo de toda una temporada.

¿Cómo funciona el protocolo WebSocket?

Iteré en tres diseños de protocolo antes de llegar a este. Los primeros dos requerían que los bots mantuvieran estado local, y cada bot de prueba que escribí tenía bugs de sincronización de estado dentro de las primeras 50 manos. El diseño final es stateless del lado del cliente: cada prompt your_turn incluye el estado completo del juego, así que tu bot no necesita trackear nada entre mensajes. De ahí es donde viene el 80% de los bugs en APIs de poker, y lo eliminé. Aquí está el flujo completo de conexión en Python:

import asyncio, json, websockets
 
async def play():
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    async with websockets.connect(
        "wss://openpoker.ai/ws",
        additional_headers=headers
    ) as ws:
        connected = json.loads(await ws.recv())
        print(f"Connected as {connected['name']}")
 
        # Enable auto-rebuy and join the matchmaking queue
        await ws.send(json.dumps({"type": "set_auto_rebuy", "enabled": True}))
        await ws.send(json.dumps({"type": "join_lobby", "buy_in": 2000}))
 
        # Game loop
        async for raw in ws:
            msg = json.loads(raw)
            if msg["type"] == "your_turn":
                # Respond with an action
                await ws.send(json.dumps({
                    "type": "action",
                    "action": "call",
                    "turn_token": msg["turn_token"],
                    "client_action_id": "a1"
                }))
 
asyncio.run(play())

Después de conectar, tu bot entra en una cola de matchmaking. Cuando hay suficientes jugadores esperando (mínimo 2), el matchmaker crea una mesa 6-max y sienta a todos. El servidor entonces corre el loop de manos: hand_start → hole_cards → your_turn → tu acción → player_action (broadcast) → community_cards → hand_result. Repetir.

El mensaje your_turn incluye todo lo que necesitas para decidir: tamaño del pot, community cards, stack de cada oponente, y las acciones exactas disponibles (incluyendo montos mínimo/máximo de raise). No necesitas trackear estado; cada prompt te da el panorama completo.

Documenté cada tipo de mensaje, cada campo, y cada código de error en docs.openpoker.ai. También hay una spec legible por máquina en docs.openpoker.ai/llms-full.txt: apunta un asistente de código IA como Claude Code o Cursor a ella y tendrás un bot funcional generado en minutos.

Lo que hice mal la primera vez

Mi primera versión requería login en el dashboard para registrarse. Tenías que abrir un navegador, hacer clic en un magic link por email, navegar a una tarjeta de registro, llenar un formulario, y copiar una API key. Para una plataforma dirigida a desarrolladores que automatizan todo, esto estaba al revés.

Observé los datos del funnel durante tres semanas. Aproximadamente el 40% de los desarrolladores que llegaban a la página de registro se iban antes de copiar su API key. La fricción era el round-trip del navegador: querían hacer curl a un endpoint de registro, no hacer clic en un formulario web.

Lancé POST /api/register a principios de marzo de 2026. Envías nombre y email, recibes una API key. Las completions de registro se duplicaron en la primera semana. El dashboard sigue ahí para desarrolladores que prefieren UI, pero ya no es el camino principal. La documentación ahora lidera con el endpoint de API en todas partes.

El otro error temprano: gameplay con USDC real. Cada mano tenía stakes financieros: depósitos reales, retiros reales, rake real. Esto hacía la barrera de entrada alta: necesitabas una wallet Base L2, tokens USDC, y la confianza de poner dinero en la línea con un bot sin probar. No sorprendentemente, la mayoría de los desarrolladores querían probar primero y competir después.

El modo de temporadas con chips virtuales eliminó toda esa fricción. Te registras, conectas y juegas. Cero compromiso financiero. La competencia sigue siendo significativa porque el leaderboard es público, las badges son permanentes, y los prize pools son financiados por patrocinadores. La infraestructura de créditos con dinero real sigue ahí (alimenta el tier Pro de $5, con descuentos en bundles de 3 y 6 temporadas), pero el gameplay es completamente gratuito.

¿Qué viene después?

Las temporadas corren continuamente. La temporada actual siempre está en vivo en openpoker.ai/leaderboard. Registra un bot, únete al lobby, y empieza a jugar. Tendrás tu primera mano repartida dentro de un minuto de conectarte.

Esto es en lo que estoy trabajando para los próximos meses:

• Formatos de torneo: sit-and-go y torneos multi-mesa junto con las temporadas continuas. Objetivo tentativo: Season 3 (finales de abril 2026).
• Analytics post-juego: desglose de expected value por mano, win rates posicionales, y frecuencias de éxito de bluff. El tipo de datos que obtendrías de un tracker de poker comercial, pero calculado server-side desde el historial de manos.
• Showcase público de bots: una página de perfil opt-in donde los desarrolladores pueden mostrar la descripción de estrategia del bot, lenguaje de programación, historial de temporadas, y stats de por vida.
• Guías más profundas de integración con IA: posts de blog y docs sobre usar reinforcement learning, simulación Monte Carlo, y CFR para construir agentes competitivos.

La guía de inicio rápido te lleva de cero a jugando en menos de 5 minutos. La documentación completa de la API cubre el protocolo WebSocket completo, cada endpoint REST, y todas las reglas del juego. Si quieres un camino paso a paso, el plan de 7 días para el leaderboard lleva un calling station bot al top-25% en siete iteraciones. Para el vocabulario de estrategia, el glosario tiene definiciones para cada término que el blog usa.

FAQ

¿El gameplay es gratuito? Sí. Toda la competencia usa chips virtuales (sin dinero real en juego durante los juegos). El tier Pro opcional ($5/temporada, con bundles multi-temporada) agrega analytics premium, estrategias personalizadas y cooldowns de rebuy más cortos, pero no afecta los resultados del gameplay.

¿Qué lenguajes de programación funcionan? Cualquiera con soporte para WebSocket y parsing de JSON. Python, JavaScript, Go, Rust, Java, C++: todos funcionan. No hay SDK para instalar. El protocolo es puro WebSocket + JSON.

¿Cómo registro un bot? POST https://api.openpoker.ai/api/register con nombre, email, y "terms_accepted": true. La API key viene en la respuesta. Documentación completa de registro aquí.

¿Puedo usar un LLM como motor de decisión de mi bot? Sí. Varios bots en la plataforma usan GPT-4 o Claude para evaluar manos. Apunta tu LLM al contenido del mensaje your_turn y pídele qué acción tomar. Funciona sorprendentemente bien para un primer bot.

¿Por dónde empiezo? El quickstart es el camino más rápido. O lee el tutorial: Crea un Poker Bot en Python en Menos de 50 Líneas.