gitwtfhub

wtf is vani?

rahulbhardwaj94/vani — explained in plain English

Analysis updated 2026-05-18

0SwiftAudience · generalComplexity · 3/5LicenseSetup · moderate

TL;DR

A fully offline, private voice dictation app for Apple Silicon Macs that types clean text into any app you use.

Mindmap

mindmap
  root((Vani))
    What it does
      On-device dictation
      Cleans transcript
      Pastes into any app
    Tech stack
      Swift
      WhisperKit
      Ollama
    Use cases
      Private note dictation
      Code mode dictation
      Bilingual speech
    Audience
      Mac users
      Privacy focused 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

Why would anyone build with this?

REASON 1

Dictate emails, notes, or messages into any Mac app without sending audio to the cloud.

REASON 2

Speak code and commands into an editor or terminal using spoken punctuation and casing rules.

REASON 3

Dictate seamlessly in a mix of English and Hindi within the same recording.

REASON 4

Build voice snippets that expand a short spoken phrase into a longer saved block of text.

What's in the stack?

SwiftWhisperKitOllamamacOSCoreML

How it stacks up

rahulbhardwaj94/vaniaiduckman/claudeusage_latest_may2026arnabau/thermalpulse
Stars000
LanguageSwiftSwiftSwift
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencegeneralvibe coderdeveloper

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, Xcode command line tools, and granting microphone and accessibility permissions.

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

Wtf does this do

Vani is a voice dictation app for Mac computers with Apple Silicon chips, meaning newer Macs built around M series processors. You hold down a key, speak, and the words you said appear as clean text wherever you were typing, in any app. Unlike many similar dictation tools, everything happens directly on your own computer. Your voice recording is never sent to a server on the internet, and there is no subscription or account needed. Under the hood, it uses a speech recognition model called Whisper, running through Apple's on-device Neural Engine, to turn your speech into raw text. That raw text then gets cleaned up in two steps: a fast rule-based pass fixes basic punctuation and filler words, and an optional local AI model, run through a tool called Ollama, can further polish the wording. If that second AI step tries to rewrite your meaning instead of just cleaning it up, Vani discards its output and keeps your original words. The final text is then pasted into whatever app you were using. The app supports spoken commands like saying new line or full stop instead of typing them, has a special mode for typing code in editors and terminals that understands things like spoken punctuation for commands, and can switch between English and Hindi within the same sentence. It also keeps a private, searchable history of past dictations, lets you teach it words or names it commonly mishears, and refuses to type into password fields for safety. Setup requires an Apple Silicon Mac running macOS 14 or later, Apple's command line developer tools, and optionally Ollama if you want the AI polish step. It can be installed through Homebrew or built from source using Swift. The project is released under the MIT license. This tool suits Mac users who want a fast, private dictation tool and are comfortable installing developer tools and granting system permissions like microphone and accessibility access.

Yoink these prompts

Prompt 1
Install Vani with Homebrew and walk me through granting it the permissions it needs.
Prompt 2
Explain how Vani's two-stage cleanup and paraphrase guard keep my original wording intact.
Prompt 3
Show me how to use Vani's code mode to dictate a terminal command with correct symbols.
Prompt 4
Help me set up custom vocabulary in Vani so it stops mishearing a specific name.
Prompt 5
Build Vani from source and set up local code signing so my permissions persist across rebuilds.

Frequently asked questions

wtf is vani?

A fully offline, private voice dictation app for Apple Silicon Macs that types clean text into any app you use.

What language is vani written in?

Mainly Swift. The stack also includes Swift, WhisperKit, Ollama.

What license does vani use?

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

How hard is vani to set up?

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

Who is vani for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

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