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

Docker Compose dev overlay for speech services #399

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

Description

Create Docker Compose overlay for local development with all speech services.

Services

docker-compose.speech.yml (dev overlay)

  • speaches: ghcr.io/speaches-ai/speaches:latest on port 8090:8000, volume speaches-models:/root/.cache/huggingface, env WHISPER__MODEL=Systran/faster-whisper-large-v3-turbo
  • kokoro-tts: ghcr.io/remsky/kokoro-fastapi:latest-cpu on port 8880:8880
  • chatterbox-tts (optional, premium-tts profile): devnen/chatterbox-tts-server:latest on port 8881:8000, requires GPU capability reservation

Usage

  • Basic (STT + default TTS): docker compose -f docker-compose.yml -f docker-compose.speech.yml up
  • With premium TTS: docker compose -f docker-compose.yml -f docker-compose.speech.yml --profile premium-tts up

Acceptance Criteria

  • docker-compose.speech.yml created
  • Speaches service configured
  • Kokoro-FastAPI service configured
  • Chatterbox behind optional profile
  • Networks connect to main compose internal network
  • Volume for model caching
  • Makefile targets: speech-up, speech-down, speech-logs
## Description Create Docker Compose overlay for local development with all speech services. ## Services ### docker-compose.speech.yml (dev overlay) - speaches: ghcr.io/speaches-ai/speaches:latest on port 8090:8000, volume speaches-models:/root/.cache/huggingface, env WHISPER__MODEL=Systran/faster-whisper-large-v3-turbo - kokoro-tts: ghcr.io/remsky/kokoro-fastapi:latest-cpu on port 8880:8880 - chatterbox-tts (optional, premium-tts profile): devnen/chatterbox-tts-server:latest on port 8881:8000, requires GPU capability reservation ### Usage - Basic (STT + default TTS): docker compose -f docker-compose.yml -f docker-compose.speech.yml up - With premium TTS: docker compose -f docker-compose.yml -f docker-compose.speech.yml --profile premium-tts up ## Acceptance Criteria - [ ] docker-compose.speech.yml created - [ ] Speaches service configured - [ ] Kokoro-FastAPI service configured - [ ] Chatterbox behind optional profile - [ ] Networks connect to main compose internal network - [ ] Volume for model caching - [ ] Makefile targets: speech-up, speech-down, speech-logs
jason.woltje added this to the M13-SpeechServices (0.0.13) milestone 2026-02-15 07:34:59 +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-DOC-001: Docker Compose dev overlay for speech services (commit 52553c8). All quality gates passed (lint, typecheck, tests, security).

Completed as part of M13-SpeechServices milestone on branch feature/m13-speech-services. SP-DOC-001: Docker Compose dev overlay for speech services (commit 52553c8). 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#399
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?