Audio transcription in supervisor route

[Luisotee]

Audio Transcription Support for Supervisor Route

Overview

Add audio transcription capabilities to the supervisor route using Groq's Whisper V3 Turbo API. This centralizes audio processing in the AI API service, eliminating the need for individual transcription handling in client integrations (simulator, WhatsApp, Telegram).

Technical Changes

• Added support for multiple audio formats:
  • Direct support: mp3, mp4, mpeg, mpga, m4a, wav, webm
  • Conversion support: ogg -> mp3
• Implemented audio file handling with temporary storage
• Integrated Groq's Whisper V3 Turbo for transcription
• Added content type detection and validation
• Centralized error handling for audio processing

Dependencies

• Added python-multipart for form data handling
• Added python-ffmpeg for audio conversion
• Added groq for Whisper API access

Configuration

Requires GROQ_API_KEY environment variable

Benefits

• Centralized audio processing
• Consistent transcription quality
• Reduced implementation complexity in clients
• Unified error handling

[luandro]

@Luisotee, it's working great, amazing job! Just don't forget to add the packages you use. For example:

uv add ffmpeg python-multipart

Which will automatically add to the pyproject.toml file and will reflect on every run of the the project. Added on my commit.

A second comment is that the route /api/supervisor/supervisor isn't ideal. Might be a good opportunity to change to /api/classifier or something else.

[Luisotee]

@luandro should be fine now

[luandro]

@Luisotee when testing on the docs page, "send empty value" works when set for message, but for some reason when setting empty value for message an error is throw: