joewongjc/type4me

Type4Me – macOS 음성 입력 및 AI 기반 텍스트 어시스턴트

개요

• 오픈 소스 macOS 애플리케이션(macOS 14+ / Sonoma)으로, 커서 위치 어디에나 직접 텍스트를 받아쓸 수 있습니다. 음성-텍스트 변환과 함께 다듬기, 번역, 질문 답변, Mac 제어 등의 선택적 AI 처리를 결합합니다.

작동 방식

• 전역 단축키를 누르고 말하면 음성이 실시간으로 표시됩니다. 그대로의 전사 텍스트는 선택한 대규모 언어 모델(OpenAI, Claude, Gemini, Ollama 등) 또는 로컬 실행 모델에 전달하여 추가 처리할 수 있습니다.
• 앱은 두 가지 배포 모드를 지원합니다.
  1. 클라우드 모드 – 외부 음성 인식 서비스(예: Volcano Engine/豆包, Soniox, OpenAI)를 사용하고 텍스트를 원격 LLM으로 보냅니다.
  2. 로컬 모드 – Apple 실리콘 머신(약 8GB RAM)에서 SenseVoice + Qwen3-ASR 오프라인 인식기를 실행하고 Ollama를 통해 로컬 LLM을 호출할 수도 있습니다.
• 모든 설정(API 키, 선택한 인식기, 선택한 LLM, 프롬프트, 단축키)은 머신에 저장되고, 매일 백업되며, 내보낼 수 있습니다.

주요 기능

기능	설명
여러 모드	빠른(원시 전사만), 스마트(자동 정리 및 문맥 인식 구문), 번역(18개 언어), 질문(선택한 텍스트에 대한 음성 기반 Q&A), Mac 제어(예: "Safari 열기", "볼륨 30으로 설정"), 다듬기, 프롬프트 생성, 할 일 만들기.
사용자 정의 프롬프트	각 모드는 사용자가 편집할 수 있는 프롬프트 템플릿을 실행합니다. 자리 표시자 {text}, {selected}, {clipboard}를 사용하여 임의의 워크플로우를 조합할 수 있습니다.
단축키 기반	모든 모드를 전역 단축키에 바인딩하고 "누르는 동안 말하기" 또는 "켜기/끄기 토글"을 선택할 수 있습니다.
어휘 / 스킬 시스템	선택적 type4me-vocab-skill을 설치하여 사용자 정의 용어와 자동 대체를 추가하고 도메인별 정확도를 높일 수 있습니다.
기록 및 사용량 대시보드	원시 및 처리된 결과를 저장하고, 검색 가능하며, CSV로 내보낼 수 있습니다. 모델별 토큰 사용량, 예상 비용, 지연 시간을 표시합니다.
메뉴 바 제어 센터	녹음 상태의 빠른 보기, 인식기, LLM, 언어 등 전환.
URL 체계	type4me://… 명령으로 Stream Deck, Shortcuts, Raycast, Alfred 또는 스크립트에서 포커스를 빼앗지 않고 작업을 트리거할 수 있습니다.
로컬 백업	설정, 어휘, 모드 정의, 기록의 자동 7일 순환.
오픈 소스 및 MIT 라이선스	전체 소스 제공. 빌드는 Apple 공증됨.

시작하기

1. 적절한 DMG(클라우드 권장 또는 Apple 실리콘 로컬)를 다운로드합니다. 설치하고 마이크 및 접근성 권한을 부여합니다.
2. 음성 인식 제공자와 LLM의 API 키를 추가합니다(로컬 모델의 경우 Ollama 설치).
3. 모드를 선택하거나 설정에서 프롬프트 템플릿을 편집하여 직접 만듭니다.
4. 설정한 단축키를 누르고 말하면 텍스트가 나타납니다. 메뉴 바 또는 URL 체계를 사용하여 추가 작업을 호출합니다.

확장성

• 플러그인 어휘 스킬 – 별도 저장소(type4me-vocab-skill)로, 음성 명령으로 사용자 정의 용어를 학습할 수 있습니다.
• 모델 비종속 – OpenAI 호환 API를 제공하는 모든 서비스로 교체할 수 있습니다. 중국 제공자(豆包, DeepSeek, Kimi 등) 또는 로컬 Ollama 인스턴스도 포함됩니다.
• 자동화 – URL 체계 명령을 통해 기존 macOS 자동화 도구와 통합할 수 있습니다.

존재 이유 저자는 기존 음성 입력 도구가 비싸거나, 폐쇄 소스이거나, 유연성이 부족하다고(내보내기 없음, 사용자 정의 프롬프트 없음, 높은 지연 시간) 느꼈습니다. Type4Me는 AI 기반 텍스트 처리를 제공하면서 무료이고 투명하며 적응 가능한 것을 목표로 합니다.

기여 이슈와 풀 리퀘스트를 환영합니다. 코드베이스는 주로 Claude Code로 생성되었으며, 기여자는 CONTRIBUTING.md 가이드를 따르는 것이 좋습니다.

라이선스 MIT 라이선스.

---

위 정보는 모두 저장소의 README에서 직접 가져온 것입니다.