Kit — 개인용 맥 도구 모음

맥 메뉴바에 사는 작은 도구 모음 앱입니다. 캡처·녹화·녹음·글자변환·통역·번역을 한 곳에서 해결합니다. AI 기능(음성인식·번역)은 인터넷·API 키 없이 컴퓨터 안에서 동작해요.

⚠️ macOS 전용 (Apple Silicon·Intel 모두 설치 가능). 현재 Windows·Linux는 지원하지 않습니다. → 지원 환경

📖 사용자 매뉴얼 보기 — 설치부터 기능별 사용법, 문제 해결까지

기능

폴더 구조

kit/
├─ app.py              # 메뉴바 앱 본체
├─ palette.py          # 플로팅 팔레트 윈도우 (PySide6)
├─ editor.py           # 캡처 편집창 (PySide6)
├─ live_interpret.py   # 실시간 통역 창 (PySide6)
├─ features/           # 기능별 모듈
│   ├─ capture.py      # 캡처
│   ├─ cleanup.py      # 바탕화면 청소
│   ├─ record.py       # 화면 녹화
│   ├─ audio.py        # 음성 녹음
│   ├─ denoise.py      # 잡음 제거 (RNNoise)
│   ├─ transcribe.py   # 음성 → 글자 (Whisper)
│   ├─ translate.py    # 번역 (Argos, 오프라인)
│   ├─ config.py       # 설정 저장 (저장 폴더 등)
│   └─ autostart.py    # 로그인 시 자동 시작
├─ assets/             # 메뉴바 아이콘, 토끼 애니메이션
├─ docs/               # 사용자 매뉴얼 (GitHub Pages)
├─ bin/ffmpeg          # 녹음 변환/잡음제거용 (download_assets.sh 로 받음)
├─ models/             # AI 모델·잡음제거 모델 (download_assets.sh 로 받음)
├─ scripts/
│   └─ download_assets.sh
├─ requirements.txt
└─ 실행.command        # 더블클릭으로 앱 켜기

설치 & 실행 — 더블클릭 한 번이면 끝

1. 이 페이지 위쪽 Code → Download ZIP 을 눌러 내려받고, 압축을 풉니다.
2. 풀린 폴더 안의 실행.command 를 더블클릭합니다.
   • 처음 열 때 "확인되지 않은 개발자" 경고가 뜨면: 파일을 우클릭(또는 Ctrl+클릭) → 열기 → 열기. (macOS 15 이상은 시스템 설정 → 개인정보 보호 및 보안 맨 아래 → 그대로 열기)
3. 처음 한 번은 파이썬 환경과 AI 모델(약 1GB)을 자동으로 설치합니다 — 인터넷 속도에 따라 몇 분에서 수십 분 걸려요. 끝나면 메뉴바(화면 맨 위)에 Kit 아이콘이 나타납니다.

다음부터는 더블클릭하면 바로 켜집니다. 끄려면: 메뉴 → 종료.

터미널로 설치하고 싶다면 (개발자용)

git clone https://github.com/commme/kit.git
cd kit
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
bash scripts/download_assets.sh      # ffmpeg + AI 모델 다운로드
./실행.command

권한 (한 번만)

• 캡처/화면 녹화: 캡처나 녹화를 한 번 시도한 뒤 → 시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 기록 목록에 나타난 항목(터미널 또는 Python)을 켜고, 앱을 재시작하세요.
• 녹음/통역: 첫 사용 시 마이크 권한 허용

지원 환경

• ✅ macOS 11(빅서) 이상 — Apple Silicon·Intel 모두.
  • Ap