Skip to content
TomoriBot

WhisperX Transcription

WhisperX is the recommended beginner-friendly local transcription path.

Setup

Section titled “Setup”

Run these commands from the TomoriBot repo root, the folder where you cloned TomoriBot. The first command moves into the STT server folder:

Windows PowerShell

Section titled “Windows PowerShell”
Terminal window
cd servers/stt
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt
python whisperx_server.py

Linux/macOS Bash

Section titled “Linux/macOS Bash”
Terminal window
cd servers/stt
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python whisperx_server.py

Keep that terminal open while TomoriBot is using WhisperX. The default endpoint URL is http://127.0.0.1:8021.

Register in TomoriBot

Section titled “Register in TomoriBot”

Run /provider custom-endpoint add:

  • capability: transcription
  • api_style: openai-compatible-transcription
  • endpoint_url: http://127.0.0.1:8021

In the modal:

  • Transcription Model: large-v3, or whatever WHISPERX_MODEL is set to
  • Transcription Language: optional language hint, such as en or ja

Registration makes the endpoint active immediately. Use /model transcription later only when switching endpoints.

Use Transcripts

Section titled “Use Transcripts”

After registration, TomoriBot transcribes audio attachments in the background and adds the text to chat context. Use /speech transcripts only if you also want transcripts posted visibly in chat.