git404hub

what is whisper-valet fr?

yashkotha/whisper-valet — explained in plain English

Analysis updated 2026-07-24

0PythonAudience · generalComplexity · 3/5Setup · moderate

tl;dr

A macOS tool that cleans audio files and creates speaker-labeled transcripts locally. It processes audio through a pipeline that removes noise, transcribes speech, and identifies who speaks when.

vibe map

mindmap
  root((repo))
    What it does
      Cleans audio files
      Labels speakers
      Transcribes locally
      Flags low confidence
    Tech stack
      Python
      ffmpeg
      Demucs
      MacWhisper
    Use cases
      Interview transcripts
      Multi-speaker panels
      Video to text
    Outputs
      Cleaned audio
      Labeled transcript
      Subtitle files
      Confidence report
    Integrations
      Watched folder
      MCP server
      AI assistants

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Turn a two-person interview recording into a transcript that labels each speaker automatically.

VIBE 2

Clean up a noisy panel discussion audio and get subtitle files for video editing.

VIBE 3

Process video files locally into word-level timestamped transcripts without uploading anything.

VIBE 4

Let an AI assistant queue and monitor audio transcription jobs via an MCP server.

what's the stack?

PythonffmpegDemucsMacWhisperpyannoteMCP

how it stacks up fr

yashkotha/whisper-valet0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires MacWhisper installed and optionally a HuggingFace token for speaker identification.

in plain english

Whisper Valet is a macOS tool that sits alongside MacWhisper, a popular transcription app. You drop a rough audio file into a watched folder, and the valet gives you back cleaned audio plus a transcript that labels who speaks when. Everything runs locally on your machine, so your recordings never get uploaded anywhere. It works on monologues, two person interviews, or multi speaker panels. The pipeline has five stages. First, ffmpeg extracts a uniform audio stream, handling video files too. Demucs, a tool from Meta AI, separates human voices from background noise onto a clean track. The quiet speaker is then amplified to match the loud one. MacWhisper transcribes the cleaned audio with word level timestamps. Finally, pyannote figures out who speaks when using the original audio, and those labels get merged onto the transcript. The split matters: noise removal helps transcription but muddies the vocal characteristics that speaker identification relies on, so the pipeline transcribes the clean version but attributes speakers from the original. Every transcript segment carries a confidence score. Anything below 0.6 gets flagged so you know which lines to double check. If pyannote cannot run because you lack a HuggingFace token or network access, the valet falls back to MacWhisper's built in speaker detection and notes this in a report file. You get several outputs per clip: the untouched original, a cleaned version, an aggressive denoise variant, a labeled transcript, subtitle files, a JSON file with word level timestamps, and a confidence report. The project also includes an MCP server, which lets AI assistants like Claude queue files, check progress, and read transcripts. Queue operations return instantly, so long jobs do not time out. A configuration file lets you set speaker counts, optional names, and notification preferences. The daemon survives reboots and processes files sequentially. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Set up Whisper Valet on my Mac and configure a watched folder to automatically process interview audio files into speaker-labeled transcripts.
prompt 2
Configure the MCP server so I can queue audio files and check transcription progress from Claude Desktop.
prompt 3
Help me get a HuggingFace token for pyannote so Whisper Valet can identify speakers, and set up the fallback if the token is unavailable.
prompt 4
Walk me through the Whisper Valet pipeline outputs: cleaned audio, labeled transcript, subtitle files, and the confidence report.

Frequently asked questions

what is whisper-valet fr?

A macOS tool that cleans audio files and creates speaker-labeled transcripts locally. It processes audio through a pipeline that removes noise, transcribes speech, and identifies who speaks when.

What language is whisper-valet written in?

Mainly Python. The stack also includes Python, ffmpeg, Demucs.

How hard is whisper-valet to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is whisper-valet for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.