TL;DR

  • Scrbbl은 iPad와 Apple Pencil로 쓴 질문에 밑줄을 세 번 긋거나 원을 그리면 손글씨 답변을 표시하는 앱이며, 베타는 TestFlight에서 개인 OpenAI API 키를 사용해 이용 가능함.
  • 밑줄 세 번은 빠른 답변, 원 표시는 예시를 포함한 더 자세한 답변을 요청하며, 최신 정보가 필요한 질문에는 웹 검색을 사용함.
  • 손글씨 이미지가 OpenAI로 전송되고 답변은 단어 단위로 스트리밍되어 손글씨 글꼴로 표시됨.
  • 앱은 iPadOS 17 이상, Apple Pencil, Xcode 26 이상이 설치된 Mac, 크레딧이 있는 OpenAI API 키를 요구함.
  • API 키는 iPad의 Keychain에 저장되고 OpenAI 호출 외에는 기기를 벗어나지 않으며, 공개 App Store 배포에는 백엔드 경유가 권장됨.

작동 방식

  • 페이지 어디에나 질문이나 텍스트를 씀.
  • 밑줄을 세 번 그으면 빠른 AI 답변이 표시되며, 질문에 최신 정보가 필요하면 웹을 검색함.
  • 글에 원을 그리면 예시가 포함된 더 자세한 답변을 요청함.
  • 앱은 손글씨 이미지를 AI에 보내므로 알아보기 어려운 필체도 읽을 수 있음.
  • 답변은 단어 단위로 스트리밍되며 손글씨 글꼴로 표시됨.
  • 전체 1분 데모는 밑줄을 그은 뒤 원을 그려 더 긴 답변을 받는 흐름을 보여줌.

베타 이용

  • TestFlight에서 베타에 참여할 수 있으며, iPad와 개인 OpenAI API 키가 필요함.
  • 웹사이트: scrbbl.ai

요구 사항

  • iPadOS 17 이상을 실행하는 iPad와 Apple Pencil
  • Xcode 26 이상이 설치된 Mac
  • 크레딧이 있는 OpenAI API 키

실행 방법

  • Xcode에서 Scrbbl.xcodeproj를 엶.
  • Signing & Capabilities에서 본인의 팀을 선택하고, 필요하면 번들 식별자 ai.scrbbl.app을 소유한 식별자로 변경함.
  • iPad 또는 iPad 시뮬레이터를 선택하고 Run을 누름.
  • 앱의 Settings를 열어 OpenAI API 키를 붙여 넣고 Save API key를 누름.
  • 시뮬레이터에는 Apple Pencil이 없으므로 캔버스에서 마우스와 트랙패드 입력도 지원함. 실제 iPad에서는 Pencil 입력만 받으므로 손가락으로 화면을 스크롤할 수 있음.
  • 시뮬레이터 테스트에서는 scripts/launch-with-key.command를 사용해 키를 앱에 직접 입력하지 않고 Debug 빌드에 전달할 수 있음.

설정

  • Fast(기본값): 추론 기능을 끈 GPT-6 Luna와 OpenAI의 빠른 처리 계층을 사용함.
  • Smart: 가벼운 추론을 사용하는 GPT-6.1 Sol로, 더 느리지만 깊이 있는 답변을 제공함.
  • 두 설정 모두 시의성이 필요한 질문에 웹 검색을 사용할 수 있음.

프로젝트 구성

  • Scrbbl/TripleUnderlineDetector.swift: 밑줄 세 번 긋기와 원 그리기 동작을 인식하고, 해당 표시가 가리키는 손글씨를 찾음.
  • Scrbbl/NoteCanvasModel.swift: 손글씨를 렌더링하고 스트리밍 방식으로 OpenAI Responses API를 호출하며, 키를 Keychain에 저장함.
  • Scrbbl/NoteCanvasView.swift: PencilKit 캔버스와 손글씨 답변 상자를 구성함.
  • Scrbbl/SettingsView.swift: API 키, 답변 속도, 동작 안내를 제공함.
  • Scrbbl/Fonts: 답변에 사용하는 손글씨 글꼴 Nothing You Could Do가 포함되어 있으며, SIL Open Font License를 따름.
  • design/make_icon.py: 앱 아이콘을 생성함.
  • design/make_social_preview.py: 소셜 미리보기 카드 docs/social-preview.png를 생성함.

개인정보 보호 및 보안

  • API 키는 iPad의 Keychain에 저장되며 OpenAI를 호출하는 경우를 제외하고 기기 밖으로 나가지 않음.
  • 밑줄을 긋거나 원을 그린 손글씨 이미지는 답변 생성을 위해 OpenAI로 전송됨.
  • 앱은 iPad에서 OpenAI를 직접 호출하며 개인 용도로는 괜찮지만, 앱에 포함된 키를 추출할 수 있으므로 공개 App Store 배포에서는 백엔드를 통해 요청을 전달해야 함.

기여

  • 이슈와 풀 리퀘스트를 환영하며, 시작하려면 CONTRIBUTING.md를 확인하고 good first issue 라벨이 붙은 이슈를 살펴보면 됨.

라이선스

  • 프로젝트는 MIT 라이선스를 따르며 자세한 내용은 LICENSE에 있음.
  • 포함된 글꼴은 별도로 SIL Open Font License를 따르며 파일은 Scrbbl/Fonts/OFL.txt임.
  • Adam Probolsky가 공개한 오픈소스 프로젝트임.