vignette/scripts
Yun Chan 2624d49984 설치형 로컬 TTS를 MeloTTS 한국어(MIT)로 채택하고 엔드포인트로 연결
Higgs Audio v3 는 연구/비상업 라이선스라 config.py 가 environment != dev 에서
차단하고 있었다. 그 가드를 푸는 건 법적 판단이라 코드로 결정할 수 없어서,
상업 사용이 허용된 설치형을 다시 찾아 MeloTTS Korean 으로 바꿨다. 결과적으로
가드를 건드릴 필요 자체가 사라졌다 — Higgs 가드는 그대로 두고 provider 만
melotts 로 두면 운영에서도 동작한다.

검토 결과:
- MeloTTS   MIT       한국어 지원  -> 채택. CPU 실시간, 사전학습 다화자
- Kokoro-82M Apache2.0 한국어 없음  -> 탈락. 공식 VOICES.md 언어 목록에 부재
- Piper      GPL                   -> 탈락
- XTTS-v2 / Fish Speech 비상업      -> 탈락. Higgs 와 같은 문제

사전학습 다화자 모델이라 실존 인물 reference 를 쓰지 않는다. Higgs 경로가
P1 프리셋 한정이던 이유가 없으므로 모든 페르소나 프리셋에 적용된다.

구현:
- scripts/melotts-server.py  loopback HTTP 사이드카(/health, POST /tts -> WAV)
- voice_tts_provider=melotts 경로와 VIGNETTE_MELOTTS_TTS_* 설정
- scripts/start-melotts.ps1  런처(설치 순서 안내 포함)

실측:
- CPU 정상 상태 RTF 0.27~0.28(실시간 3.6배). 첫 실행 13.25 는 모델 다운로드
- POST /tts 200, WAV 350,566 bytes, 3.61s, 헤더 provider/model/license
- 빈 텍스트 422, 미지 경로 404 로 fail-closed
- 왕복 검증: MeloTTS 합성음을 로컬 faster-whisper 가 완전 일치 전사
  "그렇게 느끼셨군요. 조금 더 이야기해 주실 수 있을까요?" (word timestamp 8개)

설치 함정 3가지를 decisions/local-voice-stack.md 에 남겼다.
librosa 0.9.1 의 pkg_resources(setuptools<81), MeloTTS 가 언어와 무관하게
임포트하는 일본어 unidic 사전, Windows 한국어 g2p 의 eunjeon.

G7 게이트의 TTS 허용목록에 melotts 를 추가했다. 선언/실제 불일치 차단과
배치 STT 배제는 그대로다.

검증: API 914 passed, 사이드카 melotts 16/16 + whisper 37/37, SSOT FAIL 0, ruff clean.
2026-08-08 09:29:57 +09:00
..
backfill-claude-token-usage.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
backup-vignette-db.ps1 G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
boot-public-runtime.ps1 feat: 운영 안정성과 세션 음성 경험 개선 2026-07-31 00:13:08 +09:00
build-outcome-os-release-patch.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
capture-g7-runtime-evidence.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
capture-g7-topology-evidence.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
check-alliance-pulse-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
check-case-worksheet-rubric.py 평가 및 화면 구조 정리 2026-06-28 21:50:21 +09:00
check-deliberate-practice-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
check-deploy-preflight.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
check-dev-dashboard-ssot.py G8 실제 rollback 증명 종료와 비-secure origin 회기 리뷰 크래시 수정 2026-08-07 22:17:20 +09:00
check-engine-gateway-contract.mjs 런타임 계약과 학습자 흐름 보강 2026-06-29 08:12:14 +09:00
check-g7-external-proof.py 설치형 로컬 TTS를 MeloTTS 한국어(MIT)로 채택하고 엔드포인트로 연결 2026-08-08 09:29:57 +09:00
check-measurement-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
check-measurement-provenance-census.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
check-outcome-os-release-manifest.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
check-outcome-trajectory-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
check-phase3-artifacts.py 세션 평가·라이브코치·교수자 분석 라운드 마감 + 문서 정리 + 코드품질 리팩터 2026-07-02 02:50:36 +09:00
check-postgres-rls-audit.py 대시보드 폴드아웃/드릴다운 정리 + 페르소나 역린·misconduct 반응 + 게이트웨이 격리·RAG 비차단 수정 2026-06-27 02:30:46 +09:00
compare-alliance-calibration.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
cutover-recovered-public-db.ps1 G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
dev-down.ps1 현재 작업 전체 반영 2026-06-27 16:08:41 +09:00
dev-up.ps1 G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
evaluate-pii-masking.py 평가 및 화면 구조 정리 2026-06-28 21:50:21 +09:00
export-phase3-kpi.py 운영 지표와 지원 요청 저장소 추가 2026-06-28 20:13:06 +09:00
export-recursive-dataset.py 전 저장소 리팩터링과 SSOT 정비 2026-07-15 21:31:30 +09:00
generate-measurement-contract.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
higgs-tts-server.py feat: 운영 안정성과 세션 음성 경험 개선 2026-07-31 00:13:08 +09:00
install-health-sampler-task.ps1 운영 지표와 지원 요청 저장소 추가 2026-06-28 20:13:06 +09:00
install-public-runtime-task.ps1 현재 작업 전체 반영 2026-06-27 16:08:41 +09:00
launch-nas-preview-g8-helpers.py G8 실제 rollback 증명 종료와 비-secure origin 회기 리뷰 크래시 수정 2026-08-07 22:17:20 +09:00
load-test-sessions.py 전 저장소 리팩터링과 SSOT 정비 2026-07-15 21:31:30 +09:00
local-whisper-stt-server.py 로컬 whisper STT 사이드카 디바이스 폴백과 deprecated audioop 제거 2026-08-08 01:39:58 +09:00
maintain-admin-health-events.py 운영 지표와 지원 요청 저장소 추가 2026-06-28 20:13:06 +09:00
materialize-persona-seeds.py 페르소나 소스팩 동기화 정리 2026-06-28 20:12:35 +09:00
melotts-server.py 설치형 로컬 TTS를 MeloTTS 한국어(MIT)로 채택하고 엔드포인트로 연결 2026-08-08 09:29:57 +09:00
merge-recovery-google-session-delta.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
preserve-pages-assets.ps1 세션 화면 배포 증거 갱신 2026-07-31 09:27:51 +09:00
probe-engine-gateway.py 대시보드 폴드아웃/드릴다운 정리 + 페르소나 역린·misconduct 반응 + 게이트웨이 격리·RAG 비차단 수정 2026-06-27 02:30:46 +09:00
probe-nas-preview-g8-rollback.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
provision-nas-preview-env.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
provision-outcome-os-runtime-secrets.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
record-admin-health-sample.py 운영 지표와 지원 요청 저장소 추가 2026-06-28 20:13:06 +09:00
register-boot-task.ps1 세션 평가·라이브코치·교수자 분석 라운드 마감 + 문서 정리 + 코드품질 리팩터 2026-07-02 02:50:36 +09:00
rehearse-measurement-migration.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
report-ai-usage.py 운영 지표와 지원 요청 저장소 추가 2026-06-28 20:13:06 +09:00
run-alliance-calibration.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
run-notification-worker.py 메일 알림 시스템 추가 2026-06-29 17:07:01 +09:00
run-outcome-os-release-agent.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
run-session-digest-worker.py 런타임 계약과 학습자 흐름 보강 2026-06-29 08:12:14 +09:00
serve-nas-preview-rollback-executor.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
serve-synthetic-rollback-executor.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-alliance-pulse-api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-calibration-transfer-api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-calibration-transfer-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-continuous-improvement-agentic-producer.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-continuous-improvement-api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-continuous-improvement-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-deliberate-practice-api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-deliberate-practice-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-multimodal-alliance-api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-multimodal-alliance-ledger.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-multimodal-consent-concurrency.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-outcome-trajectory-alerts.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-outcome-trajectory-api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-resistance-openness-db.py 저항엔진 smoke 검증 강화 2026-06-28 12:23:31 +09:00
smoke-rupture-repair-api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-rupture-repair-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-rupture-runtime-auto.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-session-learning-producer.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-supervision-research-api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-supervision-research-ledger.sql G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
smoke-supervision-version-comparison-producer.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
soak-public-voice-websocket.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
soak-voice-websocket.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
start-higgs-tts.ps1 feat: 운영 안정성과 세션 음성 경험 개선 2026-07-31 00:13:08 +09:00
start-local-whisper-stt.ps1 G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
start-melotts.ps1 설치형 로컬 TTS를 MeloTTS 한국어(MIT)로 채택하고 엔드포인트로 연결 2026-08-08 09:29:57 +09:00
start-nas-preview-engine.ps1 G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
start-public-runtime.ps1 G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
start-tailscale-runtime.ps1 현재 작업 상태 저장 2026-06-27 11:20:24 +09:00
stop-public-runtime.ps1 현재 작업 상태 저장 2026-06-27 11:20:24 +09:00
sync-persona-sources.py 라이브코치 소스팩 새로고침 보강 2026-06-28 23:52:55 +09:00
test_backup_vignette_db.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_cutover_recovered_public_db.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_deploy_preflight.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_dev_dashboard_ssot.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_dev_up_db_safety.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_g7_external_proof.py 설치형 로컬 TTS를 MeloTTS 한국어(MIT)로 채택하고 엔드포인트로 연결 2026-08-08 09:29:57 +09:00
test_g7_external_voice_soak.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_g7_runtime_evidence.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_g7_topology_evidence.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_launch_nas_preview_g8_helpers.py G8 실제 rollback 증명 종료와 비-secure origin 회기 리뷰 크래시 수정 2026-08-07 22:17:20 +09:00
test_local_whisper_stt_server.py 로컬 whisper STT 사이드카 디바이스 폴백과 deprecated audioop 제거 2026-08-08 01:39:58 +09:00
test_measurement_provenance_tools.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_melotts_server.py 설치형 로컬 TTS를 MeloTTS 한국어(MIT)로 채택하고 엔드포인트로 연결 2026-08-08 09:29:57 +09:00
test_outcome_os_release_agent.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_outcome_os_release_manifest.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_probe_nas_preview_g8_rollback.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_provision_nas_preview_env.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_provision_outcome_os_runtime_secrets.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_serve_nas_preview_rollback_executor.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_serve_synthetic_rollback_executor.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_smoke_calibration_transfer_api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_smoke_continuous_improvement_api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
test_smoke_deliberate_practice_api.py G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00
watch-public-runtime-hidden.vbs 한신대 피드백 개선팩 반영 2026-07-03 19:53:14 +09:00
watch-public-runtime.ps1 G0~G8 성과·동맹 측정 OS 작업 일괄 고정 2026-08-08 01:30:53 +09:00