MCPcopy Index your code
hub / github.com/OpenWhispr/openwhispr

github.com/OpenWhispr/openwhispr @v1.7.3 sqlite

repository ↗ · DeepWiki ↗ · release v1.7.3 ↗
3,285 symbols 9,196 edges 428 files 50 documented · 2% 21 cross-repo links
README

OpenWhispr

OpenWhispr

License Platform GitHub release Downloads GitHub stars

The open-source and free alternative to WisprFlow and Granola.

Privacy-first voice-to-text dictation with AI agents, meeting transcription, and notes. Cross-platform for macOS, Windows, and Linux.

Website · Docs · Download · API · Changelog


OpenWhispr turns your voice into text, notes, and actions from your desktop. Press a hotkey, speak, and your words appear at your cursor. Choose between fully private offline transcription with local speech-to-text engines like Whisper and NVIDIA Parakeet — where your audio never leaves your device — or cloud processing for speed. No data collection, no telemetry, fully open source.

Download

Platform Download
macOS (Apple Silicon) .dmg
macOS (Intel) .dmg
Windows .exe
Linux .AppImage / .deb / .rpm / .tar.gz

Features

  • Voice dictation — global hotkey to dictate into any app with automatic pasting
  • AI agent — talk to GPT-5, Claude, Gemini, Groq, or local models with a named voice assistant
  • Voice agent hotkey — dedicated hotkey that sends your dictation straight to your AI agent as a command, no wake word needed and no cleanup pass
  • Meeting transcription — auto-detect Zoom, Teams, and FaceTime calls with live speaker diarization, voice fingerprinting, and Google Calendar integration
  • Local speaker diarization — on-device speaker labelling with voice fingerprint recognition across meetings, no cloud required
  • Notes — create, organize, and search notes with folders, semantic search, cloud sync, and AI actions
  • Local or cloud — your choice — all core features (transcription, AI reasoning, speaker diarization, semantic search) work with local models or cloud providers
  • Public API & MCP — manage notes and transcriptions programmatically or connect your AI assistant via the MCP server

Quick start

git clone https://github.com/OpenWhispr/openwhispr.git
cd openwhispr
npm install
npm run dev

Requires Node.js 24+. See the full documentation for setup guides, platform-specific instructions, and build details.

Documentation

Visit docs.openwhispr.com for:

Tech stack

React 19, TypeScript, Tailwind CSS v4, Electron 41, better-sqlite3, whisper.cpp, sherpa-onnx, shadcn/ui

Star History

Star History Chart

Sponsors

  <img width="250" alt="Neon" src="https://neon.com/brand/neon-logo-light-color.svg">

Neon is the serverless Postgres platform powering OpenWhispr Cloud.

Contributing

We welcome contributions. Fork the repo, create a feature branch, and open a pull request. See the contributing guide for development setup and guidelines.

License

MIT — free for personal and commercial use.

Acknowledgments

  • OpenAI Whisper — speech recognition model powering local and cloud transcription
  • whisper.cpp — high-performance C++ implementation for local processing
  • NVIDIA Parakeet — fast multilingual ASR model
  • sherpa-onnx — cross-platform ONNX runtime for Parakeet inference
  • Hugging Face — model hub hosting Whisper, Parakeet, and embedding model weights
  • llama.cpp — local LLM inference for AI text processing
  • Electron — cross-platform desktop framework
  • React — UI component library
  • shadcn/ui — accessible components built on Radix primitives
  • Neon — serverless Postgres powering OpenWhispr Cloud

Extension points exported contracts — how you extend this code

CSSProperties (Interface)
(no doc)
src/vite-env.d.ts
TranscriptionItem (Interface)
(no doc)
src/types/electron.ts
ReferralModalProps (Interface)
(no doc)
src/components/ReferralModal.tsx
ValidationResult (Interface)
(no doc)
src/utils/hotkeyValidator.ts
ConversationItem (Interface)
(no doc)
src/stores/chatStore.ts
DownloadProgress (Interface)
(no doc)
src/helpers/ModelManager.ts
PromptBundle (Interface)
(no doc)
src/locales/prompts.ts
FolderInput (Interface)
(no doc)
src/services/FoldersService.ts

Core symbols most depended-on inside this repo

error
called by 512
src/helpers/debugLogger.js
debug
called by 449
src/helpers/debugLogger.js
log
called by 354
src/helpers/debugLogger.js
warn
called by 217
src/helpers/debugLogger.js
cn
called by 214
src/components/lib/utils.ts
get
called by 175
src/utils/SecureCache.ts
info
called by 148
src/helpers/debugLogger.js
set
called by 119
src/utils/SecureCache.ts

Shape

Method 1,404
Function 1,380
Interface 344
Class 157

Languages

TypeScript100%
Python1%

Modules by API surface

src/helpers/ipcHandlers.js122 symbols
src/helpers/database.js115 symbols
src/helpers/environment.js85 symbols
src/helpers/windowManager.js76 symbols
src/helpers/clipboard.js64 symbols
src/helpers/audioManager.js56 symbols
src/models/ModelRegistry.ts52 symbols
src/types/electron.ts46 symbols
src/helpers/hotkeyManager.js46 symbols
src/helpers/liveSpeakerIdentifier.js42 symbols
src/stores/settingsStore.ts40 symbols
main.js40 symbols

Dependencies from manifests, versioned

@ai-sdk/amazon-bedrock4.0.93 · 1×
@ai-sdk/anthropic3.0.58 · 1×
@ai-sdk/azure3.0.53 · 1×
@ai-sdk/google3.0.43 · 1×
@ai-sdk/google-vertex4.0.108 · 1×
@ai-sdk/groq3.0.29 · 1×
@ai-sdk/openai3.0.41 · 1×
@aws-sdk/credential-providers3.1029.0 · 1×
@electron/notarize3.0.1 · 1×
@eslint/js9.39.4 · 1×
@napi-rs/keyring1.3.0 · 1×
@qdrant/js-client-rest1.12.0 · 1×

For agents

$ claude mcp add openwhispr \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact