gitwtfhub

wtf is my-whisper?

neurosonya/my-whisper — explained in plain English

Analysis updated 2026-05-18

11PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A free, private voice dictation tool for Apple Silicon Macs that types out your speech into any app without sending audio to the cloud.

Mindmap

mindmap
  root((my whisper))
    What it does
      Local voice dictation
      Types into any app
      No cloud, no subscription
    Tech stack
      Python
      Whisper speech model
      Ollama plus Gemma 3
    Use cases
      Dictate notes and messages
      Multilingual transcription
      Optional text cleanup
    Audience
      Mac users
      Privacy focused users
      Apple Silicon owners

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

Why would anyone build with this?

REASON 1

Dictate text into any Mac app, like notes, browsers, or messaging apps, by holding a hotkey.

REASON 2

Get speech turned into text in Russian, English, or about 100 other languages without an internet connection after setup.

REASON 3

Optionally clean up spoken text automatically to fix grammar and remove filler words.

REASON 4

Replace a paid cloud dictation subscription with a free, private, local alternative.

What's in the stack?

PythonWhispermlx-whisperOllamaGemma 3

How it stacks up

neurosonya/my-whisper2arons/llm-cliabe238/claude-video-plus
Stars111111
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an Apple Silicon Mac (M1 or newer) and Python 3.10+, several macOS permissions must be granted manually.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

My Whisper is a free tool for Mac that lets you dictate text into any app just by talking, similar to the paid service Wispr Flow, but everything runs locally on your own computer instead of in the cloud. You hold down the Option key while speaking in any app such as Telegram, a browser, notes, or email, let go, and within a couple of seconds the recognized text appears right where your cursor was. The key difference from cloud based alternatives is privacy and cost: your voice recording never leaves your Mac, there is no subscription to pay, and the internet is only needed once, to download the recognition models. Under the hood, it uses OpenAI's Whisper speech recognition model, run through a version optimized for Apple's own chips, to turn speech into punctuated text in Russian, English, and around 100 other languages. Optionally, it can also use a small local AI model called Gemma 3, run through a tool called Ollama, to clean up the raw transcription by fixing misheard words, correcting grammar, and removing filler sounds like um. This only works on Apple Silicon Macs (the M1 through M4 chip families), not on Intel Macs or Windows. You need Python 3.10 or newer, about 2 gigabytes of free disk space for the speech model, an extra 3 gigabytes if you want the optional text cleanup feature, and roughly 15 minutes to set everything up. Installation involves downloading the project files, double clicking an install script that sets up the environment and downloads the model, then double clicking a start script that adds a small icon to your Mac's menu bar. You then need to grant a few macOS permissions covering microphone access, the ability to insert text into other apps, and the ability to detect your held down hotkey. The README also covers optional automatic startup when your Mac boots, and includes a troubleshooting section for common permission related issues. The project is released under the MIT license, meaning anyone can use, modify, and share it freely. It was built by its creator with help from Claude Code, and would appeal to Mac users who want a private, free voice dictation tool without depending on cloud services or subscriptions.

Yoink these prompts

Prompt 1
Walk me through installing this local dictation tool on my Apple Silicon Mac step by step.
Prompt 2
Help me grant the microphone and accessibility permissions this app needs on macOS.
Prompt 3
Explain how to set up the optional Ollama based text cleanup feature for this tool.
Prompt 4
My hotkey isn't working after installing this, help me troubleshoot using the log file.

Frequently asked questions

wtf is my-whisper?

A free, private voice dictation tool for Apple Silicon Macs that types out your speech into any app without sending audio to the cloud.

What language is my-whisper written in?

Mainly Python. The stack also includes Python, Whisper, mlx-whisper.

What license does my-whisper use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is my-whisper to set up?

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

Who is my-whisper for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.