Unity ML-Agents Toolkit permite usar juegos y simulaciones de Unity como entornos para entrenar agentes de IA mediante aprendizaje por refuerzo e imitación.
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
Clona el repositorio
git clone https://github.com/Calix-L/DanKS.git - 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
Instala los requisitos y compila arranger
python -m pip install -r requirements.txt && python scripts/build_arranger.py - 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
Modelo de código abierto para generar videos interactivos de juegos a partir de una imagen de referencia y controles de teclado o mouse.
Un breve libro introductorio sobre aprendizaje por refuerzo, desde los fundamentos hasta algoritmos aplicados, con implementaciones en PyTorch en el repositorio.
Interfaz gráfica de nodos, API y backend para ejecutar modelos de difusión localmente y generar imágenes, video, audio y contenido 3D.
Biblioteca de Python que ejecuta modelos de lenguaje grandes capa por capa para que los modelos de 70B puedan inferir en una sola GPU de 4 GB, sin cuantización.
Modelos generativos de video de código abierto y gran escala para crear videos a partir de texto, imágenes o audio, y animar personajes.