Repolode
Calix-L

Calix-L/DanKS

Agente de aprendizaje por refuerzo de código abierto para jugar GuanDan de forma competitiva, con una mesa web jugable.

Estrellas
705
Forks
22
Issues abiertos
1
Último commit
hace 15 días

¿Qué es?

DanKS es una base de código de investigación para crear jugadores de IA para GuanDan, un juego de cartas por parejas para cuatro jugadores con información oculta. El agente ordena las jugadas legales: primero recupera acciones candidatas estructuradas, luego evalúa cómo afecta cada jugada a las combinaciones que quedan en la mano y, por último, aprende a elegir mediante una red Actor-Critic condicionada por el estado y las candidatas, entrenada con PPO y GAE.

El repositorio se organiza en tres generaciones de IA (V1, V2 y V3), además de un paquete de refinamiento de inferencia, V3Pro, que incorpora protección de activos, reglas para jugadas equivalentes y búsqueda de final de partida sin necesidad de volver a entrenar. También incluye KSPlay GuanDan Service en dos versiones: una sala con backend, árbitro y frontend basados en navegador que puede ejecutarse localmente con bots de ejemplo basados en reglas y admite IA externas mediante una interfaz HTTP.

El proyecto enlaza a un conjunto de datos público de partidas de GuanDan jugadas por personas, mantenido en un repositorio relacionado, y ofrece ejemplos de recuperación, inferencia de modelos e integración de V3Pro con entradas sintéticas. No incluye los pesos entrenados ni la infraestructura privada de servicio.

Funciones clave

  • 01Recuperación estructurada de jugadas candidatas que evalúa la mano restante tras cada jugada
  • 02Política Actor-Critic entrenada mediante autojuego con PPO y GAE
  • 03Refinamiento de inferencia V3Pro con búsqueda de final de partida y reglas para jugadas equivalentes
  • 04Mesa de GuanDan en el navegador con backend de sala y árbitro
  • 05Interfaz HTTP para conectar una IA personalizada al servicio
  • 06Enlace a un conjunto de datos público de 899 partidas de GuanDan jugadas por personas

Casos de uso

  • Estudiar la toma de decisiones con información oculta en un juego de cartas por parejas
  • Entrenar y comparar políticas de aprendizaje por refuerzo en un entorno de juego de cartas
  • Crear una IA personalizada para GuanDan y conectarla a una mesa web local
  • Analizar registros de partidas humanas para estudiar la estructura de las manos y el juego por parejas

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/Calix-L/DanKS.git
  2. 2

    Entra en el directorio service y crea un entorno virtual de Python 3.12

    cd DanKS/services/v2 && python3.12 -m venv .venv && source .venv/bin/activate
  3. 3

    Instala los requisitos y compila arranger

    python -m pip install -r requirements.txt && python scripts/build_arranger.py
  4. 4

    Inicia la tabla local y, después, abre http://127.0.0.1:8000/solo

    python run.py

Antes de usarlo

  • La tabla local requiere Python 3.12 y Go 1.23 o posterior.
  • No se incluyen los pesos del modelo entrenado ni la infraestructura privada para servir IA.

Temas

Preguntas frecuentes

¿Qué es DanKS?
Agente de aprendizaje por refuerzo de código abierto para jugar GuanDan de forma competitiva, con una mesa web jugable. DanKS es una base de código de investigación para crear jugadores de IA para GuanDan, un juego de cartas por parejas para cuatro jugadores con información oculta. El agente ordena las jugadas legales: primero recupera acciones candidatas estructuradas, luego evalúa cómo afecta cada jugada a las combinaciones que quedan en la mano y, por último, aprende a elegir mediante una red Actor-Critic condicionada por el estado y las candidatas, entrenada con PPO y GAE.
¿DanKS es gratuito? ¿Qué licencia tiene?
DanKS es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿DanKS sigue mantenido?
Mantenimiento activo. El último commit de DanKS fue el 5 oct 2026.
¿Para qué puedo usar DanKS?
Estudiar la toma de decisiones con información oculta en un juego de cartas por parejas Entrenar y comparar políticas de aprendizaje por refuerzo en un entorno de juego de cartas Crear una IA personalizada para GuanDan y conectarla a una mesa web local Analizar registros de partidas humanas para estudiar la estructura de las manos y el juego por parejas
¿Cómo se instala DanKS?
Clona el repositorio: git clone https://github.com/Calix-L/DanKS.git Entra en el directorio service y crea un entorno virtual de Python 3.12: cd DanKS/services/v2 && python3.12 -m venv .venv && source .venv/bin/activate Instala los requisitos y compila arranger: python -m pip install -r requirements.txt && python scripts/build_arranger.py Inicia la tabla local y, después, abre http://127.0.0.1:8000/solo: python run.py
¿Dónde consigo DanKS?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Calix-L/DanKS

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados