O Unity ML-Agents Toolkit permite usar jogos e simulações Unity como ambientes para treinar agentes de IA com aprendizado por reforço e por imitação.
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
Clone o repositório
git clone https://github.com/Calix-L/DanKS.git - 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
Instale os requisitos e compile o arranger
python -m pip install -r requirements.txt && python scripts/build_arranger.py - 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
Modelo open source de geração interativa de vídeos de jogos que transforma uma imagem de referência e comandos de teclado ou mouse em vídeos de gameplay controláveis.
Um livro introdutório e conciso sobre aprendizado por reforço, dos conceitos básicos a algoritmos aplicados, com implementações em PyTorch no repositório.
GUI em grafo de nós, API e backend para executar modelos de difusão localmente e gerar imagens, vídeos, áudio e conteúdo 3D.
Biblioteca Python que executa LLMs grandes camada por camada, permitindo inferência com modelos da classe 70B em uma única GPU de 4 GB, sem quantização.
Modelos generativos de vídeo open source em larga escala para texto para vídeo, imagem para vídeo, fala para vídeo e animação de personagens.