FluidVoice README

The project's README from github.com/altic-dev/FluidVoice. As one markdown file: README.md.

FluidVoice

GitHub stars Sponsor FluidVoice X @fluidvoiceapp
Supported Models

altic-dev%2FFluidVoice | Trendshift

Open source voice-to-text dictation app for macOS with on-device AI enhancement.

Install with Homebrew: brew install --cask fluidvoice

Manual download: latest release

[!NOTE] FluidVoice is on macOS today. iOS and Windows are on the way — join the waitlist to get notified when we launch: altic.dev/fluid/waitlist

[!IMPORTANT] This project is free and open source under GPLv3. If FluidVoice is useful to you, please star the repository — it helps visibility and keeps development going.

Support FluidVoice

If FluidVoice helps you, you can support continued development and future platform work for iOS and Windows on GitHub Sponsors.

What's New in 1.6.0

[!WARNING] Based on early feedback, Fluid Intelligence may cause you to unsubscribe from other dictation apps and save money. You've been warned.

Fluid Intelligence

FluidVoice is fully open source under GPLv3. Fluid Intelligence is a separate, privately maintained local AI runtime that powers advanced on-device dictation enhancement — smart formatting, context-aware capitalization, and post-processing — all running locally on your Mac.

The app works great on its own with any supported speech model and optional cloud AI providers. Fluid Intelligence adds a fully local, private AI layer for users who want on-device enhancement without sending data anywhere.

We're keeping Fluid Intelligence private for now so we can sustainably offer the core dictation experience for free. This may change in the future.

Fluid Intelligence Sneak Peek

Email Template Flowers
Change Time & Name Emoji
Hyphens & Numbers

Demo

Command Mode — Take any action on your Mac using FluidVoice

https://github.com/user-attachments/assets/ffb47afd-1621-432a-bdca-baa4b8526301

Write Mode — Write or rewrite text in any text box in any app

https://github.com/user-attachments/assets/c57ef6d5-f0a1-4a3f-a121-637533442c24

Features

Supported Models

Model Best for Language support Download size Hardware
Nemotron Speech 3.5 — Ultra Fast Low Latency Streaming-capable multilingual dictation ~40 languages ~670 MB Apple Silicon
Nemotron 3.5 Multilingual Higher-accuracy multilingual dictation ~40 languages ~530 MB Apple Silicon
Parakeet Flash (Beta) Lowest-latency live English dictation English ~250 MB Apple Silicon
Parakeet TDT v3 Fast default multilingual dictation 25 languages ~500 MB Apple Silicon
Parakeet TDT v2 Fastest English-only dictation English ~500 MB Apple Silicon
Cohere Transcribe High-accuracy multilingual dictation 14 languages ~1.4 GB Apple Silicon
Apple Speech Zero-download native macOS speech System languages Built-in Apple Silicon + Intel
Whisper Tiny / Base / Small / Medium / Large Broad compatibility, including Intel Macs 99 languages ~75 MB to ~2.9 GB Apple Silicon + Intel

Parakeet TDT v3 Languages

Bulgarian, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hungarian, Italian, Latvian, Lithuanian, Maltese, Polish, Portuguese, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, and Ukrainian.

Parakeet TDT v2 Languages

English.

Cohere Transcribe Languages

English, French, German, Italian, Spanish, Portuguese, Greek, Dutch, Polish, Mandarin, Japanese, Korean, Vietnamese, and Arabic.

Apple Speech Languages

System language support depends on the macOS speech recognition languages available on your machine.

Whisper Language Support

Whisper supports up to 99 languages, depending on the model size you choose.

Quick Start

  1. Install with Homebrew:

    brew install --cask fluidvoice

    Or download the latest release.

  2. Grant permissions — FluidVoice will ask for microphone and accessibility access. Both are required for dictation and typing into other apps.

  3. Set your hotkey — pick a global hotkey in settings that triggers voice capture from anywhere.

  4. Go through onboarding — choose your voice model based on your language and latency needs. Models range from zero-download Apple Speech to high-accuracy Nemotron and Whisper.

  5. (Optional) Enable Fluid Intelligence — download the local AI model during onboarding for on-device dictation enhancement. Everything runs locally, no data leaves your Mac.

  6. (Optional) Bring your own AI provider — add an OpenAI, Groq, or custom provider API key for cloud-based enhancement. Keys are stored securely in macOS Keychain. Select "Always allow" for key access.

  7. (Optional) Opt in to beta builds — Settings → Automatic Updates → Beta Releases for early access to new features.

Requirements

Building from Source

git clone https://github.com/altic-dev/FluidVoice.git
cd FluidVoice
open Fluid.xcodeproj

Build and run in Xcode. All dependencies are managed via Swift Package Manager.

Run a signed Debug build using the script:

./build.sh

The signed build is written to DerivedData/Build/Products/Debug/FluidVoice Debug.app. Keep launching that product after each rebuild so macOS can preserve its Accessibility authorization.

For CI or contributors who do not have a signing identity, use the explicit unsigned fallback:

./build.sh unsigned

Unsigned builds are tied to a specific executable version and may require Accessibility permission to be removed and granted again after rebuilding.

Contributing

Contributions are welcome! Please create an issue first to discuss major changes before submitting a pull request.

Development Setup

  1. Clone and open in Xcode as above.
  2. Signing: FluidVoice → Signing & Capabilities → Automatically manage signing → pick your Team (Personal Team is fine). If you have certificates for multiple teams, select one without changing the project by running FLUIDVOICE_DEVELOPMENT_TEAM=YOUR_TEAM_ID ./build.sh.
  3. Build and run — SPM handles dependencies.
  4. (Optional) Pre-commit hook to prevent accidental team ID commits:
    cp scripts/check-team-id.sh .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

Pull Request Guidelines

Run Integration Tests

xcodebuild test -project Fluid.xcodeproj -scheme Fluid -destination 'platform=macOS'

CI uses unsigned builds:

xcodebuild test -project Fluid.xcodeproj -scheme Fluid -destination 'platform=macOS' CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO

Privacy & Analytics

FluidVoice is local-first. Your voice, audio, and transcribed text never leave your machine unless you explicitly opt in to a cloud AI provider.

What's Collected

FluidVoice records one anonymous activity signal per local day and uploads the week's buffered signals together after the week ends. Detailed anonymous analytics are enabled by default and can be disabled at any time from Settings → Share Detailed Anonymous Analytics; when disabled, only the weekly activity batch is sent.

Daily activity:

With detailed analytics enabled:

Not Collected:

Community

Join our Discord: https://discord.gg/VUPHaKSvYV

Follow development on X: @fluidvoiceapp

License

From 2026-02-23 onward, this project is licensed under the GNU General Public License, Version 3.0 (GPLv3).

Versions published before this date were licensed under Apache License 2.0.

FluidVoice (altic-dev/FluidVoice)

Searching Database…

12.3K ·GitHub
FluidVoice
Что это такое?FluidVoice — это приложение с открытым исходным кодом для macOS, которое превращает речь в текст. Оно распознаёт речь прямо на устройстве и может улучшать текст с помощью ИИ, являясь локальной альтернативой Wispr Flow.
Это приложение для строки меню или то, что я могу использовать в скриптах?Это нативное приложение для macOS, которое работает из строки меню и с рабочего стола, с глобальной горячей клавишей, оверлеем и интеграцией в строку меню. Это не библиотека и не инструмент командной строки.
Как установить и начать пользоваться?Установите через Homebrew командой 'brew install --cask fluidvoice' или скачайте последний релиз. Затем разрешите доступ к микрофону и универсальному доступу, назначьте глобальную горячую клавишу и выберите голосовую модель во время первоначальной настройки.
Нужен ли мне API-ключ, чтобы пользоваться этим?Нет — базовая диктовка полностью работает офлайн со встроенными моделями, такими как Apple Speech или Whisper. Ключ OpenAI, Groq или собственного сервиса нужен только в том случае, если вы решите включить облачное улучшение текста с помощью ИИ.
Работает ли это на любом Mac или нужен Apple Silicon?Большинство моделей распознавания речи (Nemotron, Parakeet, Cohere) требуют Apple Silicon; Mac с процессором Intel поддерживаются только с моделями Whisper или Apple Speech.
Есть ли версия для iOS или Windows?Пока нет — FluidVoice работает только на macOS. Версии для iOS и Windows запланированы, и можно записаться в лист ожидания, чтобы получить уведомление.
Мой голос или текст когда-нибудь покидают Mac?По умолчанию — нет. Голос, аудио и расшифрованный текст остаются на устройстве, если вы явно не включите облачного провайдера ИИ; отправляется только анонимная статистика использования, которую можно отключить.
Что такое Fluid Intelligence?Это отдельная локальная среда выполнения ИИ, которую поддерживают в частном порядке и которую можно дополнительно установить вместе с приложением. Она выполняет на устройстве форматирование, расстановку заглавных букв и постобработку продиктованного текста, и никакие данные не покидают Mac. Пока её исходный код закрыт, чтобы бесплатное основное приложение можно было поддерживать.
Какие модели распознавания речи можно выбрать?Варианты — от Apple Speech и Whisper, которые не требуют отдельной загрузки (Whisper работает с английским и до 99 языками), до более быстрых моделей только для Apple Silicon: Nemotron Speech 3.5, Parakeet Flash/TDT и Cohere Transcribe. У каждой из них свой набор языков и свой баланс между скоростью отклика и точностью.
Что умеют режим команд и режим записи?Режим команд позволяет управлять Mac голосом: запускать приложения, выполнять быстрые команды и системные действия. Режим записи позволяет диктовать или переписывать текст прямо в любом текстовом поле в любом приложении.
Сколько места на диске занимают модели?Голосовая модель занимает около 1 ГБ, а дополнительная модель для Fluid Intelligence — около 3,5 ГБ.
What are similar projects?parrot, lipflow, remote-mic-app, better-voice, DigUp, speech-swift, mactap-app, SCM
Which topics is it in?dictation, llama-cpp, on-device-ai, voice-assistant, menu-bar, speech-recognition, privacy-first, accessibility, workflow-automation, apple-silicon, swift, offline
Creator
altic-dev
Size
117 MB
Stars
12.3K
Updated
CommitOct 19Releasev1.6.11Oct 12
Age
1y
Commits · 90 Days