docs: document call transcription STT/LLM env vars for operators (LC-398) #413

Merged

longjacksonle merged 1 commit from docs/lc-398-transcription-env-docs into main

2026-06-20 09:36:50 +02:00

longjacksonle commented

2026-06-20 09:36:39 +02:00

Owner

Documents the call-transcription env vars for operators. They were only in CLAUDE.md (internal dev guidance) - missing from every operator-facing surface.

Adds LETS_CHAT_STT_URL / _API_KEY / _MODEL (server-side STT, LC-393 Phase 3) and LETS_CHAT_LLM_URL / _API_KEY / _MODEL (AI transcript summaries, LC-396/LC-398) to:

README.md env-var table (two new rows, after LETS_CHAT_ICE_SERVERS).
.env.standalone and .env.saas: a commented "Call transcription (optional)" block in Shared Configuration with example values, the default-engine note (unset = in-browser Web Speech), and the operator-trusted / NOT-SSRF-filtered warning (may be localhost/internal; never an untrusted host).
compose.yml: a pointer comment to the env-file templates for the required SSO + optional features (mail, STT, LLM), since it previously had no mention of them at all.

How to activate (the short version)

Server-side transcription: set LETS_CHAT_STT_URL to an OpenAI-compatible /v1/audio/transcriptions endpoint (e.g. http://127.0.0.1:8090/v1/audio/transcriptions). Unset = browsers transcribe locally.
AI summaries: set LETS_CHAT_LLM_URL to an OpenAI-compatible /v1/chat/completions endpoint (e.g. Ollama at http://127.0.0.1:11434/v1/chat/completions). Unset = the Summarize action is hidden.
Both: _API_KEY optional bearer token, _MODEL optional (defaults whisper-1 / gpt-4o-mini).

Docs only; no code change, no tests affected.

Documents the call-transcription env vars for operators. They were only in CLAUDE.md (internal dev guidance) - missing from every operator-facing surface. Adds `LETS_CHAT_STT_URL` / `_API_KEY` / `_MODEL` (server-side STT, LC-393 Phase 3) and `LETS_CHAT_LLM_URL` / `_API_KEY` / `_MODEL` (AI transcript summaries, LC-396/LC-398) to: - **README.md** env-var table (two new rows, after `LETS_CHAT_ICE_SERVERS`). - **.env.standalone** and **.env.saas**: a commented "Call transcription (optional)" block in Shared Configuration with example values, the default-engine note (unset = in-browser Web Speech), and the operator-trusted / NOT-SSRF-filtered warning (may be localhost/internal; never an untrusted host). - **compose.yml**: a pointer comment to the env-file templates for the required SSO + optional features (mail, STT, LLM), since it previously had no mention of them at all. ## How to activate (the short version) - Server-side transcription: set `LETS_CHAT_STT_URL` to an OpenAI-compatible `/v1/audio/transcriptions` endpoint (e.g. `http://127.0.0.1:8090/v1/audio/transcriptions`). Unset = browsers transcribe locally. - AI summaries: set `LETS_CHAT_LLM_URL` to an OpenAI-compatible `/v1/chat/completions` endpoint (e.g. Ollama at `http://127.0.0.1:11434/v1/chat/completions`). Unset = the Summarize action is hidden. - Both: `_API_KEY` optional bearer token, `_MODEL` optional (defaults `whisper-1` / `gpt-4o-mini`). Docs only; no code change, no tests affected.

longjacksonle added 1 commit

2026-06-20 09:36:39 +02:00

docs: document call transcription STT/LLM env vars for operators (LC-398)

check-secrets / Kingfisher (push) Successful in 4s

Details

check-secrets / Nosey parker (push) Successful in 4s

Details

check-secrets / TruffleHog (push) Successful in 4s

Details

check-secrets / Kingfisher (pull_request) Successful in 4s

Details

check-secrets / Nosey parker (pull_request) Successful in 4s

Details

check-secrets / TruffleHog (pull_request) Successful in 5s

Details

Create release / Create release from merged PR (pull_request) Has been skipped

Details

Check / clippy + fmt + tests (pull_request) Successful in 3m44s

Details

6002b83855

The server-side STT (LC-393 Phase 3) and AI-summary (LC-396/LC-398) env vars were only in CLAUDE.md (internal dev guidance), not in any operator-facing surface. Add them to the README environment-variable table, to both .env.standalone and .env.saas (a commented "Call transcription (optional)" block in Shared Configuration with example values + the operator-trusted / not-SSRF-filtered note), and add a pointer comment in compose.yml to the env-file templates for the required SSO + optional features (mail, STT, LLM).

Docs only; no code change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>