Mahjong Learner / 麻将学习室
An offline Tkinter desktop application for learning four-player riichi mahjong. The interface is primarily Chinese, with Japanese mahjong terminology.
Install and run
python -m pip install mahjong-learner
mahjong-learner
Alternatively use python -m mahjong_learner. Run mahjong-learner --help
for direct tool shortcuts, for example mahjong-learner --tool point-drill.
Python 3.10 or newer, Tcl/Tk, and a graphical desktop are required.
On Windows, use a Python installation that includes Tcl/Tk. Linux users may
need their distribution's python3-tk package. This is not a browser or
headless application. The release was verified on Windows with Python 3.12.
PyTorch is a runtime dependency for the existing four-player game engine;
the download can be large even though no trained weights are distributed.
Nine tools
- Four-player east-round game against rule-based AI.
- AI spectator mode with pause and speed controls.
- Tile-efficiency practice with discard and acceptance analysis.
- Hand score calculator with waits, yaku, han, fu, and payments.
- Fu calculation practice.
- Yaku identification quiz.
- Point calculation practice: han/fu, dealer/non-dealer, ron/tsumo, answer explanations, and session accuracy statistics.
- Seventeen-step mahjong.
- Two-player wait-guessing game inspired by Ten, using the rules shown in the application rather than claiming a complete manga reproduction.
Scoring does not use kiriage mangan: 3 han 60 fu and 4 han 30 fu remain below mangan. Point drills use four-player payments, zero honba, and no riichi sticks. The rules are project-specific and are not a certified tournament ruleset.
Data and model files
The package contains the local tile artwork and works offline after installation.
No trained .pt checkpoints, local credentials, or user practice data are included.
Missing neural checkpoints use the existing rule-based AI strategies.
Tile artwork comes from FluffyStuff/riichi-mahjong-tiles and is dedicated to the
public domain under CC0; see the bundled THIRD_PARTY_NOTICES.txt.
0.1.0
First PyPI release: nine desktop tools, shared scoring and rule fixes, light UI theme, responsive layouts, and local point-calculation exercises.
1 maintainer
Metadata
1 maintainer
Release files for mahjong-learner 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mahjong_learner-0.1.0.tar.gz | 1.8 MB | Without provenance | Details for mahjong_learner-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mahjong_learner-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for mahjong_learner-0.1.0-py3-none-any.whl |
Total release size: 3.7 MB
Release files / mahjong_learner-0.1.0.tar.gz
| Download URL | mahjong_learner-0.1.0.tar.gz |
|---|---|
| Size | 1.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a537fba39ca92416ad21ec36a4cd871550edf035eac5c35f67153e0a3823175f
|
|
BLAKE2b-256 checksum How to use checksums |
cc2f8d9886df25af7ea1ff1250b63bcc05416b7eb2afc237da26b21d0803c760
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.9
|
Release files / mahjong_learner-0.1.0-py3-none-any.whl
| Download URL | mahjong_learner-0.1.0-py3-none-any.whl |
|---|---|
| Size | 1.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e55b3dacf17b3484cf8a7ddd22bedf57ef9acae01d5b54bf8702d10ba5070467
|
|
BLAKE2b-256 checksum How to use checksums |
e358d8a1e4cb3a1f3c7b6d4b607acadb61ae5a65e001df0b20b1842b4f52b14a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.9
|
Security for mahjong-learner 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
