vignette/.env.example
Yun Chan 05aa7b312e 로컬 whisper STT 사이드카 디바이스 폴백과 deprecated audioop 제거
cuDNN 부재 환경에서 ctranslate2 는 Python 예외가 아니라 네이티브 크래시로 죽어
프로세스가 통째로 사라진다. 같은 프로세스의 try/except 로는 절대 잡을 수 없어
디바이스 확인을 버릴 수 있는 자식 프로세스(--self-check)로 분리했다.
auto 는 CUDA 프로브 실패 시 CPU(int8)로 폴백하고, 명시적 --device cuda 는 조용히
강등하지 않는다.

함께 고친 것:
- warmup PCM 생성의 연산자 우선순위 버그(b"\x00\x00" * N // 2 가 바이트열 정수
  나눗셈이 되어 TypeError). warmup_pcm() 으로 분리하고 테스트로 고정했다.
- audioop 은 Python 3.13 에서 제거되므로 array + 정수 연산으로 RMS 를 직접 구한다.

실측(저장소 무참조 synthetic seed 8.72초, CPU int8 small):
interim 9 · final 5 · word timestamp 12개 present, 전사는 원문과 한 글자 차이.
사이드카 회귀 37/37.
2026-08-08 01:39:58 +09:00

80 lines
3.6 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
# 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=