mosaic/stack
1
0
Fork 0
Code Issues 10 Pull Requests Actions Packages Projects Releases 2 Wiki Activity

Speech services environment variables and ConfigModule integration #401

New Issue
Closed
opened 2026-02-15 07:35:14 +00:00 by jason.woltje · 1 comment
jason.woltje commented 2026-02-15 07:35:14 +00:00
Owner
Copy Link

Description

Define and document all environment variables for speech services, integrate with NestJS ConfigModule.

Environment Variables

STT

  • STT_ENABLED=true
  • STT_BASE_URL=http://speaches:8000/v1
  • STT_MODEL=Systran/faster-whisper-large-v3-turbo
  • STT_LANGUAGE=en

TTS - Default (Kokoro)

TTS - Premium (Chatterbox) - Optional

TTS - Fallback (Piper/OpenedAI) - Optional

Limits

  • SPEECH_MAX_UPLOAD_SIZE=25000000
  • SPEECH_MAX_DURATION_SECONDS=600
  • SPEECH_MAX_TEXT_LENGTH=4096

Acceptance Criteria

  • SpeechConfig class with validation
  • .env.example updated
  • ConfigModule integration in SpeechModule
  • Startup validation (fail fast if STT/TTS enabled but URL not reachable)
  • Documentation in AGENTS.md
## Description Define and document all environment variables for speech services, integrate with NestJS ConfigModule. ## Environment Variables ### STT - STT_ENABLED=true - STT_BASE_URL=http://speaches:8000/v1 - STT_MODEL=Systran/faster-whisper-large-v3-turbo - STT_LANGUAGE=en ### TTS - Default (Kokoro) - TTS_ENABLED=true - TTS_DEFAULT_URL=http://kokoro-tts:8880/v1 - TTS_DEFAULT_VOICE=af_heart - TTS_DEFAULT_FORMAT=mp3 ### TTS - Premium (Chatterbox) - Optional - TTS_PREMIUM_ENABLED=false - TTS_PREMIUM_URL=http://chatterbox-tts:8881/v1 ### TTS - Fallback (Piper/OpenedAI) - Optional - TTS_FALLBACK_ENABLED=false - TTS_FALLBACK_URL=http://openedai-speech:8000/v1 ### Limits - SPEECH_MAX_UPLOAD_SIZE=25000000 - SPEECH_MAX_DURATION_SECONDS=600 - SPEECH_MAX_TEXT_LENGTH=4096 ## Acceptance Criteria - [ ] SpeechConfig class with validation - [ ] .env.example updated - [ ] ConfigModule integration in SpeechModule - [ ] Startup validation (fail fast if STT/TTS enabled but URL not reachable) - [ ] Documentation in AGENTS.md
jason.woltje added this to the M13-SpeechServices (0.0.13) milestone 2026-02-15 07:35:14 +00:00
jason.woltje commented 2026-02-15 09:30:14 +00:00
Author
Owner
Copy Link

Completed as part of M13-SpeechServices milestone on branch feature/m13-speech-services. SP-CFG-001: Speech services config and ConfigModule integration (commit 4cc43be, 51 tests). All quality gates passed (lint, typecheck, tests, security).

Completed as part of M13-SpeechServices milestone on branch feature/m13-speech-services. SP-CFG-001: Speech services config and ConfigModule integration (commit 4cc43be, 51 tests). All quality gates passed (lint, typecheck, tests, security).
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ai
AI/LLM integration
 api
Backend/API work
 api
auth
Authentication
 database
database
Database/schema work
 devops
Docker/deployment
 docs
Documentation
 frontend
graph
knowledge-module
migration
Data migration
 orchestrator
Orchestrator service (apps/orchestrator/)
 p0
Critical priority
 p1
High priority
 p2
Medium priority
 p3
Low priority
 performance
Performance work
 phase-1
phase-2
phase-3
phase-4
phase-5
plugin
MoltBot plugin work
 search
security
Security-related
 setup
Initial setup
 testing
Testing/QA
 web
Frontend work
No Label
Milestone
No items
No Milestone M13-SpeechServices (0.0.13)
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaic/stack#401
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?