roboflowhnstesting01/turf-worker repository overview

⁠TurfVoice Voice Worker

LiveKit Agents worker that powers voice interaction for TurfVoice. Listens to the caller's microphone (STT), sends each completed turn to the turf-backend AI assistant, and speaks the reply back (TTS) — sharing the same conversation history as the text chat in turf-frontend.

⁠Features

• Joins a LiveKit room per voice session, using a token minted by turf-backend's /voice/token
• Speech-to-text via Groq Whisper
• Routes each turn to the same assistant logic used by POST /assistant/chat, so text and voice share one conversation
• Text-to-speech via Groq TTS, with automatic fallback to OpenAI TTS if configured
• Short, natural spoken summaries (not raw markdown/price breakdowns) for a clean voice experience

⁠Run

docker run \
  -e LIVEKIT_URL=wss://your-project.livekit.cloud \
  -e LIVEKIT_API_KEY=your-livekit-key \
  -e LIVEKIT_API_SECRET=your-livekit-secret \
  -e GROQ_API_KEY=your-groq-key \
  -e OPENAI_API_KEY=your-openai-key \
  -e MONGODB_URI=mongodb+srv://... \
  -e BACKEND_INTERNAL_URL=http://turf-backend:8000 \
  roboflowhnstesting01/turf-worker:latest

⁠Environment variables

⁠Related images

• roboflowhnstesting01/turf-backend — FastAPI backend (mints voice tokens, hosts the shared assistant logic)
• roboflowhnstesting01/turf-frontend — Next.js frontend (starts voice sessions from the AI Assistant page)