whatisgithub

What is freestyle?

freestyle-voice/freestyle — explained in plain English

Analysis updated 2026-05-18

112TypeScriptAudience · generalComplexity · 2/5Setup · easy

In one sentence

Freestyle is a desktop dictation app that types out what you say using a hotkey, running locally by default with optional cloud AI transcription providers.

Mindmap

mindmap
  root((Freestyle))
    What it does
      Hotkey dictation
      Local by default
    Tech stack
      TypeScript
      Desktop app
    Use cases
      Fast typing by voice
      Email formatting
    Audience
      General users

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 into any application by holding a hotkey and speaking

USE CASE 2

Automatically remove filler words and fix punctuation after transcription

USE CASE 3

Set custom phrase substitutions for words that transcribe incorrectly

USE CASE 4

Get context aware formatting, like email style output when dictating into an email field

What is it built with?

TypeScript

How does it compare?

freestyle-voice/freestylejoeseesun/qiaomu-artist-styleamanayayatu-tech/alaya
Stars112112113
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencegeneraldesignerpm founder

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Works out of the box locally, connecting external AI providers requires your own API key.

FSL-1.1-ALv2 is a non-standard license, the explanation does not summarize its exact terms.

So what is it?

Freestyle is a desktop dictation app for macOS, Windows, and Linux. The basic interaction is simple: hold a hotkey, say what you want to type, and release. The transcribed text appears wherever your cursor is, as if you had typed it. The README describes this as speaking four times faster than typing. The app is designed to run locally, meaning your audio is processed on your own device and never sent to a third-party server without your explicit choice. That said, you can optionally connect it to external AI services by providing your own API key. Supported providers include OpenAI, Groq, Anthropic, Google, Deepgram, and ElevenLabs, giving you control over which transcription model handles your audio. Beyond basic transcription, the app includes a few cleanup features. One removes filler words and fixes punctuation automatically after transcription. Another lets you define custom phrase substitutions, so if you frequently say something that gets transcribed incorrectly or in the wrong format, you can set a replacement rule. A third feature reformats your text based on context, so dictating into an email field produces email-formatted output rather than raw prose. The project is available as a downloadable installer for each platform and is open to contributions through its GitHub repository. The license used is FSL-1.1-ALv2, which is a non-standard license, the README links to the full text but does not summarize its terms.

Copy-paste prompts

Prompt 1
Help me set up Freestyle to use my own Anthropic or OpenAI API key for transcription
Prompt 2
Explain the difference between running this locally and connecting an external AI provider
Prompt 3
Show me how to create a custom phrase substitution rule
Prompt 4
Which supported transcription provider is best for accuracy versus privacy?

Frequently asked questions

What is freestyle?

Freestyle is a desktop dictation app that types out what you say using a hotkey, running locally by default with optional cloud AI transcription providers.

What language is freestyle written in?

Mainly TypeScript. The stack also includes TypeScript.

What license does freestyle use?

FSL-1.1-ALv2 is a non-standard license, the explanation does not summarize its exact terms.

How hard is freestyle to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is freestyle for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.