Local Voice Assistant (Docker Compose)

This repository contains a minimal multi-container voice assistant composed of:

• whisper - FastAPI service exposing POST /transcribe for speech-to-text using Whisper.
• coquitts - FastAPI service exposing POST /speak for text-to-speech using Coqui TTS.
• ollama - Placeholder container running an Ollama-compatible LLM (exposed on port 11434).
• middleware - FastAPI service exposing POST /chat that orchestrates the above services.

Quick notes & assumptions

• These services are a starting point. Models will be downloaded on first run and may require lots of disk and memory.
• ollama uses a placeholder public image; you must replace it with your own Ollama setup or run an Ollama server with the desired model.
• The Whisper service uses the whisper Python package. For better performance consider faster-whisper or running Whisper in GPU-enabled base images.
• The Coqui TTS service uses the TTS package and downloads German models on first run.

Run locally with Docker Compose

1. Build and start:

docker-compose up --build

2. Example request to the middleware:

curl -X POST "http://localhost:8000/chat" -F "file=@./sample.wav;type=audio/wav" --output response.wav

The response.wav will contain the German TTS response.

Next steps / improvements

• Add authentication between services.
• Add healthchecks and readiness probes.
• Add model selection, caching, and GPU support where available.
• Replace Ollama placeholder with a validated model name and response parsing.