개요

Sasarisa(사사리사) 는 macOS용 상시 대기 음성 비서다. 이전 이름은 Mac Butler이고 설정·기억·링크는 이어진다. 기본 호출어는 “사사리사”지만 설치 때 원하는 이름으로 바꿀 수 있다. 받아쓰기 앱 Handy가 음성을 글자로 바꾸는 데서 끝난다면, 이 앱은 호출어를 계속 듣다가 의도를 이해하고 키보드·마우스 커서 이동 없이 맥에서 직접 실행한다. 직접 못 하는 일은 화면을 읽고 명령을 돌리고 웹을 쓸 수 있는 Claude Code 같은 “두뇌”에 넘긴다.

2026-10-28 기준 스타 7개, 포크 6개, 언어 Swift, 최신 릴리스 v0.7.3(10-27)이다. 저장소는 2026-10-23에 만들어졌다. 라이선스는 AGPL-3.0이고 0.6.7까지는 MIT였다. 이름과 로고는 라이선스 밖이라 TRADEMARK.md가 따로 규정한다. 만든 곳은 한국 1인 AI 작업 채널 turtle buff ai(MV Co., Ltd.)다. 이 노트는 README 영문판만 읽고 정리했다.

할 수 있는 일

말하면동작
호출어(또는 오른쪽 ⌥ 탭)알림음 후 듣기 시작, 30초간은 호출어 없이 이어 말할 수 있다
오른쪽 ⌥ 누른 채 말하고 떼기Handy식 푸시투토크, 놓는 즉시 실행(약 1초)
앱 열기·검색·유튜브 재생(“두 번째 거 틀어줘”)·타이핑·타이머·볼륨빠른 명령 문법으로 1초 안팎에 처리하고 Claude를 부르지 않는다
”받아쓰기 시작” … “엔터” … “중지”Whisper 정확도의 연속 받아쓰기
(글 선택 후) “공손하게 바꿔줘”, “영어로 번역해줘”선택 영역만 고쳐 쓰고 전송은 누르지 않는다. ⌘Z로 되돌린다
”Claude Code에게 모든 프로젝트 점검하고 요약 보내라고 해줘”Claude 앱에 새 Claude Code 세션을 열고 이해하기 좋게 다듬은 작업을 입력
그 밖의 모든 말(“지금 화면에 뭐 있어?”)고른 두뇌가 처리해 음성으로 답한다(4~20초)

한국어에는 한 번에 여러 명령, 음성 루틴, 네이버 지도, 카카오톡 답장 같은 내장 단축이 더 있고, 영어는 이런 것이 두뇌로 넘어가 몇 초 느리다. 말하는 도중에 다음 명령을 하면 멈추고 새 명령을 받는다.

두 가지 학습 장치가 있다. 라이브 인식기가 자꾸 틀리는 단어(이름·제품명)는 몇 번 반복되면 어휘에 추가된다. 또 Claude가 해결한 동작(“영상 일시정지” → 스페이스)은 단계를 기억해 다음에는 Claude 없이 즉시 실행하고, 직후에 “아니”라고 하면 배우지 않는다.

동작 구조

마이크 → Apple 온디바이스 음성인식(호출어·실시간 자막) → whisper.cpp large-v3-turbo(로컬)
      → 빠른 명령 문법 → claude -p (상시 대기 Claude Code 프로세스, stream-json)
      → 맥 조작 + 음성 답변(macOS 내장 음성 또는 ElevenLabs)
  • 버튼·링크·입력창을 접근성 API 기반 jax(약 0.1초)로 이름을 찾아 직접 누른다.
  • Claude Code 프로세스를 켜 둬서 명령마다 2~4초 시작 비용을 내지 않는다.
  • Whisper 모델은 부를 때 올라가고 3분 유휴 후 내려간다(약 1GB).
  • 소스는 Ear·Whisper·Brain·Commands·Butler·Hands·HUD·Mouth 모듈과 Tools/(jax·butler·jclick·jtype)로 나뉜다.

두뇌와 목소리 교체

기본 두뇌는 Claude 구독으로 쓰는 claude-code(API 키 불필요)다. 설정에서 anthropic(기본 모델 claude-sonnet-5-5), openai·gemini·openrouter·groq, 로컬 ollama·lmstudio, OpenAI 호환 서버로 바꿀 수 있다. 본문에는 Codex(ChatGPT 구독, 셸·파일·브라우저 도구 끔)와 Aside(앱의 CLI)도 두뇌로 적혀 있다. 어느 두뇌든 손은 같은 도구 상자와 안전 검사를 쓰므로 셸이나 파일 접근권을 받지 않는다. 키는 config.json이 아니라 macOS 키체인에 둔다. 목소리는 say(무료 내장, 기본)·ElevenLabs·OpenAI·Azure·자체 HTTP 서버이고, 실패하면 내장 음성이 대신 읽는다. 이 점은 2026-08-23-github-milind-soni-openmausbot의 프로바이더 확장과 방향이 같다. 모델·서비스 쪽은 anthropic, codex, ollama를 참고한다.

안전·개인정보 설계

  • 맥에 남는 것: 마이크 오디오, 호출어 감지, Whisper 전사, 로그. 텔레메트리는 없다. 두뇌로 가는 명령 텍스트와 유료 음성을 고른 경우의 답변 문장만 밖으로 나간다.
  • 두뇌의 권한 제한: 터미널·코드 에디터·Claude 앱·시스템 설정·키체인·비밀번호 칸·권한 팝업에는 누르거나 입력하지 못한다.
  • 되돌릴 수 없는 일은 확인: 보내기·결제·게시·삭제 버튼, 메신저·웹 폼의 Enter는 “보낼까요?”에 “응”이라 해야 진행한다. 단축 경로는 단축키를 누른 채 직접 말한 경우뿐이다(TV 소리는 키를 누르지 못한다).
  • Claude 세션 인계도 음성 승인: TV나 웹페이지 소리가 내 컴퓨터에서 작업을 시작하지 못하게 한다. 끄는 “자유 모드”는 결제만 묻는다.
  • 함께 성장(선택): 켜면 하루 한 번 이름 없이 이해한 짧은 문장과 실행된 빠른 명령만 공유하고, 서로 다른 설치 5곳 이상·네트워크 3곳 이상에서 쓰인 문장만 모두에게 퍼진다. 공유 팩은 20시간마다 내려받으며 앱 이름·버전·macOS 버전만 센다.
  • 누른 것·입력한 것·연 것은 ~/.macbutler/logs/actions.log에 남고, 제어 소켓은 소유자 전용이다.

설치·요금

  • macOS 14+(Apple Silicon 권장, Mac mini M4에서 시험), 로그인된 Claude Code, Homebrew. ./scripts/install.sh 또는 brew install --cask mvcompany8500-web/tap/sasarisa(서명·공증)로 설치한다. 첫 실행 창이 권한을 실시간 점검하고 874MB Whisper 모델을 SHA-256 검증하며 내려받는다. 필요한 권한은 마이크·음성 인식·손쉬운 사용·화면 기록이다.
  • 설정은 ~/.macbutler/config.json에 있다(언어, 호출어, 단축키, customWords, brainProvider 등). 직접 빌드는 임시 서명이라 빌드마다 권한이 초기화되므로 SIGN_ID를 고정 인증서로 두라고 한다.
  • 전부 무료 오픈소스이고 “오늘 무료인 것은 유료로 바뀌지 않는다”고 못박았다. 곧 나올 Pro는 서버가 필요한 기능(폰에서 호출, 맥 간 동기화, 루틴 라이브러리)만 TurtleMaker 멤버십으로 묶는다.
  • 부가 기능으로 Higgsfield MCP 연동이 있다. 가격 조회(0크레딧) → 승인 후에만 생성, 재시도 금지, 작업당 50크레딧 상한을 AI가 아니라 앱의 가드가 강제한다.

한계

  • 블루투스 헤드셋은 듣는 동안 저음질 마이크 모드로 바뀐다. 스피커 환경에서는 끼어들 수 있으나 마이크에 가까이 말해야 한다.
  • Claude 인계는 Claude 데스크톱 앱 사이드바·입력창의 라벨에 의존해 UI 업데이트에 깨질 수 있다.
  • 빠른 명령은 한국어·영어만이고, 나머지 언어(일본어·중국어 등 10종)는 Claude를 거친다. 작은 로컬 모델은 한국어 도구 사용에 약하다고 스스로 적었다.
  • 로드맵에는 서명·공증 릴리스, 일본어·스페인어 문법, 자체 호출어 엔진, ~/.macbutler/commands/ 플러그인 명령이 남아 있다.

읽는 법

README 한 편의 자기 설명이며 실행은 검증하지 않았다. 속도(예: 1초 미만)와 안전 보장도 저자 주장이다. 저장소가 생긴 지 5일이고 스타가 7개라 아직 외부 검증은 거의 없다. 같은 “받아쓰기를 넘어서는 음성 입력” 계열은 2026-04-04-freeflow-voice-dictation, 2026-04-04-whispree-korean-stt-llm-voice-input, Apple 음성 API를 다룬 2026-04-04-apple-speech-api-whisper-alternative와 비교해 볼 만하다.

관련 노트