azooKey/azooKey-Desktop

azooKey‑Desktop – macOS용 일본어 입력기

무엇인가요

• macOS용 오픈소스 일본어 입력기(입력법 편집기)로, 시스템의 가나-한자 변환을 Zenzai라는 신경망 모델로 대체합니다. 프로젝트는 선택적 LLM 기반의 "스마트 변환"을 포함하며, Tuner 개인 최적화 서비스와 통합되어 있습니다.

왜 중요한가요

• 기존 일본어 입력기는 규칙 기반 사전에 의존합니다. azooKey‑Desktop은 당신의 입력 기록, 사용자 사전, 프로필 프롬프트로부터 학습할 수 있는 현대적인 신경망(gguf 형식)으로 이를 대체하여 더 높은 정확도의 변환을 제공합니다.
• 모델 가중치는 Git LFS를 통해 리포지토리에 포함되어 있어, 무거운 AI 구성 요소가 별도 다운로드가 아니라 소스 트리의 일부로 포함됩니다.

주요 기능 (README에 기재된 내용)

• Zenzai 신경망 변환 – 고정밀 가나-한자 변환.
  • 프로필 프롬프트 지원.
  • 기록 학습 (사용 습관에 맞게 적응).
  • 사용자 사전.
  • 개인 최적화 시스템 Tuner와의 통합.
• LLM 지원 "편안한 느낌" 변환 – 선택적 대규모 언어 모델 단계로 더 자연스러운 표현을 제안할 수 있습니다.
• 실시간 변환 – 입력하면서 결과가 즉시 나타납니다.
• 네이티브 AZIK 지원 – AZIK 키보드 레이아웃과 호환됩니다.

받는 방법 (사용자용)

1. 릴리스 패키지 – Releases 페이지에서 .pkg를 다운로드하고 설치합니다.
2. macOS에서 로그아웃하고 다시 로그인합니다.
3. 시스템 설정 → 키보드 → 입력 소스를 열고 **+**를 클릭하여 일본어 → azooKey를 선택하고 확인합니다.
4. 메뉴바 아이콘에서 azooKey를 선택합니다.

대안: brew install azooKey (Homebrew). 설치 후에도 로그아웃/로그인과 입력 소스 추가가 필요합니다.

소스에서 빌드하기 (개발자용)

• 필수 조건
  • macOS 15+ (15에서 테스트 완료, 14/26에서도 작동하나 검증되지 않음)
  • Xcode 26.1+ (Apple Developer Program에 가입하지 않은 경우 개인 팀 서명 가능)
  • Git LFS (모델 파일을 다운로드하기 위해 필수)
  • SwiftLint (코드 스타일 검사)
• 서브모듈 및 LFS로 복제

  git lfs install
  git clone https://github.com/azooKey/azooKey-Desktop --recursive
  cd azooKey-Desktop
  # 이미 LFS/서브모듈 없이 클론한 경우:
  git submodule update --init
  git -C azooKeyMac/Resources/zenz-v3.1-small-gguf lfs pull
  git -C azooKeyMac/Resources/base_n5_lm lfs pull
  

• 서명 설정 – azooKeyMac.xcodeproj를 열고 Team을 개인 팀으로 변경하고, 번들 식별자(dev.ensan…)를 소유한 것으로 교체합니다.
• 빌드 및 설치

  ./install.sh   # .pkg 설치기와 동일한 결과 생성
  

  스크립트 완료 후 위의 로그아웃/입력 소스 단계를 다시 수행합니다.
• 문제 해결 – README에는 일반적인 서명 오류, Xcode 버전 문제, 모델 파일이 실제로 존재하는지 확인하는 방법(수십 메가바이트여야 하며, 134바이트의 LFS 포인터가 아니어야 함)이 기재되어 있습니다.

커뮤니티 및 확장

• 지원 및 기여용 디스코드 서버: https://discord.gg/dY9gHuyZN5
• 다른 플랫폼용 포크:
  • fcitx5‑hazkey – Linux 클라이언트.
  • azooKey‑Windows – Windows 클라이언트.
  • azoo‑key‑skkserv – SKK 서버 구현.

자금 지원

• GitHub Sponsors를 통해 기부를 받습니다.
• 일본의 IPA Mito‑IT 인재 육성 프로그램(2024)의 지원을 받고 있습니다.

결론 azooKey‑Desktop은 진정한 AI 강화 소프트웨어 프로젝트입니다: 일본어 입력을 위한 신경망 언어 모델을 포함하고, 선택적 LLM 기반 최적화를 제공하며, macOS 개발자가 기여하거나 사용자 맞춤화를 원할 경우 완전한 빌드 지침을 제공합니다.