Skip to content
TomoriBot

Speech-to-Text (Local Engines)

TomoriBot treats speech-to-text as the transcription custom endpoint capability. Audio attachments are transcribed in the background and added to conversation context when an active transcription endpoint exists.

Visible transcript posting is separate. /config > Engine > Notices only controls whether voice-message transcripts are posted in chat; it does not enable or disable background STT.

Available Engines

WhisperXBeginner-friendly local transcription using the reference WhisperX server under servers/stt.
whisper.cppUse a lightweight whisper.cpp HTTP server when it exposes an OpenAI-compatible transcription endpoint.
KoboldCPPUse KoboldCPP Whisper-based STT when your build exposes OpenAI-compatible audio transcription.

Setup Flow

  1. Start one STT server from the engine guides above.
  2. In /providers, choose Add New Custom Endpoint and use API Compatibility openai-compatible-transcription.
  3. Select the saved endpoint and use its model dropdown to add the model code reported by the server.
  4. Open /config > Models > Switch Models to select and activate the registered endpoint.

Transcript Flow

When a transcription endpoint is active, TomoriBot reads supported audio attachments in the background and adds the transcript to chat context. No persona assignment is needed.

Use /config > Engine > Notices only if you also want those transcripts posted visibly in chat.

ElevenLabs users should choose Add New Provider and ElevenLabs in /providers; it registers transcription alongside speech.