koremu 1.0.0

Express integers as memorable, pronounceable strings.

koremu

Express integers as memorable, pronounceable strings — and turn them back into integers.

Koremu maps each 7-bit chunk of a non-negative integer to one of 128 pronounceable syllables, so a number like 10610353957 becomes koremutake. See http://shorl.com/koremutake for the original idea.

Installation

uv add koremu

Or, from a checkout:

uv pip install .

Usage

>>> from koremu import encode, decode
>>> encode(10610353957)
'koremutake'
>>> decode('koremutake')
10610353957

Pad the output to a minimum number of syllables:

>>> encode(0, syllables=3)
'bababa'

encode raises ValueError for negative numbers; decode raises ValueError for strings that aren't valid koremutake.

Development

This project is managed with uv.

uv sync          # set up the environment
uv run python -m unittest   # run the tests
uv build         # build the wheel and sdist

License

MIT — see LICENSE.