Skip to content

Conversation

@ai-cora
Copy link
Collaborator

@ai-cora ai-cora commented Nov 25, 2025

Summary

  • Adds whisper-cli transcription backend that invokes the binary directly (no service needed)
  • Returns audio file path in STT error responses when SAVE_AUDIO is enabled
  • Shows recovery hints with command to retry failed transcriptions

Changes

  • New whisper-cli backend: Fourth transcription backend that calls the whisper-cli binary directly, works without the whisper service running
  • Audio recovery on STT failure: When transcription fails and SAVE_AUDIO is enabled, the error response now includes the saved file path and a command to retry
  • CLI updates: Added whisper-cli as a backend option for voicemode audio transcribe

Test Plan

  • Test whisper-cli backend with saved recording
  • Verify error messages include file path when SAVE_AUDIO=true
  • Test in production with actual STT failures

Related

Task: VM-220

🤖 Generated with Claude Code

- Add whisper-cli transcription backend that invokes the binary directly,
  providing a fallback that works without the whisper service running
- When STT fails with SAVE_AUDIO enabled, include the saved audio file path
  and recovery hint in the error response
- Update error messages to show the saved recording path and command to retry
- Add whisper-cli as a fourth backend option alongside openai, whisperx, and
  whisper-cpp (service-based)

This enables LLMs to recover failed transcriptions when the whisper service
is temporarily unavailable.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@ai-cora ai-cora requested a review from mbailey November 25, 2025 12:20
Documents how to retry transcription when STT fails and audio has been
saved. Includes examples using both whisper-cli and whisper-cpp backends.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants