Skip to content

changsu-jin/meetnote

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

153 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MeetNote

Obsidian 플러그인으로 회의를 녹음하고, 자동으로 전사/화자구분/요약하여 마크다운 회의록을 생성합니다.

완전 로컬 처리 | 비용 0원 | 오프라인 동작 | GPU 가속 (CUDA / Apple Silicon)

핵심 기능

  • 실시간 전사 — Whisper (large-v3-turbo), 5초 청크 단위
  • 화자 구분 — pyannote-audio 3.1, GPU 자동 감지
  • 화자 매핑 — Speaker embedding DB로 누적 학습, 자동 이름 매칭
  • AI 요약 — Claude CLI / Ollama, 액션아이템 자동 생성
  • 이메일 전송 — SMTP로 참석자에게 회의록 전송
  • 암호화 — AES 녹음 파일 암호화, 자동 삭제, 감사 로그
  • 자동 태그/링크 — LLM 키워드 추출, vault 내 연관 회의 양방향 링크

사용 방식 — 두 가지 중 선택

단독 모드 (개인) 단체 모드 (SSO 인증)
대상 본인 1명. 데이터·모든 처리 로컬 팀/조직. 공용 서버 + 계정별 데이터 분리
서버 본인 맥북(venv) 또는 본인 Docker 조직 공용 Docker 서버
인증 없음 (또는 단순 API_KEY) SSO (OAuth 2.0) — PurpleAuth 등
계정 분리 없음 (전부 본인 것) user_id로 회의·녹음 자동 격리. SSO 토큰의 user_id가 신뢰 경계 — plugin이 다른 user_id 보내도 무시(TASK-014)
공유 본인이 이메일로 발송 본인이 이메일로 발송. 회신은 발신자 이메일로 (SMTP envelope sender ≠ 발신자여도 Reply-To 헤더로 처리, TASK-006)
셋업 키 (기본) SSO_CLIENT_ID 등 5개 env 설정
플러그인 UX 바로 사용 첫 사용 시 "로그인이 필요합니다" prompt → SSO 로그인

단일 binary/image. backend .envSSO_CLIENT_ID 유무로 모드가 결정됩니다. 자세히는 INSTALLATION.

빠른 시작

단독 모드 — macOS 로컬 (GPU 가속, 권장)

git clone https://github.com/changsu-jin/meetnote.git ~/meetnote
cd ~/meetnote/backend
bash install-local.sh
bash start-local.sh

단독 모드 — Docker (CPU 또는 CUDA)

curl -O https://raw.githubusercontent.com/changsu-jin/meetnote/main/backend/docker-compose.yml
docker compose up -d

단체 모드 — SSO 인증 (Docker)

# 위 docker-compose.yml + backend/.env에 SSO 변수 5개 채움
# SSO_AUTH_URL, SSO_SERVER_HOST, SSO_SERVER_PORT,
# SSO_CLIENT_ID, SSO_CLIENT_SECRET, SSO_REDIRECT_URI
docker compose up -d

자세한 셋업: INSTALLATION — 단체 모드 SSO 셋업

플러그인 설치 (공통)

Obsidian → BRAT 플러그인 → changsu-jin/meetnote 추가

문서

문서 내용
설치 가이드 macOS 로컬 / Docker / 플러그인 설치, 업그레이드
사용자 매뉴얼 녹음, 처리, 화자 관리, 이메일
운영 가이드 CLI 도구, 마이그레이션, 서버 통합
API 참조 WebSocket / HTTP 엔드포인트
아키텍처 시스템 구성, 데이터 흐름
문제 해결 FAQ, 에러 대응

플랫폼 지원

플랫폼 실행 방식 GPU 처리 속도 (60분 회의)
macOS (Apple Silicon) venv (권장) MPS/MLX ~5분
Linux + NVIDIA Docker CUDA ~5분
Windows + NVIDIA Docker CUDA (WSL2) ~5분
macOS (Intel) / Linux (CPU) Docker X ~40분 (CPU only)

GPU가 없는 환경에서는 화자구분이 CPU로 동작하여 처리 시간이 크게 늘어납니다.

개발 후기

라이선스

MIT

About

Obsidian plugin for local meeting transcription, speaker diarization, and AI summarization — fully offline, zero cost

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors