whisper-memo
Record a voice memo in your terminal, get the transcript on your clipboard. Transcription runs entirely on your machine with faster-whisper. No account, no API key, no audio leaves your computer.
Why
I built this project as a simple way to capture changes I wanted to make during quality review checks on my Claude development. While reviewing changes, I activate whisper-memo and just talk, then paste that into Claude. There are many solutions to this problem, but I had some specific needs, so I built this small tool.
Install
With uv (recommended) or pipx:
uv tool install whisper-memo # CPU, works everywhere
uv tool install 'whisper-memo[cuda]' # NVIDIA GPU on Linux or Windows
Replace uv tool install with pipx install if you use pipx.
The first run downloads the Whisper model from Hugging Face (about 1.6 GB for the default large-v3-turbo).
After that, everything works offline.
Platform notes
- Linux: install PortAudio for the microphone (
sudo apt install libportaudio2) and a clipboard tool (xclip,xselorwl-clipboard). - macOS: the terminal asks for microphone permission the first time. Transcription runs on the CPU;
pick a smaller model (
-m small) if it feels slow. - Windows: works out of the box. Add
[cuda]for an NVIDIA GPU. - WSL: microphone access depends on WSLg audio support and may not work.
Usage
whisper-memo # default model, English
whisper-memo -m small # smaller, faster model
whisper-memo -l auto # detect the spoken language
whisper-memo -d cpu # force CPU even if a GPU is present
whisper-memo --no-clipboard # print only
Press Enter to start recording and Enter again to stop. Ctrl+C quits.
Say "new line" while recording to split the transcript into bullet points:
"Rename the fetch helper to load user, new line, add a test for the empty list case, new line, drop the unused import in the CLI module"
- Rename the fetch helper to load user
- Add a test for the empty list case
- Drop the unused import in the CLI module
| Option | Default | |
|---|---|---|
-m, --model |
large-v3-turbo |
Any faster-whisper model name or a local path. Also read from WHISPER_MODEL. |
-d, --device |
auto |
auto, cuda or cpu. auto uses the GPU when one is available. |
-l, --language |
en |
Language code (de, ja, ...) or auto. |
--no-clipboard |
off | Don't copy transcripts to the clipboard. |
Development
git clone https://github.com/adamhp/whisper-memo
cd whisper-memo
uv run whisper-memo # run from source
uv run --group dev pytest # tests
uv run --group dev ruff check # lint
uv run --group dev ruff format # format
Releasing
- Bump
versioninpyproject.tomland move theUnreleasednotes inCHANGELOG.mdunder the new version. - Commit, then tag and push:
git tag v0.2.0 && git push origin v0.2.0. - The release workflow builds the package, publishes it to PyPI and creates a GitHub release.
License
Metadata
Release files for whisper-memo 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| whisper_memo-0.1.0.tar.gz | 106.2 kB | Without provenance | Details for whisper_memo-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| whisper_memo-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for whisper_memo-0.1.0-py3-none-any.whl |
Total release size: 114.4 kB
Release files / whisper_memo-0.1.0.tar.gz
| Download URL | whisper_memo-0.1.0.tar.gz |
|---|---|
| Size | 106.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
abff332c9ba41aa1dc898eaf6480975526bab55bf896b8e902404995c9f7f48b
|
|
BLAKE2b-256 checksum How to use checksums |
194ce7c87e002f3ebb6c1c02ff48177e4497b7ca30b197f2e803b1c0100b4497
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / whisper_memo-0.1.0-py3-none-any.whl
| Download URL | whisper_memo-0.1.0-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dadc8e75a2ea0b23201822aaa6e517b8acbf0f0c5f78a800cd213d973711d118
|
|
BLAKE2b-256 checksum How to use checksums |
a427c605c27a1881847f31969fdc106ae36b9e3ec1bad340c85b251f11b010fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for whisper-memo 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.