Repolode
Calix-L

Calix-L/DanKS

Agente de aprendizado por reforço open source para GuanDan competitivo, um jogo de cartas em duplas com quatro jogadores, com uma mesa web jogável.

Estrelas
705
Forks
22
Issues abertas
1
Último commit
há 15 dias

O que é?

DanKS é uma base de código de pesquisa para criar jogadores de IA para GuanDan, um jogo de cartas em duplas com quatro jogadores e informação oculta. O agente classifica as jogadas legais primeiro recuperando ações candidatas estruturadas, depois avaliando como cada jogada afeta as combinações restantes na mão e, por fim, aprendendo a escolher com uma rede Actor-Critic condicionada ao estado e às ações candidatas, treinada com PPO e GAE.

O repositório está organizado em três gerações de IA (V1, V2, V3), além de um pacote V3Pro para refinamento de inferência que adiciona proteção de assets, regras para jogadas equivalentes e busca no fim da partida sem retreinamento. Também inclui o KSPlay GuanDan Service em duas versões: um backend de salas baseado em navegador, um árbitro e um frontend que podem ser executados localmente com bots de exemplo baseados em regras e aceitar IAs externas por uma interface HTTP.

O projeto contém um link para um dataset público de partidas de GuanDan disputadas por humanos, mantido em um repositório irmão, e oferece exemplos de recuperação, inferência de modelos e integração com V3Pro usando entradas sintéticas. Os pesos treinados e a infraestrutura privada de execução do serviço não estão incluídos.

Recursos principais

  • 01Recuperação estruturada de ações candidatas que avalia a mão restante após cada jogada
  • 02Política Actor-Critic treinada com PPO e GAE por self-play
  • 03Refinamento de inferência do V3Pro para busca no fim da partida e regras de jogadas equivalentes
  • 04Mesa de GuanDan baseada em navegador, com backend de salas e árbitro
  • 05Interface HTTP para conectar uma IA personalizada ao serviço
  • 06Link para um dataset público com 899 partidas de GuanDan disputadas por humanos

Casos de uso

  • Estudar a tomada de decisão com informação oculta em um jogo de cartas em duplas
  • Treinar e comparar políticas de aprendizado por reforço em um ambiente de jogo de cartas
  • Criar uma IA personalizada para GuanDan e conectá-la a uma mesa web local
  • Analisar registros de partidas humanas para estudar a estrutura das mãos e o jogo em duplas

Início rápido

  1. 1

    Clone o repositório

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

    Acesse o diretório service e crie um ambiente virtual com Python 3.12

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

    Instale os requisitos e compile o arranger

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

    Inicie a tabela local e, em seguida, abra http://127.0.0.1:8000/solo

    python run.py

Antes de usar

  • A tabela local requer Python 3.12 e Go 1.23 ou superior.
  • Os pesos do modelo treinado e a infraestrutura privada de serving de IA não estão incluídos.

Tópicos

Perguntas frequentes

O que é DanKS?
Agente de aprendizado por reforço open source para GuanDan competitivo, um jogo de cartas em duplas com quatro jogadores, com uma mesa web jogável. DanKS é uma base de código de pesquisa para criar jogadores de IA para GuanDan, um jogo de cartas em duplas com quatro jogadores e informação oculta. O agente classifica as jogadas legais primeiro recuperando ações candidatas estruturadas, depois avaliando como cada jogada afeta as combinações restantes na mão e, por fim, aprendendo a escolher com uma rede Actor-Critic condicionada ao estado e às ações candidatas, treinada com PPO e GAE.
DanKS é gratuito? Qual é a licença?
DanKS é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
DanKS ainda é mantido?
Manutenção ativa. O último commit de DanKS foi em 5 de out. de 2026.
Para que posso usar DanKS?
Estudar a tomada de decisão com informação oculta em um jogo de cartas em duplas Treinar e comparar políticas de aprendizado por reforço em um ambiente de jogo de cartas Criar uma IA personalizada para GuanDan e conectá-la a uma mesa web local Analisar registros de partidas humanas para estudar a estrutura das mãos e o jogo em duplas
Como instalar DanKS?
Clone o repositório: git clone https://github.com/Calix-L/DanKS.git Acesse o diretório service e crie um ambiente virtual com Python 3.12: cd DanKS/services/v2 && python3.12 -m venv .venv && source .venv/bin/activate Instale os requisitos e compile o arranger: python -m pip install -r requirements.txt && python scripts/build_arranger.py Inicie a tabela local e, em seguida, abra http://127.0.0.1:8000/solo: python run.py
Onde consigo DanKS?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Calix-L/DanKS

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados