Troubleshooting
ModuleNotFoundError: No module named 'rich'
The rich dependency is not installed. Install the package or its dependencies:
python -m pip install .
or:
python -m pip install rich pyfiglet
ModuleNotFoundError: No module named 'pyfiglet'
Same cause as above for the pyfiglet dependency. Install it with the commands above.
ModuleNotFoundError: No module named 'PIL'
Pillow is missing; it is only required for screenshots. Install the screenshot extra:
python -m pip install .[screenshot]
or:
python -m pip install Pillow
h9a: command not found (or "not recognized" on Windows)
The package is not installed (or the h9a script directory is not on your PATH). Either install the package:
python -m pip install .
or run the module instead:
python -m h9a
The output has no colors
The rich library disables colors when it detects a terminal that does not support them (or when output is piped), and --no-color disables them explicitly. This is expected behavior, not an error. The calculation result is still correct.
Output looks misaligned / wrapped
This can happen in very narrow terminals because the ASCII banner is fixed-width text. Widen your terminal window or reduce the terminal font size.
h9a: error: argument --digit: ... (exit code 2)
Invalid arguments, for example a digit outside 0-9 or --start greater than --end. Check your arguments; see cli.md.
Other issues
If something else goes wrong, verify your environment:
python --version
python -m pip show h9a rich pyfiglet Pillow
Then open an issue on the project repository.