为什么值得关注

它的亮点在于无需互联网或 API 密钥即可在本地完成语音识别和翻译，保障隐私，同时只需双击即可完成安装，对非技术用户非常友好。

适合谁使用

使用 macOS 并希望集成多种效率工具的用户
注重隐私、要求所有处理在本机完成的用户
需要快速截图、录音、翻译但不想学习复杂设置的用户
经常在 Mac 上进行内容捕捉、录制或翻译的用户

典型使用场景

快速截取屏幕区域并进行标注和编辑
录制屏幕或音频，离线将语音转为文字
进行近似实时的口译（韩/英/日/中）或文本翻译
自动按类型整理桌面文件

项目优势

所有 AI 功能完全离线运行，确保数据永不离开设备
一键双击安装，自动配置 Python 环境并下载所需模型（约 1 GB）
将截图、录屏、录音、转录、翻译、桌面整理等多种工具整合在菜单栏中
同时支持 Apple Silicon 和 Intel Mac，自动下载对应架构的组件

使用前须知

仅支持 macOS，无法在 Windows 或 Linux 上使用，依赖 macOS 特有技术
Intel Mac 的兼容性未完全验证；极老的 Intel 机型可能缺少 AI 引擎所需的 AVX 指令集
实时口译有轻微延迟（接近实时但非完全同步），翻译质量因语言对而异（韩↔英良好，韩↔日一般，韩↔中中等）

README 快速开始

Kit — 개인용 맥 도구 모음

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

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

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

기능

카테고리	기능
🎪 플로팅 팔레트	항상 위에 떠있는 메뉴 팔레트, 귀여운 3D 토끼 아이콘
📸 캡처	영역/전체/창 캡처, 캡처 후 편집(자르기·모자이크·화살표·박스·펜·글자), 폴더 열기
🎬 녹화·녹음	화면 녹화(화면+마이크), 음성 녹음, 녹음 → 글자(텍스트) 변환
🗣️ 통역·번역	통역(말→번역), 실시간 통역 창, 글 번역(한·영·일·중)
🌐 웹 도구	자주 쓰는 웹 도구 바로가기
🧹 청소	바탕화면 파일 종류별 자동 정리
⚙️ 설정	로그인 시 자동 시작, 저장 폴더 변경

폴더 구조

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        # 더블클릭으로 앱 켜기

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

이 페이지 위쪽 Code → Download ZIP 을 눌러 내려받고, 압축을 풉니다.
풀린 폴더 안의 실행.command 를 더블클릭합니다.
- 처음 열 때 "확인되지 않은 개발자" 경고가 뜨면: 파일을 우클릭(또는 Ctrl+클릭) → 열기 → 열기. (macOS 15 이상은 시스템 설정 → 개인정보 보호 및 보안 맨 아래 → 그대로 열기)
처음 한 번은 파이썬 환경과 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

项目描述

맥 메뉴바 비서 앱 Kit — 캡처·녹화·녹음·통역·번역을 오프라인으로

kit