Skip to content

alexjiaguo/freeflow

 
 

Repository files navigation

FreeFlow icon

FreeFlow

Free and open source alternative to Wispr Flow, Superwhisper, and Monologue.

⬇ Download FreeFlow.dmg
Works on all Macs (Apple Silicon + Intel)


FreeFlow demo

Thank you to @marcbodea for maintaining FreeFlow!

Overview

FreeFlow is a free Mac dictation app inspired by Wispr Flow, Superwhisper, and Monologue. It gives you fast AI transcription, context-aware cleanup, and voice-driven text editing without a monthly subscription.

Quick Start

  1. Download the app from above or click here
  2. Get a free Groq API key from groq.com
  3. Hold Fn to talk, or tap Command-Fn to start and stop dictation, and have whatever you say pasted into the current text field

Features

  • Custom shortcuts: Customize both hold-to-talk and toggle dictation shortcuts. If your toggle shortcut extends your hold shortcut, you can start in hold mode and press the extra modifier keys to latch into tap mode without stopping the recording.
  • Context-aware cleanup: FreeFlow can read nearby app context so names, terms, and phrases are spelled correctly when you dictate into email, terminals, docs, and other apps.
  • Custom vocabulary: Add names, jargon, and project-specific words that FreeFlow should preserve during cleanup.
  • OpenAI-compatible providers: Use Groq by default, or configure a custom model and API URL in settings.

Edit Mode

Edit Mode lets you highlight existing text and transform it with a spoken instruction, like "make this shorter" or "turn this into bullets." Enable it in settings, then use your normal dictation shortcut on selected text, or choose Manual mode to require an extra modifier key.

Privacy

There is no FreeFlow server, so FreeFlow does not store or retain your data. The only information that leaves your computer are API calls to your configured transcription and LLM provider.

Custom Cleanup

If you'd rather keep cleanup more literal and less context-aware, you can paste this simpler prompt into the custom system prompt setting:

Simple post-processing prompt
You are a dictation post-processor. You receive raw speech-to-text output and return clean text ready to be typed into an application.

Your job:
- Remove filler words (um, uh, you know, like) unless they carry meaning.
- Fix spelling, grammar, and punctuation errors.
- When the transcript already contains a word that is a close misspelling of a name or term from the context or custom vocabulary, correct the spelling. Never insert names or terms from context that the speaker did not say.
- Preserve the speaker's intent, tone, and meaning exactly.

Output rules:
- Return ONLY the cleaned transcript text, nothing else. So NEVER output words like "Here is the cleaned transcript text:"
- If the transcription is empty, return exactly: EMPTY
- Do not add words, names, or content that are not in the transcription. The context is only for correcting spelling of words already spoken.
- Do not change the meaning of what was said.

Example:
RAW_TRANSCRIPTION: "hey um so i just wanted to like follow up on the meating from yesterday i think we should definately move the dedline to next friday becuz the desine team still needs more time to finish the mock ups and um yeah let me know if that works for you ok thanks"

Then your response would be ONLY the cleaned up text, so here your response is ONLY:
"Hey, I just wanted to follow up on the meeting from yesterday. I think we should definitely move the deadline to next Friday because the design team still needs more time to finish the mockups. Let me know if that works for you. Thanks."

FAQ

Why does this use Groq instead of a local transcription model?

I love this idea, and originally planned to build FreeFlow using local models, but to have post-processing (that's where you get correctly spelled names when replying to emails / etc), you need to have a local LLM too.

If you do that, the total pipeline takes too long for the UX to be good (5-10 seconds per transcription instead of <1s). I also had concerns around battery life.

Some day!

Update: You can now use a custom model with FreeFlow by configuring the LLM API URL in the FreeFlow settings to use Ollama. Thank you @taciturnaxolotl!

License

Licensed under the MIT license.

About

Free and open source alternative to Wispr Flow / Superwhisper / Monologue / etc

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Swift 93.4%
  • HTML 5.5%
  • Other 1.1%