Giter Site home page Giter Site logo

guansanghai / koikoi-ai Goto Github PK

View Code? Open in Web Editor NEW
16.0 2.0 1.0 67.09 MB

🎴Learning based AI for playing multi-round Koi-Koi hanafuda card games. Have fun.

Python 89.07% Jupyter Notebook 10.93%
pytorch machine-learning game-ai card-game hanafuda koi-koi deep-learning python pysimplegui reinforcement-learning

koikoi-ai's Introduction

Koi-Koi AI

S. Guan, J. Wang, R. Zhu, J. Qian and Z. Wei, “Learning to Play Koi-Koi Hanafuda Card Games with Transformers,” IEEE Transactions on Artificial Intelligence, vol. 4, no. 6, pp. 1449-1460, 2023. doi: 10.1109/TAI.2023.3240674. [PDF]

Learning based AI for playing multi-round Koi-Koi hanafuda card games. (@guansanghai)

Play Interface

Environment

  • Python 3
  • PyTorch 1.8.1
  • PySimpleGUI (for the interface playing vs AI)

About Koi-Koi Hanafuda Card Games

Hanafuda is a kind of traditional Japanese playing cards. A hanafuda deck contains 48 cards divided by 12 suits corresponding to 12 months, which are also divided into four rank-like categories with different importance. Koi-Koi is a kind of two-player hanafuda card game. The goal of Koi-Koi is to collect cards by matching the cards by suit, and forming specific winning hands called Yaku from the acquired pile to earn points from the opponent.

Hanafuda Deck

Rules & Yaku List

Koi-Koi is consisted by multiple rounds and both players start with equal points. In every round, two players discard and draw to pair and collect cards by turn until someone forms Yakus successfully. Then, he can end this round to receive points from the opponent, or claim koi-koi and continues this round to earn more yakus and points. The detailed rules and Yaku list of this project is the same as PC game KoiKoi-Japan on Steam.

Yaku List

koikoi-ai's People

Contributors

guansanghai avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

iggymacd

koikoi-ai's Issues

💖 the screenshot in your readme!

Very nice job of putting a screenshot in your readme. It looks GREAT! What a beautiful window you've made.... beatiful

Because it's a game and thus has an interface that changes often, it may work even better to have a GIF animation.... not that there's anything at ALL wrong or missing from what you've done! It's fantastic.

I use ShareX (https://getsharex.com/) to make animated GIFs. I don't know how this program makes TINY GIFs from large in size and length animations, but it does.

Here's one I made a while back and I simply copied and pasted into a GitHub Issue.... like I did here:

notepad

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.