722커밋, 40일째 매일 고치고 있는 실제 회의록 AI ‘aura’를 만든 사람이, 그 핵심을 완전 오프라인 미니 버전으로 축소해 만드는 과정입니다. 실사용 테스트에서 나온 진짜 버그 4개를 전부 실었습니다.

회의 녹음, 요약까지는 만들었는데 실제로 써보니 이상하다

실시간 전사 + 요약 앱을 만드는 건 튜토리얼만 보면 쉬워 보입니다. 마이크 잡고, Whisper에 넣고, LLM으로 요약하면 끝 아닌가? 로컬에서 짧게 테스트할 땐 잘 됩니다. 실제로 몇 분 말해보면 다릅니다. 유닛 테스트도 전부 통과합니다. 마이크 앞에서 말을 걸어봐야 버그가 나옵니다. 문제는 실력이 아니라 실제 마이크로 끝까지 돌려본 경험의 부재입니다.

흔한 오해: Whisper 옵션을 안 주면 알아서 감지하겠지

틀렸습니다. WhisperKit은 언어를 안 정해주면 자동 감지가 아니라 그냥 영어로 디코딩을 시작합니다. 이 책 3장이 이 버그를 실제 소스 코드 줄 단위로 추적하는 과정입니다.

이 책의 가장 큰 강점, 똑같이 만들 수 있게 프롬프트를 드립니다

각 장에는 이렇게 시켜보세요 박스가 있습니다. AI 코딩 도구(Claude Code 등)에게 그대로 붙여넣을 수 있는 프롬프트 예제입니다. 코드를 몰라도 바이브 코딩으로 이 앱을 똑같이 만들 수 있습니다.

어떤 막힘들이었나

마이크 샘플레이트가 44.1kHz일 때만 조용히 오디오가 중복되고 왜곡되던 버그, 세 줄짜리 해법이었습니다.

전사 속도가 느려지면 자막이 뒤섞이고 마지막 문장이 통째로 요약에서 빠지던 레이스 컨디션이었습니다.

한국어로 말했는데 영어로 엉뚱하게 전사되던 사건, 자동 감지가 사실은 자동 감지가 아니었던 이유입니다.

app으로 패키징하는 순간 코드사인이 깨지던 함정이었습니다.

실측

aura 원본은 커밋 722건, 커밋한 날 40일, 수정 되돌리기 커밋 207건으로 29퍼센트입니다.

AuraMini는 이 책의 데모로 커밋 28건, 그중 10건인 36퍼센트가 실제 리뷰와 실사용 테스트에서 나온 수정 커밋입니다.

자동 테스트 29개, 전부 그린입니다.

필수 비용은 0원입니다.

소스도 먼저 확인하세요

이 책에서 만드는 AuraMini의 소스 전문이 GitHub에 공개되어 있습니다. MIT 라이선스, 빌드와 테스트 29개 통과를 확인하고 올렸습니다. github.com/illuwa/auraMini-pub

먼저 데모를 돌려보세요

받아서 바로 실행됩니다. 환경 설치가 필요 없습니다. Ollama는 앱이 자동으로 띄웁니다. 돌려보시고 어떻게 만들었지 싶으시면 아래를 보시면 됩니다.

목차

1장, 마이크에서 뭘 어떻게 잘라서 넘겨야 Whisper가 알아듣나

2장, 청크가 도착한 순서대로 자막에 붙는가

3장, 자동 감지가 사실은 자동 감지가 아니었던 문제

4장, 코드사인과 SPM 리소스 번들이 서로 못 잡아먹는 문제

5장, AI에게 시키기만 하면 안 되는 이유, 검증 사이클

마지막 장, 적용 플랜

부록, 즉시 작동하는 실습 코드 전문

A4 분량 21페이지, 도형 2점과 프롬프트 예제 박스 6개, 실습 코드 동봉입니다.

솔직히 말씀드립니다, 이 책에 없는 것

로그인, 여러 기기 동기화가 없습니다. 화자 분리, 번역이 없습니다. WhisperKit과 Ollama 자체의 설치법이 아닙니다. aura 본체 소스 공개가 아닙니다.

이런 분께

macOS 앱에서 실시간 오디오 캡처, STT, 로컬 LLM 연동을 직접 짜보고 싶은 분. AVFoundation과 WhisperKit을 다루다 원인 불명 버그를 겪어본 분. 코드를 잘 몰라도 AI와 함께 오프라인 AI 앱을 만들어 보고 싶은 분. 실제로 운영 중인 제품에서 나온 진짜 버그가 궁금한 분.

이런 분께는 권하지 않습니다

프로그래밍 자체가 처음이라 기초 개념부터 필요하신 분. 클라우드 STT LLM API 연동을 찾으시는 분.

가격

0원, 전체 무료입니다. 독자를 먼저 모으는 게 목적이라, 이후 권부터 유료 전환 여부를 반응 보고 결정합니다.