🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Voice Transcribe

by @darinkishore

Transcribe audio files using OpenAI's gpt-4o-mini-transcribe model with vocabulary hints and text replacements. Requires uv (https://docs.astral.sh/uv/).

Versionv1.0.1
Downloads6,261
Installs40
Stars⭐ 13
TERMINAL
clawhub install voice-transcribe

πŸ“– About This Skill


name: voice-transcribe description: Transcribe audio files using OpenAI's gpt-4o-mini-transcribe model with vocabulary hints and text replacements. Requires uv (https://docs.astral.sh/uv/).

voice-transcribe

transcribe audio files using openai's gpt-4o-mini-transcribe model.

when to use

when receiving voice memos (especially via whatsapp), just run:

uv run /Users/darin/clawd/skills/voice-transcribe/transcribe 
then respond based on the transcribed content.

fixing transcription errors

if darin says a word was transcribed wrong, add it to vocab.txt (for hints) or replacements.txt (for guaranteed fix). see sections below.

supported formats

  • mp3, mp4, mpeg, mpga, m4a, wav, webm, ogg, opus
  • examples

    # transcribe a voice memo
    transcribe /tmp/voice-memo.ogg

    pipe to other tools

    transcribe /tmp/memo.ogg | pbcopy

    setup

    1. add your openai api key to /Users/darin/clawd/skills/voice-transcribe/.env:

       OPENAI_API_KEY=sk-...
       

    custom vocabulary

    add words to vocab.txt (one per line) to help the model recognize names/jargon:

    Clawdis
    Clawdbot
    

    text replacements

    if the model still gets something wrong, add a replacement to replacements.txt:

    wrong spelling -> correct spelling
    

    notes

  • assumes english (no language detection)
  • uses gpt-4o-mini-transcribe model specifically
  • caches by sha256 of audio file
  • ⚑ When to Use

    whenAction
    ```bash
    uv run /Users/darin/clawd/skills/voice-transcribe/transcribe
    ```
    then respond based on the transcribed content.

    πŸ’‘ Examples

    # transcribe a voice memo
    transcribe /tmp/voice-memo.ogg

    pipe to other tools

    transcribe /tmp/memo.ogg | pbcopy

    βš™οΈ Configuration

    1. add your openai api key to /Users/darin/clawd/skills/voice-transcribe/.env:

       OPENAI_API_KEY=sk-...
       

    πŸ“‹ Tips & Best Practices

  • assumes english (no language detection)
  • uses gpt-4o-mini-transcribe model specifically
  • caches by sha256 of audio file