explaingit

krishiv-thakuria/openflow

Analysis updated 2026-05-18

4SwiftAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A free, open source Mac menu bar app that turns your held-down-key speech into clean typed text in any app, using Groq for transcription and cleanup.

Mindmap

mindmap
  root((repo))
    What it does
      Voice to text on macOS
      Types into any app
      AI cleanup pass
    Tech stack
      Swift
      AppKit and SwiftUI
      Groq API
    Use cases
      Dictate emails
      Edit selected text
      Hands free commands
    Audience
      Mac 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 emails, chat messages, or documents into any Mac app without typing.

USE CASE 2

Select text and speak an edit, like asking it to sound friendlier or shorter.

USE CASE 3

Use a hands-free wake phrase to trigger voice commands without touching the keyboard.

What is it built with?

SwiftAppKitSwiftUIGroq API

How does it compare?

krishiv-thakuria/openflowanywhere-music-player/codexlimitsaydahnizzy/calendar-drag-interaction
Stars444
LanguageSwiftSwiftSwift
Setup difficultymoderatemoderateeasy
Complexity2/52/52/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a free Groq API key and macOS 14 or later, full Xcode only needed for running tests.

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

In plain English

OpenFlow is a small native app for Mac computers that lets you dictate text with your voice instead of typing. It sits quietly in your menu bar, and while you hold down a key and speak, it turns your words into clean, polished text and types it directly into whatever app you are using, whether that is an email client, a terminal window, or a chat box. When you speak, your audio is sent to a service called Groq for fast transcription, using an AI model called Whisper, followed by a quick cleanup pass. You need to bring your own free Groq account and API key, and OpenFlow says nothing is stored on anyone else's server. It describes itself as an independent, open source take on the idea of system-wide AI dictation. Beyond plain dictation, OpenFlow offers a few extra modes. A hold-to-talk shortcut records only while you hold the key, so a quick accidental tap does not trigger it. A voice assistant mode lets you select some text and speak an edit, such as asking it to sound friendlier, or lets you speak a fresh request when nothing is selected. A command mode reworks text you just produced, and commands can be chained together, so you might ask it to shorten something and then translate it. There is also an optional wake phrase, "Hey Flow," which is detected entirely on your Mac using Apple's built in speech recognition, so no audio leaves your device just for that. The cleanup pass removes filler words like "um" and "uh," fixes self-corrections where you change your mind mid-sentence, adds punctuation, and formats spoken lists, all with a timeout so it never leaves you stuck waiting. OpenFlow also supports spoken snippets that expand into saved text, a personal vocabulary for names and jargon, a floating overlay showing a live waveform, and recognition in over 100 languages. To use it you need a Mac running macOS 14 or later, and a free Groq API key. Building the app from source only requires the Swift toolchain, the full Xcode installation is only needed for running its test suite.

Copy-paste prompts

Prompt 1
Walk me through cloning OpenFlow, adding my Groq API key, and building it with the Swift toolchain.
Prompt 2
Explain how OpenFlow's hold-to-talk and dictate-anywhere shortcuts differ, and when I'd use each.
Prompt 3
Help me set up OpenFlow's wake word 'Hey Flow' so I can trigger command mode hands free.

Frequently asked questions

What is openflow?

A free, open source Mac menu bar app that turns your held-down-key speech into clean typed text in any app, using Groq for transcription and cleanup.

What language is openflow written in?

Mainly Swift. The stack also includes Swift, AppKit, SwiftUI.

What license does openflow use?

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

How hard is openflow to set up?

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

Who is openflow for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.