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.0.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.0-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kmathbraille-1.0.0.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.0.tar.gz
Algorithm Hash digest
SHA256 cde25adee4a0236982d22992d1eec837a4be9cc3d69dc1b74d3e0dd4635a6610
MD5 0c680ba9d1410b28094af4719a72d394
BLAKE2b-256 11fd2b2185a953bb043d2b87df4380515c37f535c63f3caa23af6df0f76a1140

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kmathbraille-1.0.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c5f9b5582d1ca7d009e5e0d5adfbddd12199bbf487b878294cc30bdcf6fad9ce
MD5 60c90093b337f583e8b8e78121e325e4
BLAKE2b-256 5c055c5f75f54396f06ba99e3b2ba0207fe16e83d1450b972cc4c7768e7b00fa

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