2624d49984
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.
86 lines
3.9 KiB
Text
86 lines
3.9 KiB
Text
# Vignette local development env example.
|
|
# Production/compose deployment should use infra/.env.example instead.
|
|
|
|
ENVIRONMENT=dev
|
|
DATABASE_URL=postgresql://vignette_app:change-me-app@127.0.0.1:55432/vignette
|
|
|
|
# Engine gateway. For local Claude CLI gateway, run apps/api/engine_gateway on 9099.
|
|
ENGINE_URL=http://127.0.0.1:9099
|
|
ENGINE_MODE=claude_cli
|
|
# 선택: 설정하면 API와 gateway에 동일한 32자 이상 임의 값을 주입한다.
|
|
# 미설정은 127.0.0.1:9099 로컬 개발 호환을 유지한다.
|
|
ENGINE_GATEWAY_SHARED_SECRET=
|
|
# 실시간 내담자는 도구 없는 상주 Claude lane, 관리자 선택 provider는 평가/저작에 유지.
|
|
VIGNETTE_LIVE_CLIENT_PROVIDER=claude_cli
|
|
CLAUDE_BIN=claude
|
|
CODEX_BIN=codex
|
|
AGY_BIN=agy
|
|
ENGINE_CLI_CWD=
|
|
ENGINE_CAPABILITY_CACHE_TTL_SECONDS=60
|
|
ENGINE_CLI_TIMEOUT_SECONDS=300
|
|
|
|
# External providers. Keep real secrets in .env files only.
|
|
ANTHROPIC_API_KEY=
|
|
ANTHROPIC_API_BASE=https://api.anthropic.com
|
|
OPENAI_API_KEY=
|
|
OPENAI_BASE_URL=https://api.openai.com/v1
|
|
VIGNETTE_VOICE_POC_SAMPLE_TTS=false
|
|
VIGNETTE_VOICE_POC_SAMPLE_TTS_DIR=
|
|
# 로컬 연구/개발 전용. Higgs v3 서버는 scripts/start-higgs-tts.ps1 로 127.0.0.1:9881에 띄운다.
|
|
VIGNETTE_VOICE_TTS_PROVIDER=openai
|
|
VIGNETTE_HIGGS_TTS_URL=http://127.0.0.1:9881
|
|
VIGNETTE_HIGGS_TTS_TIMEOUT_SECONDS=300
|
|
|
|
# `melotts`는 노트북 상주 MeloTTS 한국어 사이드카(MIT)라 운영에서도 쓸 수 있다.
|
|
# 사전학습 다화자 모델이라 실존 인물 reference 를 쓰지 않는다.
|
|
# 서버는 scripts/start-melotts.ps1 로 띄운다.
|
|
VIGNETTE_MELOTTS_TTS_URL=http://127.0.0.1:9883
|
|
VIGNETTE_MELOTTS_TTS_TIMEOUT_SECONDS=120
|
|
|
|
# STT. `local_whisper`는 노트북 상주 faster-whisper 사이드카를 쓴다. 외부 키가 필요 없고
|
|
# 오디오가 호스트를 벗어나지 않는다. 서버는 scripts/start-local-whisper-stt.ps1 로 띄운다.
|
|
# `openai`는 배치라 interim 이 없고, `deepgram`은 운영 키가 필요하다.
|
|
VIGNETTE_VOICE_STT_PROVIDER=openai
|
|
VIGNETTE_LOCAL_WHISPER_STT_URL=ws://127.0.0.1:9882/v1/listen
|
|
VIGNETTE_LOCAL_WHISPER_STT_MODEL=large-v3
|
|
VIGNETTE_LOCAL_WHISPER_STT_LANGUAGE=ko
|
|
VIGNETTE_LOCAL_WHISPER_ENDPOINTING_MS=300
|
|
VIGNETTE_LOCAL_WHISPER_UTTERANCE_END_MS=1200
|
|
|
|
# Auth/session. Local dev may enable dev-login; public/prod must not.
|
|
SESSION_SECRET=dev-insecure-change-me
|
|
OAUTH_GOOGLE_CLIENT_ID=
|
|
OAUTH_GOOGLE_CLIENT_SECRET=
|
|
OAUTH_REDIRECT_URI=https://api-vignette.chanpaca.net/auth/callback
|
|
AUTH_ALLOWED_EMAIL_DOMAINS=["hs.ac.kr","twentyoz.kr"]
|
|
AUTH_TEACHER_EMAILS=[]
|
|
AUTH_ADMIN_EMAILS=[]
|
|
AUTH_DEV_LOGIN_ENABLED=true
|
|
AUTH_DEV_LOGIN_EXTRA_ORIGINS=[]
|
|
DEFAULT_AFFILIATION=
|
|
AUTO_SEED_PERSONAS=false
|
|
ALLOW_SEED_PERSONA_FALLBACK=false
|
|
EVALUATOR_GOLDEN_FEWSHOT_ENABLED=false
|
|
FRONTEND_BASE_URL=http://localhost:5173
|
|
FRONTEND_ORIGIN_MAP={"api-vignette.chanpaca.net":"https://vignette.chanpaca.net","api-vnet.18ka.net":"https://vnet.18ka.net"}
|
|
CORS_ORIGINS=["https://vignette.chanpaca.net","https://vnet.18ka.net","https://vignette-b1q.pages.dev","http://localhost:5170","http://localhost:5171","http://localhost:5172","http://localhost:5173","http://localhost:5174","http://localhost:5175","http://localhost:5176","http://localhost:5177","http://localhost:5178","http://localhost:5179","http://localhost:5180","http://127.0.0.1:5170","http://127.0.0.1:5171","http://127.0.0.1:5172","http://127.0.0.1:5173","http://127.0.0.1:5174","http://127.0.0.1:5175","http://127.0.0.1:5176","http://127.0.0.1:5177","http://127.0.0.1:5178","http://127.0.0.1:5179","http://127.0.0.1:5180"]
|
|
|
|
# Operational email notifications. Use smtp only when SMTP credentials are ready.
|
|
NOTIFICATION_EMAIL_PROVIDER=disabled
|
|
NOTIFICATION_EMAIL_MAX_ATTEMPTS=3
|
|
NOTIFICATION_EMAIL_RETRY_SECONDS=900
|
|
SMTP_HOST=
|
|
SMTP_PORT=587
|
|
SMTP_USERNAME=
|
|
SMTP_PASSWORD=
|
|
SMTP_FROM_EMAIL=
|
|
SMTP_FROM_NAME=Vignette
|
|
SMTP_STARTTLS=true
|
|
SMTP_SSL=false
|
|
|
|
# Live2D runtime. Models must be configured per persona via live2dModelUrl.
|
|
VITE_LIVE2D_CUBISM_CORE=/live2d/live2dcubismcore.min.js
|
|
|
|
# Engine CLI fallback path.
|
|
CLAUDE_P_PATH=claude
|
|
GLM_OR_FALLBACK_MODEL=
|