auto-white-reimu

A mahjong library aimed to implement mahjong AIs by imitating white reimu -- a excellent mahjong player.

Requires Python 3.7 or later.

features

win-rate-demo

A demo for estimating win rate of a hand (using Monte Carlo method).

To run, clone the sources and install dependencies by typing

python setup.py install

in the root directory.

then, you can run the tools with

python mahjong/win_rate_demo.py.

A example of input hand should be like this:

2345678p2345777s

tenhou-record-check

This tools helps you to check your wining-efficiency(牌効率) during a play.

To run, clone the sources and install dependencies by typing

python setup.py install

in the root directory.

then, you can run the tools with

python mahjong/tenhou_record_check.py

then type your tenhou.net log url (likehttp://tenhou.net/0/?log=2019012600gm-0089-0000-100908f0&tw=0)

and your tenhou.net Playing name(likeLedenel, not the id you used to login tenhou.net and play)
(you can remain this to empty to generate check result for all players)

it will generate a html report for easy checking.

Testing

you could run test by executing pip install .[test] at root dir, this would install all dependence for you.

and run pytest in the root directory.

For PyCharm users, we provide some shared configuration in runConfigurations.zip.

Unzip these .xml settings and put them in your project .idea/runConfigurations/ directory. Then you would see it in PyCharm menu Run -> Edit Configurations. You may need to adjust Python Interpreter to your own environment in these settings.

PLEASE DON'T TRACK THESE .XML SETTING IN VERSION CONTROL.