<div align="center" style="background-color:#efeeeb;padding:20px"> <img src="https://raw.githubusercontent.com/dev-five-git/braillify/main/media/logo.svg" alt="Braillify" width="300" /> </div> <h3 align="center"> 실시간 한글 점역 라이브러리 </h3> <div align="center">

📖 소개

braillify는 **Braille(점자)**에 **-ify(~화하다)**를 더해, 한층 더 쉬운 점자화를 보다 널리 퍼뜨리고자 만든 프로젝트입니다.

모두가 점역을 이해하고 활용할 수 있는 환경을 함께 만들어갑니다.

✨ braillify의 특징

01 📋 2024 개정 한국 점자 규정 기반 점역기

braillify는 2024년 개정된 한국 점자 규정을 기반으로 설계되고 구현된 점역기입니다.

더 이상 유지보수가 어렵고, 레거시 코드에 의존해 최신 규정과 맞지 않는 점역기를 사용할 필요가 없습니다. 글의 문맥을 고려해 다양한 경우의 수를 판단하여 더욱 자연스럽고 정확한 점역 결과를 제공합니다.

02 🌐 완전한 오픈소스 프로젝트

기존에도 점사랑, 하상브레일 등 다양한 점역기가 존재했고, 일부는 API를 제공하기도 했습니다.

하지만 이들은 대부분 소스가 공개되지 않았고, 점역을 위해 API 서버에 연결해야 했습니다. braillify는 다릅니다. 누구나 접근하고, 함께 개선해 나갈 수 있도록 점자 표준 구현 전 과정을 오픈소스로 제공합니다.

03 🦀 Rust 기반 크로스 플랫폼

braillify는 Rust 언어로 개발되었으며, Node.js, Rust, Python 환경을 모두 지원합니다.

또한 **WebAssembly(wasm)**도 지원하여, 네트워크나 외부 연결 없이 자신의 PC에서 바로 실행 가능한 구조를 가지고 있습니다. 이를 통해 플랫폼에 구애받지 않고 더 자유롭고 유연한 활용이 가능합니다.

원하는 플랫폼이 있다면 Devfive와 함께 braillify를 확장하고 발전시켜보세요.

📦 개발 환경 가이드

설치 목록

Rust / Cargo: 코어 빌드 및 테스트
Bun: 스크립트 및 패키지 관리

테스트 명령어

# 표준 테스트(권장)
bun run test

# 모든 것을 테스트 (주의: 개선 중인 예외 케이스로 인해 일부 실패할 수 있습니다.)
cd libs/braillify && cargo test

디렉토리 설명

packages/ : 타 언어 바인딩 (Node.js, Python 등)
libs/braillify: Rust 기반 핵심 로직 (Core)

📦 설치

Node.js

npm install braillify

Python

pip install braillify

Rust

cargo add braillify

빠른 실행 (CLI)

설치 없이 바로 실행해 보고 싶다면:

npx braillify
# or
bunx braillify
# or
dnx braillify

Donors

Braillify

Install / Use

README