Skip to main content

Korean Mathematical Braille converter

Project description

🇰🇷 한국어 | 🇺🇸 English

kmathbraille ⠿

Standard Python library for translating LaTeX math expressions into Korean Braille
(as specified in the Ministry of Culture, Sports and Tourism Notice No. 2024-5.)

by Qualia Bridge


✨ Why kmathbraille?

In Korea, visually impaired students often cannot access math education in Braille. Existing tools lack accuracy, transparency, and extensibility.

kmathbraille is built by someone who sits at a rare intersection:

  • 📖 Braille specialist
  • 📊 Statistics & Data Science M.S.
  • 📈 Data visualization developer

🚧 Status

Currently in active development (stealth mode). Star this repo to follow along!

Roadmap

  • v0.1 — Basic arithmetic (+, -, *, /) & parentheses
  • v0.2 — Fractions (\frac) & mixed numbers
  • v0.3 — Exponents & subscripts (^, _)
  • v0.4 — Square roots (\sqrt)
  • v0.5 — Trigonometric functions
  • v1.0 — PyPI release 🚀
  • v1.1 — Full validation of Alphabetic Braille using in Korea
  • v2.0 — To be continued
  • v3.0 — To be continued

📦 Installation

You can install it via your terminal using the following command:

pip install kmathbraille

After installation, you can use it in your Python code as follows:

from kmathbraille import to_braille as tb

print(tb(r"\frac{1}{2}"))  # Output: ⠼⠃⠌⠼⠁ (Fractions)
print(tb(r"x^{2}"))        # Output: ⠭⠘⠼⠃ (Exponents & subscripts)
print(tb(r"\sqrt{2}"))     # Output: ⠜⠼⠃ (Square roots)
print(tb(r"\sin{x}"))      # Output: ⠖⠎⠭ (Trigonometric functions)

🤝 Contributing

Contributions welcome! Especially from Braille specialists and math educators.


📄 License

MIT License © 2026 Qualia Bridge

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kmathbraille-1.0.1.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kmathbraille-1.0.1-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file kmathbraille-1.0.1.tar.gz.

File metadata

  • Download URL: kmathbraille-1.0.1.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for kmathbraille-1.0.1.tar.gz
Algorithm Hash digest
SHA256 fc3be76e5fca1bd07f4fb5a283962f7dca894196c47e67e3a6a5968df6d376d2
MD5 c04bed3655ff62b88e68cd84eb2b436d
BLAKE2b-256 9f373bf6c6e2f3c67f93d2a0059814541c6f4eaae9231d6e694b992c2f49d5ad

See more details on using hashes here.

File details

Details for the file kmathbraille-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: kmathbraille-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for kmathbraille-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7696517b7d267b38e5664f785303ba63796cf3a894b2d2b66cd8ede3cfc6d474
MD5 59598837b67f352b4cd653305c27bd97
BLAKE2b-256 9f4081d5bbcb1c7e18a7bb63379398b201b16eb0493e5161e225d0e32659e1c6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page