whatisgithub

What is wispr-clone?

twinlights/wispr-clone — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

An offline, push-to-talk voice dictation tool for Kali Linux that types out speech using local Whisper transcription while a key combo is held down.

Mindmap

mindmap
  root((repo))
    What it does
      Push to talk dictation
      Offline speech to text
      Types into focused window
    Tech stack
      Python
      faster-whisper
      Ollama optional
    Use cases
      Dictate text hands free
      Work fully offline
      Autostart on login
    Audience
      Linux users
      Developers

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 build with it?

USE CASE 1

Dictate text hands free into any application by holding a two-key combo and speaking.

USE CASE 2

Transcribe speech fully offline without sending audio to any cloud service.

USE CASE 3

Clean up dictated text's punctuation and sentence structure using a local Ollama model.

USE CASE 4

Set the tool to start automatically in the background whenever you log into Kali Linux.

What is it built with?

Pythonfaster-whisperTkinterOllama

How does it compare?

twinlights/wispr-clone0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Kali Linux with X11 (not Wayland) and downloading Whisper models while still online.

So what is it?

Wispr-clone is a dictation tool for Kali Linux that turns your voice into typed text, working completely offline and modeled after a commercial product called Wisprflow. You hold down two keys together, speak, and let go, and the tool types out what you said into whatever window has focus, without ever sending audio over the internet. The hold to talk gesture is deliberate: recording starts the moment both configured keys are pressed at the same time and stops the instant either one is released, rather than working like a toggle you press once to start and once to stop. The default combination uses the Windows key and AltGr specifically because those keys are almost never triggered by normal typing, which keeps the tool from firing by accident. Speech to text happens locally using a tool called faster-whisper, which understands both English and Dutch or Flemish and figures out which language you are speaking automatically. Whisper's own output already strips out filler words like "uh" and stutters. On top of that, an optional local step using Ollama, a tool for running small AI chat models on your own machine, can add proper punctuation, capitalization, and sentence structure, though it never translates the text and the tool still works fine without it if it is turned off or unreachable. The interface is a small oval widget built with Tkinter, using only a few megabytes of memory rather than a full browser based interface. The project includes an install script for Kali Linux running the X11 display system, a script to download and cache all supported Whisper model sizes ahead of time so the tool never needs the internet again once set up, and an optional background service that starts the tool automatically when you log in. The README does not state a license for this project.

Copy-paste prompts

Prompt 1
Help me install wispr-clone on Kali Linux and pre-download the Whisper models before I go offline.
Prompt 2
Configure wispr-clone's hotkey to use Ctrl and Shift instead of the default Win and AltGr combo.
Prompt 3
Set up wispr-clone as a systemd user service so it autostarts when I log in.
Prompt 4
Explain how wispr-clone's optional Ollama cleanup pass works and how to disable it.

Frequently asked questions

What is wispr-clone?

An offline, push-to-talk voice dictation tool for Kali Linux that types out speech using local Whisper transcription while a key combo is held down.

What language is wispr-clone written in?

Mainly Python. The stack also includes Python, faster-whisper, Tkinter.

How hard is wispr-clone to set up?

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

Who is wispr-clone for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.