Braillify란? [ 2024 개정 한국 점자 규정을 구현한 라이브러리 ]

2024 개정 한국 점자 규정을 코드로 구현한 오픈소스 점역 라이브러리

디지털 접근성에서 가장 중요한 질문 중 하나는 이것입니다.

“화면에 보이는 글자를 시각장애인이 실제로 읽을 수 있는 형태로 바꿀 수 있는가?”

스크린리더는 텍스트를 음성으로 읽어주지만, 모든 학습 환경이 음성만으로 해결되지는 않습니다. 특히 국어, 수학, 과학, 외국어, 음악처럼 정확한 표기 규칙이 중요한 분야에서는 점자 변환, 즉 점역이 필요합니다.

이번에 살펴볼 GitHub 프로젝트 Braillify는 바로 이 지점을 겨냥한 오픈소스 라이브러리입니다. 저장소 설명에 따르면 Braillify는 “점역, 역점역 라이브러리”를 목표로 하며, README에서는 특히 실시간 한글 점역 라이브러리라는 방향을 강조하고 있습니다. 

https://github.com/dev-five-git/braillify

GitHub - dev-five-git/braillify: 점역, 역점역 라이브러리

https://github.com/Maccrey/braillify

GitHub - Maccrey/braillify: 점역, 역점역 라이브러리

 

1. Braillify를 한 문장으로 설명하면?

Braillify는 한글 텍스트를 한국 점자 규정에 맞게 점자로 변환하기 위한 Rust 기반 크로스플랫폼 오픈소스 라이브러리입니다.

프로젝트 이름도 의미가 분명합니다. README에서는 Braille, 즉 점자에 -ify, “~화하다”라는 뜻을 붙여 “더 쉬운 점자화를 널리 퍼뜨리기 위한 프로젝트”라고 소개합니다. 

초보자 입장에서 쉽게 말하면, Braillify는 다음과 같은 역할을 합니다.

“안녕하세요” 같은 일반 텍스트를
컴퓨터가 처리할 수 있는 점자 데이터 또는 점자 유니코드 형태로 바꿔주는 도구

즉, 사람이 직접 점역 규칙을 하나하나 적용하지 않아도, 프로그램 안에서 자동으로 점자 변환을 수행할 수 있게 도와주는 라이브러리입니다.

2. 왜 Braillify가 중요한가?

점역은 단순한 글자 치환이 아닙니다.
한글을 점자로 바꾸는 일은 “ㄱ은 이것, ㅏ는 이것”처럼 단순 매칭만으로 끝나지 않습니다.

한글에는 초성, 중성, 종성이 있고, 약자와 약어가 있으며, 문맥에 따라 다르게 처리해야 하는 규칙도 있습니다. 수학이나 과학으로 넘어가면 더 복잡해집니다. 분수, 지수, 괄호, 수식 기호, 로마자, 그리스 문자, 국제음성기호 같은 요소까지 고려해야 합니다.

더 중요한 점은 한국 점자 규정이 2024년에 개정되었다는 사실입니다. 국립국어원 자료에는 2024 개정 한국 점자 규정이 2024년 2월 13일 등록되어 있으며, 한글 점자, 수학 점자, 과학 점자, 한국 음악 점자, 서양 음악 점자, 외국어 점자, 국제음성기호 점자 등이 포함되어 있습니다.  문화체육관광부 고시 자료에 따르면 해당 개정 규정은 2024년 3월 1일부터 시행되었습니다. 

따라서 점역 도구는 단순히 “예전에 돌아가던 코드”가 아니라, 최신 규정에 맞게 계속 갱신되는 구조가 중요합니다. Braillify README도 이 점을 강조합니다. 기존 레거시 점역기에 의존하지 않고, 2024년 개정 한국 점자 규정을 기반으로 설계·구현되었다고 설명합니다. 

3. Braillify의 핵심 특징 3가지

첫째, 2024 개정 한국 점자 규정 기반

Braillify의 가장 큰 특징은 2024 개정 한국 점자 규정 기반 점역기라는 점입니다. README는 Braillify가 글의 문맥을 고려해 다양한 경우의 수를 판단하고, 더 자연스럽고 정확한 점역 결과를 제공하는 것을 목표로 한다고 설명합니다. 

이 부분은 접근성 작업에서 매우 중요합니다.
PDF 접근성, 교과서 점역, 학습 자료 변환, 시각장애 학생용 교육 콘텐츠 제작에서는 “대충 비슷하게 읽히는 것”이 아니라 규정에 맞는 정확한 표기가 필요하기 때문입니다.

특히 수학과 과학 자료는 문맥 하나가 바뀌면 의미가 크게 달라질 수 있습니다. 예를 들어 마이너스 기호, 괄호, 위첨자, 아래첨자, 분수, 벡터 기호 등은 일반 음성 낭독보다 훨씬 엄격한 구조화가 필요합니다.

둘째, 완전한 오픈소스 프로젝트

Braillify는 오픈소스라는 점도 강점입니다. README는 기존에도 점사랑, 하상브레일 등 다양한 점역기가 있었고 일부는 API를 제공했지만, 대부분 소스가 공개되지 않았거나 점역을 위해 API 서버 연결이 필요했다고 설명합니다. 반면 Braillify는 점자 표준 구현 과정을 오픈소스로 제공해 누구나 접근하고 함께 개선할 수 있도록 한다고 밝히고 있습니다. 

이것은 단순히 개발자에게만 좋은 일이 아닙니다.

교육기관, 복지기관, 공공기관, 출판사, PDF 접근성 작업자 입장에서도 오픈소스는 큰 의미가 있습니다.
점역 결과가 이상할 때 내부 규칙을 확인할 수 있고, 오류를 이슈로 제보할 수 있으며, 필요하면 직접 개선에 참여할 수 있기 때문입니다.

특히 공공 문서나 교과서 접근성처럼 사회적 책임이 큰 영역에서는 검증 가능한 오픈소스 점역 엔진이 매우 중요합니다.

셋째, Rust 기반 크로스플랫폼 구조

Braillify는 Rust로 개발되었고, Node.js, Rust, Python 환경을 모두 지원합니다. README는 WebAssembly, 즉 WASM도 지원하여 네트워크나 외부 연결 없이 PC에서 바로 실행 가능한 구조를 갖고 있다고 설명합니다. 

Rust 기반이라는 점은 기술적으로 의미가 큽니다.

Rust는 성능과 안정성을 모두 중시하는 언어입니다. 점역 엔진처럼 문자열을 많이 처리하고, 규칙을 정확하게 적용해야 하며, 여러 플랫폼에서 안정적으로 동작해야 하는 도구에는 잘 맞는 선택입니다.

실제 저장소의 핵심 로직은 libs/braillify에 있고, 패키지 바인딩은 packages/ 아래에서 Node.js, Python 등으로 나뉘어 관리됩니다. README도 libs/braillify를 Rust 기반 핵심 로직, packages/를 다른 언어 바인딩 영역으로 설명합니다. 

4. 설치 방법

Braillify는 여러 환경에서 사용할 수 있습니다.

Node.js 환경에서는 다음처럼 설치합니다.

npm install braillify

Python 환경에서는 다음 명령어를 사용합니다.

pip install braillify

Rust 프로젝트에서는 다음처럼 추가할 수 있습니다.

cargo add braillify

README는 설치 없이 빠르게 실행해보고 싶을 때 npx braillify, bunx braillify, dnx braillify 명령도 사용할 수 있다고 안내합니다. 

npx braillify

PyPI 기준으로 braillify 패키지의 최신 표시 버전은 2.0.0이며, 2026년 4월 8일 릴리스로 등록되어 있습니다. (PyPI) 다만 GitHub 저장소의 일부 메타데이터에서는 패키지별 버전 정보가 다르게 보입니다. 예를 들어 Node 패키지 설정 파일에는 2.0.1, Python 패키지 설정 파일에도 2.0.1이 표시됩니다. 따라서 실제 사용 시에는 npm, PyPI, crates.io 등 자신이 사용하는 패키지 저장소의 최신 버전을 확인하는 것이 좋습니다.

5. 실제로 어떻게 쓸 수 있을까?

가장 쉬운 방식은 CLI로 테스트하는 것입니다.

npx braillify

또는 Rust 프로젝트 안에서는 라이브러리 함수로 사용할 수 있습니다. 저장소의 Rust 코드에는 encode, encode_with_options, encode_with_formatting, encode_to_unicode 같은 함수가 노출되어 있습니다. 

예를 들어 개념적으로는 다음과 같은 흐름을 생각할 수 있습니다.

use braillify::encode_to_unicode;

fn main() {
    let result = encode_to_unicode("안녕하세요").unwrap();
    println!("{}", result);
}

이 코드는 일반 한글 텍스트를 점자 유니코드 문자열로 변환하는 흐름을 보여줍니다. 실제 프로젝트에서는 변환 결과를 웹 화면, PDF 생성 도구, 점자 출력 시스템, 접근성 검증 도구 등에 연결할 수 있습니다.

6. PDF 접근성 작업과 Braillify의 연결 가능성

Braillify는 특히 PDF 접근성 작업과 잘 어울립니다.

PDF 접근성 작업에서는 보통 다음 문제가 자주 발생합니다.

문서에는 텍스트가 있지만 읽기 순서가 엉켜 있다.
수학 기호가 스크린리더에서 이상하게 읽힌다.
이미지로 된 수식이나 도형에 대체텍스트가 필요하다.
점자 자료로 변환해야 하는데 수작업 검수가 너무 오래 걸린다.
특수기호, 괄호, 약자, 로마자, 숫자 처리가 일관되지 않다.

Braillify는 이런 문제를 직접 모두 해결하는 완성형 PDF 접근성 도구는 아닙니다. 그러나 점역 엔진으로서 중요한 역할을 할 수 있습니다.

예를 들어 다음과 같은 구조가 가능합니다.

1. PDF에서 텍스트 추출
2. 읽기 순서와 태그 구조 정리
3. 수학·과학·한글 문장 단위로 텍스트 정제
4. Braillify로 점자 변환
5. 변환 결과를 점자 파일, 검수용 텍스트, 보조자료로 활용

특히 Braillify의 코드에는 PDF 수학 문맥에서 Unicode Mathematical Alphanumeric Symbols를 일반 ASCII 문자로 정규화하는 처리, 부정 결합 부호 처리, 강조·굵은 글자 같은 서식 표지 처리 관련 로직이 포함되어 있습니다. 이 점은 교과서, 수학 정답지, 학습 자료 접근성 작업에서 꽤 의미 있는 방향입니다.

7. 교육 콘텐츠와 시각장애 학습자에게 주는 의미

Braillify가 중요한 이유는 단지 개발자용 라이브러리라서가 아닙니다.
이 프로젝트는 교육 접근성과 연결됩니다.

시각장애 학습자는 같은 교재를 접하더라도, 자료가 점자나 스크린리더 친화 형식으로 제공되지 않으면 학습 속도와 이해도가 크게 떨어질 수 있습니다. 특히 수학, 과학, 외국어, 음악처럼 기호와 구조가 중요한 과목에서는 단순 음성 변환만으로 충분하지 않습니다.

Braillify 같은 도구가 발전하면 다음과 같은 활용이 가능해집니다.

교과서 텍스트를 점자 변환 검수용으로 빠르게 생성할 수 있습니다.
웹 서비스에서 한글 입력을 실시간 점자로 보여줄 수 있습니다.
시각장애 학생용 학습 앱에 점자 변환 기능을 넣을 수 있습니다.
출판사나 교육기관이 점역 초안을 자동으로 만들고 전문가가 검수할 수 있습니다.
PDF 접근성 작업자가 복잡한 문장을 점자 규정 기반으로 확인할 수 있습니다.

즉, Braillify는 단순한 개발 도구가 아니라 디지털 학습 접근성을 높이는 기반 기술로 볼 수 있습니다.

8. 개발자 관점에서 본 구조

Braillify 저장소는 Rust 중심의 코어와 여러 언어 바인딩으로 구성되어 있습니다. GitHub 저장소의 언어 비중도 Rust가 가장 크고, TypeScript, C#, Python, MDX 등이 함께 사용됩니다. 

루트 package.json을 보면 테스트와 빌드 흐름도 꽤 체계적으로 구성되어 있습니다. 테스트 명령은 Rust 테스트, Bun 테스트, Python pytest를 함께 실행하는 구조이고, 빌드는 Rust 릴리스 빌드, Node 패키지 빌드, Python 패키지 빌드를 포함합니다. 

Node 패키지는 WASM 기반 번들 구조를 사용합니다. packages/node/package.json에는 wasm-pack build로 빌드하고, WASM 파일을 패키지에 포함하는 구성이 보입니다. Python 패키지는 maturin을 빌드 백엔드로 사용해 Rust 코드를 Python 확장 모듈로 배포하는 구조입니다. 

 

이 구조를 쉽게 말하면 다음과 같습니다.

핵심 점역 엔진은 Rust로 빠르고 안전하게 만들고, 사용자는 Node.js·Python·Rust 같은 익숙한 환경에서 가져다 쓸 수 있게 만든 방식입니다.

9. Braillify의 장점

Braillify의 가장 큰 장점은 최신 한국 점자 규정 기반이라는 점입니다. 점역은 규정이 핵심인데, Braillify는 2024 개정 규정을 기준으로 설계되었다고 명시합니다. 

두 번째 장점은 오픈소스입니다. 점역 규칙은 결과의 신뢰성이 중요하기 때문에 내부 구현을 볼 수 있다는 점이 큽니다. GitHub 저장소는 Apache-2.0 라이선스로 공개되어 있습니다. 

세 번째 장점은 크로스플랫폼입니다. Node.js, Python, Rust, WASM을 지원하므로 웹 서비스, CLI 도구, 서버 프로그램, 교육용 앱 등 다양한 방식으로 확장할 수 있습니다. 

네 번째 장점은 접근성 생태계와 잘 맞는다는 점입니다. PDF 접근성, 교재 점역, 웹 접근성, 시각장애인 학습 지원 서비스에서 활용 가능성이 큽니다.

10. 주의할 점

Braillify는 매우 흥미로운 프로젝트지만, 실제 서비스나 공공 자료 제작에 바로 적용할 때는 몇 가지 주의가 필요합니다.

첫째, 점역 결과는 반드시 전문가 검수가 필요합니다.
점역은 규칙이 복잡하고 문맥 의존성이 강합니다. 자동 변환 결과가 좋아도, 교과서·시험지·공공문서처럼 정확성이 중요한 자료는 점역 전문가의 검수가 필요합니다.

둘째, README와 패키지별 버전 정보가 완전히 동일하게 보이지 않을 수 있습니다.
GitHub 릴리스 영역에서는 최신 릴리스가 1.0.11로 표시되는 반면, PyPI에는 2.0.0, 저장소 내부 Node/Python 패키지 설정에는 2.0.1이 보입니다.  따라서 실제 설치 전에는 사용하는 생태계의 패키지 페이지를 확인하는 편이 안전합니다.

셋째, “점역”과 “역점역” 범위는 구분해서 봐야 합니다.
GitHub 저장소 설명에는 점역·역점역 라이브러리라고 되어 있지만, README에서 가장 자세히 설명되는 부분은 한글 점역 기능과 크로스플랫폼 구조입니다. 실제 역점역 기능을 업무에 쓰려면 현재 API와 지원 범위를 별도로 확인해야 합니다.

---

Braillify는 한국어 디지털 접근성을 위한 중요한 오픈소스 기반이다

Braillify는 단순한 “한글을 점자로 바꾸는 작은 도구”가 아닙니다.

이 프로젝트의 의미는 더 큽니다.

2024 개정 한국 점자 규정을 기반으로 하고, Rust로 핵심 엔진을 만들고, Node.js·Python·Rust·WASM 환경에서 쓸 수 있도록 확장하며, 전체 구현을 오픈소스로 공개한다는 점에서 한국어 접근성 생태계에 중요한 기반 기술이 될 수 있습니다.

 

앞으로 PDF 접근성, 교과서 점역, 학습 앱, 시각장애인용 웹 서비스, 공공문서 변환 도구가 발전하려면 “정확한 점역 엔진”이 필요합니다. Braillify는 그 출발점이 될 수 있는 프로젝트입니다.

 

특히 접근성 작업자, 교육 콘텐츠 제작자, 개발자, 공공문서 담당자라면 이 프로젝트를 눈여겨볼 만합니다.

한 줄로 정리하면 이렇습니다.

 

Braillify는 한국어 텍스트를 최신 점자 규정에 맞게 변환하기 위한 오픈소스 점역 엔진이며, 디지털 접근성과 교육 접근성을 연결하는 중요한 기술적 기반입니다.

---

당신을 위한 3줄 요약

Braillify는 2024 개정 한국 점자 규정을 기반으로 한 Rust 중심의 오픈소스 한글 점역 라이브러리입니다.
Node.js, Python, Rust, WebAssembly를 지원해 웹, 앱, CLI, PDF 접근성 작업 등 다양한 환경에 연결할 수 있습니다.
실제 공공문서나 교과서 제작에 활용할 때는 자동 점역 결과를 전문가 검수와 함께 사용하는 것이 안전합니다.

3 line summary for you

Braillify is an open-source Korean braille translation library based on the 2024 revised Korean braille rules.
It is built in Rust and supports Node.js, Python, Rust, and WebAssembly for cross-platform use.
For official documents or textbooks, its output should be reviewed by braille accessibility experts.