sonote 1.1.0b1__tar.gz

sonote-1.1.0b1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tellang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sonote-1.1.0b1/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: sonote
+Version: 1.1.0b1
+Summary: AI 에이전트를 위한 소리 노트 — 실시간 한국어 음성 전사 CLI
+Author: tellang
+License: MIT
+Project-URL: Homepage, https://github.com/tellang/sonote
+Project-URL: Repository, https://github.com/tellang/sonote
+Project-URL: Issues, https://github.com/tellang/sonote/issues
+Keywords: sonote,whisper,stt,korean,transcription,faster-whisper,meeting,live-stream,ai-agent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: faster-whisper>=1.2.0
+Requires-Dist: yt-dlp>=2024.0.0
+Requires-Dist: nvidia-cublas-cu12>=12.0.0
+Requires-Dist: nvidia-cudnn-cu12>=9.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: sounddevice>=0.4.6
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: uvicorn>=0.27.0
+Requires-Dist: watchdog>=4.0.0
+Requires-Dist: python-multipart>=0.0.9
+Provides-Extra: diarize
+Requires-Dist: pyannote-audio>=3.1; extra == "diarize"
+Requires-Dist: torch>=2.0.0; extra == "diarize"
+Provides-Extra: docx
+Requires-Dist: python-docx>=1.0.0; extra == "docx"
+Provides-Extra: pdf
+Requires-Dist: fpdf2>=2.8; extra == "pdf"
+Dynamic: license-file
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tellang/sonote/main/static/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/tellang/sonote/main/static/logo-light.svg">
+    <img alt="sonote" src="https://raw.githubusercontent.com/tellang/sonote/main/static/logo.svg" width="240">
+  </picture>
+</p>
+
+<h1 align="center">sonote</h1>
+
+<p align="center">
+  <strong>Beyond Transcription, Toward Meeting Intelligence.</strong><br>
+  Real-time Korean STT engine built for AI agents and professional meetings.
+</p>
+
+<p align="center">
+  <a href="https://github.com/tellang/sonote/actions"><img src="https://img.shields.io/github/actions/workflow/status/tellang/sonote/ci.yml?style=flat-square" alt="CI"></a>
+  <a href="https://github.com/tellang/sonote/stargazers"><img src="https://img.shields.io/github/stars/tellang/sonote?style=flat-square&color=black" alt="Stars"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-mit-yellow?style=flat-square" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="docs/GUIDE.md">Documentation</a> ·
+  <a href="docs/GUIDE.md#getting-started">Getting Started</a> ·
+  <a href="docs/SPEAKER_DIARIZATION_RESEARCH.md">Research</a> ·
+  <a href="https://github.com/tellang/sonote/issues">Issues</a>
+</p>
+
+---
+
+## Demo
+
+<p align="center">
+  <img src="static/demo.gif" alt="sonote real-time transcription demo" width="700">
+</p>
+
+## Installation
+
+```bash
+git clone https://github.com/tellang/sonote && cd sonote
+uv sync
+```
+
+> [!NOTE]
+> ffmpeg 필수: `choco install ffmpeg` (Windows) / `brew install ffmpeg` (macOS)
+> 화자 분리: `pip install -e ".[diarize]"` + `HF_TOKEN` 환경변수
+
+## Quick Start
+
+```bash
+# 회의 실시간 전사 (Viewer: http://localhost:8000)
+sonote meeting
+
+# YouTube 라이브 올인원 (스캔 → 병렬 다운 → 변환 → 병합)
+sonote auto <VIDEO_URL>
+
+# 로컬 오디오 변환
+sonote transcribe audio.wav
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `sonote meeting` | 마이크 → 화자 분리 → SSE 자막 + 파일 저장 |
+| `sonote auto <URL>` | YouTube 올인원 (BGM 자동 분류, 병렬 다운로드, 변환, 병합) |
+| `sonote live <URL>` | YouTube 연속 실시간 변환 |
+| `sonote transcribe <FILE>` | 로컬 오디오/영상 변환 |
+| `sonote detect <URL>` | BGM↔음성 경계 탐색 |
+| `sonote download <URL>` | YouTube 오디오 다운로드 |
+
+<details>
+<summary>주요 옵션</summary>
+
+```bash
+# 긴 파일 청크 분할
+sonote transcribe long.wav --chunk-minutes 10
+
+# SRT 자막 출력
+sonote transcribe audio.wav --fmt srt
+
+# 기존 스크립트에 이어붙이기
+sonote auto "URL" --resume transcript.txt
+
+# 마이크 장치 선택
+sonote meeting --list-devices
+sonote meeting --device 1
+
+# 화자 분리 비활성화
+sonote meeting --no-diarize
+```
+
+</details>
+
+## Key Features
+
+- **Zero-Latency Tracking** — 마이크 입력과 YouTube 라이브를 최소 지연으로 실시간 추적
+- **Intelligent Diarization** — 미등록 화자 임베딩 추적, 5개+ 세그먼트 누적 시 자동 등록 후보 마킹
+- **Professional Viewer** — 단일 HTML 웹 인터페이스, 다크/라이트 모드, 실시간 검색
+- **AI-Driven Refinement** — LLM 연동 회의 요약 및 스크립트 교정 (Codex STT + Gemini 요약)
+- **Real-time API** — SSE + WebSocket 양방향 통신, 자동 재연결, 세션별 검색 API
+
+## Performance
+
+| Model | RTF (Speed) | CER (Accuracy) | VRAM |
+| :--- | :--- | :--- | :--- |
+| **large-v3-turbo** (default) | **< 0.05** | ~16.4% | ~3.5 GB |
+| large-v3 | ~0.12 | **~11.2%** | ~6.0 GB |
+| small | < 0.02 | ~22.8% | ~1.5 GB |
+
+> [!TIP]
+> NVIDIA RTX 4070+ 환경에서 CUDA float16 최적화. RTF 0.05 미만으로 실시간 이상 속도.
+
+<details>
+<summary>API & WebSocket</summary>
+
+### Search API
+
+```bash
+# 키워드 검색
+curl "http://127.0.0.1:8000/api/sessions/{session_id}/search?query=회의"
+
+# 화자 + 시간 범위 필터
+curl "...?query=결정&speaker=김팀장&time_start=300&time_end=1200"
+
+# 정규식 검색
+curl "...?query=일정|마감&regex=true"
+```
+
+### WebSocket
+
+`WS /ws/transcribe` — 전사/교정/세션 이벤트 양방향 통신. SSE 폴백, 30초 하트비트, 자동 재연결.
+
+### Speaker Auto-Registration
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/speakers/unknown` | GET | 미등록 화자 목록 |
+| `/api/speakers/auto-register` | POST | 미등록 화자 프로필 등록 |
+| `/api/speakers/unknown/{id}` | DELETE | 미등록 화자 무시 |
+
+</details>
+
+<details>
+<summary>Build & Benchmark</summary>
+
+```bash
+# Windows EXE 패키징
+uv run python scripts/build.py --onefile
+
+# 모델 벤치마크
+uv run python scripts/benchmark_models.py --models small large-v3-turbo
+```
+
+</details>
+
+## Project Structure
+
+```text
+src/
+├── cli.py            # CLI 진입점
+├── server.py         # FastAPI SSE + WebSocket
+├── transcribe.py     # Faster-Whisper 추론 코어
+├── diarize.py        # 화자 분리 (pyannote-audio)
+├── download.py       # YouTube 오디오 다운로드
+├── continuous.py     # 연속 실시간 변환
+├── polish.py         # LLM 후처리
+└── whisper_worker.py # CUDA 격리 STT 워커
+static/
+└── viewer.html       # 자막 뷰어 (단일 HTML)
+```
+
+## Documentation
+
+Full command references, architecture, and troubleshooting: **[User Guide](docs/GUIDE.md)**
+
+---
+
+<div align="right">
+
+**Copyright (c) 2025 Tellang**
+Licensed under the [MIT License](LICENSE).
+
+</div>

sonote-1.1.0b1/README.md

@@ -0,0 +1,184 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tellang/sonote/main/static/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/tellang/sonote/main/static/logo-light.svg">
+    <img alt="sonote" src="https://raw.githubusercontent.com/tellang/sonote/main/static/logo.svg" width="240">
+  </picture>
+</p>
+
+<h1 align="center">sonote</h1>
+
+<p align="center">
+  <strong>Beyond Transcription, Toward Meeting Intelligence.</strong><br>
+  Real-time Korean STT engine built for AI agents and professional meetings.
+</p>
+
+<p align="center">
+  <a href="https://github.com/tellang/sonote/actions"><img src="https://img.shields.io/github/actions/workflow/status/tellang/sonote/ci.yml?style=flat-square" alt="CI"></a>
+  <a href="https://github.com/tellang/sonote/stargazers"><img src="https://img.shields.io/github/stars/tellang/sonote?style=flat-square&color=black" alt="Stars"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-mit-yellow?style=flat-square" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="docs/GUIDE.md">Documentation</a> ·
+  <a href="docs/GUIDE.md#getting-started">Getting Started</a> ·
+  <a href="docs/SPEAKER_DIARIZATION_RESEARCH.md">Research</a> ·
+  <a href="https://github.com/tellang/sonote/issues">Issues</a>
+</p>
+
+---
+
+## Demo
+
+<p align="center">
+  <img src="static/demo.gif" alt="sonote real-time transcription demo" width="700">
+</p>
+
+## Installation
+
+```bash
+git clone https://github.com/tellang/sonote && cd sonote
+uv sync
+```
+
+> [!NOTE]
+> ffmpeg 필수: `choco install ffmpeg` (Windows) / `brew install ffmpeg` (macOS)
+> 화자 분리: `pip install -e ".[diarize]"` + `HF_TOKEN` 환경변수
+
+## Quick Start
+
+```bash
+# 회의 실시간 전사 (Viewer: http://localhost:8000)
+sonote meeting
+
+# YouTube 라이브 올인원 (스캔 → 병렬 다운 → 변환 → 병합)
+sonote auto <VIDEO_URL>
+
+# 로컬 오디오 변환
+sonote transcribe audio.wav
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `sonote meeting` | 마이크 → 화자 분리 → SSE 자막 + 파일 저장 |
+| `sonote auto <URL>` | YouTube 올인원 (BGM 자동 분류, 병렬 다운로드, 변환, 병합) |
+| `sonote live <URL>` | YouTube 연속 실시간 변환 |
+| `sonote transcribe <FILE>` | 로컬 오디오/영상 변환 |
+| `sonote detect <URL>` | BGM↔음성 경계 탐색 |
+| `sonote download <URL>` | YouTube 오디오 다운로드 |
+
+<details>
+<summary>주요 옵션</summary>
+
+```bash
+# 긴 파일 청크 분할
+sonote transcribe long.wav --chunk-minutes 10
+
+# SRT 자막 출력
+sonote transcribe audio.wav --fmt srt
+
+# 기존 스크립트에 이어붙이기
+sonote auto "URL" --resume transcript.txt
+
+# 마이크 장치 선택
+sonote meeting --list-devices
+sonote meeting --device 1
+
+# 화자 분리 비활성화
+sonote meeting --no-diarize
+```
+
+</details>
+
+## Key Features
+
+- **Zero-Latency Tracking** — 마이크 입력과 YouTube 라이브를 최소 지연으로 실시간 추적
+- **Intelligent Diarization** — 미등록 화자 임베딩 추적, 5개+ 세그먼트 누적 시 자동 등록 후보 마킹
+- **Professional Viewer** — 단일 HTML 웹 인터페이스, 다크/라이트 모드, 실시간 검색
+- **AI-Driven Refinement** — LLM 연동 회의 요약 및 스크립트 교정 (Codex STT + Gemini 요약)
+- **Real-time API** — SSE + WebSocket 양방향 통신, 자동 재연결, 세션별 검색 API
+
+## Performance
+
+| Model | RTF (Speed) | CER (Accuracy) | VRAM |
+| :--- | :--- | :--- | :--- |
+| **large-v3-turbo** (default) | **< 0.05** | ~16.4% | ~3.5 GB |
+| large-v3 | ~0.12 | **~11.2%** | ~6.0 GB |
+| small | < 0.02 | ~22.8% | ~1.5 GB |
+
+> [!TIP]
+> NVIDIA RTX 4070+ 환경에서 CUDA float16 최적화. RTF 0.05 미만으로 실시간 이상 속도.
+
+<details>
+<summary>API & WebSocket</summary>
+
+### Search API
+
+```bash
+# 키워드 검색
+curl "http://127.0.0.1:8000/api/sessions/{session_id}/search?query=회의"
+
+# 화자 + 시간 범위 필터
+curl "...?query=결정&speaker=김팀장&time_start=300&time_end=1200"
+
+# 정규식 검색
+curl "...?query=일정|마감&regex=true"
+```
+
+### WebSocket
+
+`WS /ws/transcribe` — 전사/교정/세션 이벤트 양방향 통신. SSE 폴백, 30초 하트비트, 자동 재연결.
+
+### Speaker Auto-Registration
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/speakers/unknown` | GET | 미등록 화자 목록 |
+| `/api/speakers/auto-register` | POST | 미등록 화자 프로필 등록 |
+| `/api/speakers/unknown/{id}` | DELETE | 미등록 화자 무시 |
+
+</details>
+
+<details>
+<summary>Build & Benchmark</summary>
+
+```bash
+# Windows EXE 패키징
+uv run python scripts/build.py --onefile
+
+# 모델 벤치마크
+uv run python scripts/benchmark_models.py --models small large-v3-turbo
+```
+
+</details>
+
+## Project Structure
+
+```text
+src/
+├── cli.py            # CLI 진입점
+├── server.py         # FastAPI SSE + WebSocket
+├── transcribe.py     # Faster-Whisper 추론 코어
+├── diarize.py        # 화자 분리 (pyannote-audio)
+├── download.py       # YouTube 오디오 다운로드
+├── continuous.py     # 연속 실시간 변환
+├── polish.py         # LLM 후처리
+└── whisper_worker.py # CUDA 격리 STT 워커
+static/
+└── viewer.html       # 자막 뷰어 (단일 HTML)
+```
+
+## Documentation
+
+Full command references, architecture, and troubleshooting: **[User Guide](docs/GUIDE.md)**
+
+---
+
+<div align="right">
+
+**Copyright (c) 2025 Tellang**
+Licensed under the [MIT License](LICENSE).
+
+</div>

sonote-1.1.0b1/pyproject.toml

@@ -0,0 +1,65 @@
+[project]
+name = "sonote"
+version = "1.1.0b1"
+description = "AI 에이전트를 위한 소리 노트 — 실시간 한국어 음성 전사 CLI"
+requires-python = ">=3.11"
+authors = [{ name = "tellang" }]
+license = { text = "MIT" }
+readme = "README.md"
+keywords = ["sonote", "whisper", "stt", "korean", "transcription", "faster-whisper", "meeting", "live-stream", "ai-agent"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+]
+dependencies = [
+    "faster-whisper>=1.2.0",
+    "yt-dlp>=2024.0.0",
+    "nvidia-cublas-cu12>=12.0.0",
+    "nvidia-cudnn-cu12>=9.0.0",
+    "httpx>=0.27.0",
+    "sounddevice>=0.4.6",
+    "numpy>=1.26.0",
+    "fastapi>=0.110.0",
+    "uvicorn>=0.27.0",
+    "watchdog>=4.0.0",
+    "python-multipart>=0.0.9",
+]
+
+[project.optional-dependencies]
+diarize = ["pyannote-audio>=3.1", "torch>=2.0.0"]
+docx = ["python-docx>=1.0.0"]
+pdf = [
+    "fpdf2>=2.8",
+]
+
+[project.scripts]
+sonote = "src.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/tellang/sonote"
+Repository = "https://github.com/tellang/sonote"
+Issues = "https://github.com/tellang/sonote/issues"
+
+[build-system]
+requires = ["setuptools>=75.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["src*"]
+
+[tool.setuptools.package-data]
+src = ["../static/*"]
+
+[tool.mypy]
+python_version = "3.11"
+ignore_missing_imports = true
+warn_unused_ignores = true
+
+[tool.ruff]
+line-length = 100

sonote-1.1.0b1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+