# FluidVoice | ALTIC | Knowledge Base | Instagit

FluidVoice - Fastest macOS Offline Dictation app - Voice to Text fully Local. One ⭐ takes us a long way :)) 

GitHub Stars: 4.3k

Repository: https://github.com/altic-dev/FluidVoice

---

## Articles

### [How to Fine-Tune FluidVoice Models for Specific Needs: A Complete Guide to Custom Prompts and LLM Configuration](/altic-dev/FluidVoice/how-can-i-fine-tune-fluidvoice-models-for-specific-needs)

Fine-tune FluidVoice models easily. Customize dictation prompts in SettingsStore Swift and configure LLMClient Config parameters for tailored model behavior without retraining weights. Learn how today.

- Tags: how-to-guide
- Published: 2026-08-16

### [FluidVoice Security Considerations: A Deep Dive into macOS Keychain, TLS, and Privacy Protections](/altic-dev/FluidVoice/what-are-the-security-considerations-for-fluidvoice)

Explore FluidVoice security: Learn how it protects your data using macOS Keychain, TLS, and privacy controls. Discover our commitment to safeguarding your information.

- Tags: deep-dive
- Published: 2026-08-16

### [Does FluidVoice Support Real-Time Speech Synthesis?](/altic-dev/FluidVoice/does-fluidvoice-support-real-time-speech-synthesis)

FluidVoice does not support real-time speech synthesis. It focuses solely on real-time speech-to-text dictation and transcription for efficient audio processing.

- Tags: faq
- Published: 2026-08-16

### [FluidVoice Development Roadmap: Platform Expansion, UI Automation, and AI Features](/altic-dev/FluidVoice/what-is-the-roadmap-for-fluidvoice-development)

Explore the FluidVoice development roadmap. Discover platform expansion to iOS and Windows, UI automation for macOS stability, and advanced on-device AI features.

- Tags: architecture
- Published: 2026-08-16

### [How FluidVoice Handles Different Languages: A Complete Technical Guide](/altic-dev/FluidVoice/how-does-fluidvoice-handle-different-languages)

Discover how FluidVoice handles different languages technically. Learn about VoiceEngineLanguageCatalog, model routing, and pipeline application for multilingual speech recognition.

- Tags: technical-guide
- Published: 2026-08-16

### [FluidVoice Limitations and Known Issues: A Complete Technical Guide](/altic-dev/FluidVoice/are-there-any-limitations-or-known-issues-with-fluidvoice)

Explore FluidVoice limitations and known issues including hardware requirements, large downloads, and system permissions. Understand the constraints for macOS users.

- Tags: technical-guide
- Published: 2026-08-16

### [What Kind of Data Does FluidVoice Use for Training?](/altic-dev/FluidVoice/what-kind-of-data-does-fluidvoice-use-for-training)

FluidVoice trains on user voice recordings paired with target text for accurate speech recognition. Learn what data fuels its custom dictionary training.

- Tags: internals
- Published: 2026-08-16

### [How to Contribute to the FluidVoice Project: A Complete Guide for Open-Source Contributors](/altic-dev/FluidVoice/how-can-i-contribute-to-the-fluidvoice-project)

Learn how to contribute to the FluidVoice project. Follow our guide to fork the repo, run tests, implement changes, and submit a pull request to join our open-source community.

- Tags: how-to-guide
- Published: 2026-08-16

### [FluidVoice System Requirements: macOS Version, Hardware, and Disk Space Guide](/altic-dev/FluidVoice/what-are-the-system-requirements-for-running-fluidvoice)

Discover FluidVoice system requirements including macOS version, Apple Silicon or Intel Mac compatibility, disk space needs, and essential permissions. Optimize your setup now.

- Tags: guide
- Published: 2026-08-16

### [Is FluidVoice Open-Source? License, Source Code, and Usage Rights Explained](/altic-dev/FluidVoice/is-fluidvoice-open-source-and-what-is-its-license)

Is FluidVoice open-source? Discover its GPL-3.0 license, access the source code at altic-dev/FluidVoice, and understand your usage rights. Modify and share freely.

- Tags: faq
- Published: 2026-08-16

### [FluidVoice Deployment Options: 3 Ways to Install on macOS](/altic-dev/FluidVoice/what-are-the-deployment-options-for-fluidvoice)

Explore FluidVoice deployment options on macOS: install via Homebrew cask, download from GitHub, or build from source. Choose the best method for your needs.

- Tags: deployment-options
- Published: 2026-08-16

### [FluidVoice API Endpoints: Complete Guide to the Local HTTP Interface](/altic-dev/FluidVoice/are-there-any-api-endpoints-for-fluidvoice)

Explore FluidVoice API endpoints for local HTTP transcription, dictionary management, and post-processing. Access six powerful JSON endpoints on 127.0.0.1:47733.

- Tags: api-reference
- Published: 2026-08-16

### [How to Set Up a Local Instance of FluidVoice: Complete macOS Development Guide](/altic-dev/FluidVoice/how-can-i-set-up-a-local-instance-of-fluidvoice)

Learn to set up a local FluidVoice instance on macOS. Clone the repo, build in Xcode, and grant permissions for real-time dictation with this complete guide.

- Tags: how-to-guide
- Published: 2026-08-16

### [FluidVoice Performance Characteristics: Low-Latency Streaming Architecture Explained](/altic-dev/FluidVoice/what-are-the-performance-characteristics-of-fluidvoice)

Explore FluidVoice performance characteristics, including sub-30ms latency and under 20% CPU usage on Apple Silicon. Discover our low-latency streaming architecture.

- Tags: performance
- Published: 2026-08-16

### [FluidVoice Voice Options and Customization: A Complete Guide to Engine Selection and Personalization](/altic-dev/FluidVoice/does-fluidvoice-offer-different-voice-options-or-customization)

Explore FluidVoice voice options and customization. Select engines like Parakeet TDT, Whisper, and Apple Speech, and personalize with custom dictionaries and voice-matching.

- Tags: how-to-guide
- Published: 2026-08-16

### [FluidVoice Voice Quality vs. TTS Solutions: A Complete Technical Comparison](/altic-dev/FluidVoice/how-is-the-voice-quality-of-fluidvoice-compared-to-other-tts-solutions)

Compare FluidVoice transcription accuracy to TTS solutions. Discover how on-device models elevate your speech dictation experience beyond traditional text-to-speech.

- Tags: performance
- Published: 2026-08-16

### [What Programming Languages and Frameworks Does FluidVoice Support?](/altic-dev/FluidVoice/what-programming-languages-or-frameworks-does-fluidvoice-support)

FluidVoice supports Swift and SwiftUI on macOS. Explore its use of Combine, CoreAudio, AVFoundation and 99 languages for advanced dictation.

- Tags: faq
- Published: 2026-08-16

### [Can FluidVoice Be Integrated with Existing Applications?](/altic-dev/FluidVoice/can-fluidvoice-be-integrated-with-existing-applications)

Integrate FluidVoice with existing macOS apps effortlessly using the Accessibility API. No plugins, SDKs, or code changes needed. Enhance your workflow today.

- Tags: how-to-guide
- Published: 2026-08-16

### [FluidVoice Architecture: A Deep Dive Into Its Core Components and Modular Design](/altic-dev/FluidVoice/what-are-the-core-components-of-the-fluidvoice-architecture)

Explore the FluidVoice architecture and its core components. Discover how its modular macOS design ensures independent testing and easy extension of UI, audio capture, speech-to-text, LLM, and services.

- Tags: deep-dive
- Published: 2026-08-16

### [How FluidVoice Handles Text-to-Speech Generation: A Deep Dive into the Swift Implementation](/altic-dev/FluidVoice/how-does-fluidvoice-handle-text-to-speech-generation)

FluidVoice handles text-to-speech generation by integrating Apple's AVSpeechSynthesizer and offering a streaming path via FluidAudioProvider. Explore the Swift implementation.

- Tags: deep-dive
- Published: 2026-08-16

### [What Is FluidVoice and What Problem Does It Solves? A Deep Dive into the Open‑Source macOS Dictation Platform](/altic-dev/FluidVoice/what-is-fluidvoice-and-what-problem-does-it-solve)

Discover FluidVoice, the open-source macOS dictation tool replacing cloud services with local, private speech recognition. Enjoy on-device models and optional AI enhancement.

- Tags: deep-dive
- Published: 2026-08-16

### [How to Access FluidVoice Settings: The Complete Developer Guide](/altic-dev/FluidVoice/how-to-access-fluidvoice-settings)

Access FluidVoice settings easily. Learn how FluidVoice stores, persists, and updates its settings for seamless developer integration in your macOS apps. Get the complete guide now.

- Tags: how-to-guide
- Published: 2026-08-14

### [FluidVoice Parakeet Models: A Complete Guide to TDT v3, TDT v2, and Flash ASR Options](/altic-dev/FluidVoice/what-are-the-different-parakeet-models-supported-by-fluidvoice)

Explore FluidVoice Parakeet models: TDT v3, TDT v2, and Flash ASR. Discover the best speech recognition for your transcription needs on Apple Silicon.

- Tags: deep-dive
- Published: 2026-08-14

### [How to Select an Audio Input Device in Fluid Voice: A Complete Technical Guide](/altic-dev/FluidVoice/how-to-select-an-audio-input-device-in-fluidvoice)

Learn how to select an audio input device in Fluid Voice. This guide covers device enumeration, user selection binding, and applying your choice for seamless audio capture.

- Tags: how-to-guide
- Published: 2026-08-14

### [How FluidVoice Displays Its Status in the Menu Bar](/altic-dev/FluidVoice/how-does-fluidvoice-display-its-status-in-the-menu-bar)

Learn how FluidVoice displays its status in the menu bar using NSStatusItem and MenuBarManager to show real-time dictation updates and pipeline state changes.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Integrate FluidVoice with System-Wide Hotkeys: A Complete Implementation Guide](/altic-dev/FluidVoice/how-to-integrate-fluidvoice-with-system-wide-hotkeys)

Learn how to integrate FluidVoice with system-wide hotkeys. Implement global shortcuts effectively using the GlobalHotkeyManager and CGEvent tap for seamless control.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Use a Custom Transcription Provider in FluidVoice: A Complete Implementation Guide](/altic-dev/FluidVoice/how-to-use-a-custom-transcription-provider-in-fluidvoice)

Integrate your custom transcription provider into FluidVoice. This guide shows you how to create a Swift class, register it, and select it for seamless voice processing.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Are the Key Services in FluidVoice? A Complete Guide to the Architecture](/altic-dev/FluidVoice/what-are-the-key-services-in-fluidvoice)

Explore FluidVoice's 15 key services for speech recognition, speaker diarization, media control, AI, and automation. Understand the architecture via the centralized AppServices registry.

- Tags: architecture
- Published: 2026-08-14

### [How FluidVoice Communicates with Cloud AI Providers: Architecture Deep Dive](/altic-dev/FluidVoice/how-does-fluidvoice-communicate-with-cloud-ai-providers)

Discover how FluidVoice's layered architecture communicates with cloud AI providers. Learn about LLMClient, AIProvider protocol, and OpenAICompatibleProvider for seamless integration.

- Tags: architecture
- Published: 2026-08-14

### [How FluidVoice Performs Post‑Processing on Transcriptions: A Complete Technical Guide](/altic-dev/FluidVoice/how-does-fluidvoice-perform-post-processing-on-transcriptions)

Explore FluidVoice post-processing techniques for transcriptions in this technical guide. Optimize your audio data with advanced methods from altic-dev/FluidVoice.

- Tags: deep-dive
- Published: 2026-08-14

### [How FluidVoice Handles Fallback Text Insertion: A Complete Technical Breakdown](/altic-dev/FluidVoice/how-does-fluidvoice-handle-fallback-text-insertion)

Discover how FluidVoice ensures reliable text insertion across macOS apps with its four-tier fallback pipeline. Learn about CGEvent injection, clipboard paste, and accessibility keystrokes.

- Tags: deep-dive
- Published: 2026-08-14

### [Text Insertion Modes in FluidVoice: A Complete Guide to Clipboard‑Free vs. Clipboard Paste](/altic-dev/FluidVoice/what-are-the-text-insertion-modes-in-fluidvoice)

Explore FluidVoice text insertion modes: Clipboard Free Insert for speed and reliablePaste for wider app compatibility. Learn how to choose the best method for your needs.

- Tags: how-to-guide
- Published: 2026-08-14

### [What APIs Does FluidVoice Use for Text Insertion? A Complete Technical Breakdown](/altic-dev/FluidVoice/what-apis-does-fluidvoice-use-for-text-insertion)

Explore the seven-layer fallback pipeline of macOS APIs FluidVoice employs for text insertion. Discover efficient Unicode injection and reliable clipboard paste operations in this technical breakdown.

- Tags: api-reference
- Published: 2026-08-14

### [How FluidVoice Inserts Transcribed Text Into Other Applications: A Deep Dive Into the macOS Typing Pipeline](/altic-dev/FluidVoice/how-does-fluidvoice-insert-transcribed-text-into-other-applications)

FluidVoice inserts transcribed text into apps via a macOS typing pipeline. Discover its multi-stage process that prioritizes reliable methods and falls back when necessary.

- Tags: deep-dive
- Published: 2026-08-14

### [How FluidVoice Handles Threading for Audio Processing: A Complete Architecture Breakdown](/altic-dev/FluidVoice/how-does-fluidvoice-handle-threading-for-audio-processing)

Discover how FluidVoice manages audio processing threading. Learn how dedicated dispatch queues prevent UI blocking and ensure safe audio object lifetimes for real-time performance.

- Tags: architecture
- Published: 2026-08-14

### [How FluidVoice Downloads and Caches ASR Models: A Complete Technical Breakdown](/altic-dev/FluidVoice/how-are-asr-models-downloaded-and-cached-in-fluidvoice)

Discover how FluidVoice downloads and caches ASR models with a detailed technical breakdown. Learn about the two-layer architecture for efficient offline ASR.

- Tags: deep-dive
- Published: 2026-08-14

### [How FluidVoice Implements the TranscriptionProvider Protocol for Pluggable Speech Recognition](/altic-dev/FluidVoice/how-does-fluidvoice-implement-transcriptionprovider-protocol)

FluidVoice uses the TranscriptionProvider protocol to integrate pluggable speech recognition, supporting Whisper GGUF and Apple's native APIs for flexible backends.

- Tags: deep-dive
- Published: 2026-08-14

### [How to Switch ASR Providers in FluidVoice: A Complete Guide](/altic-dev/FluidVoice/how-to-switch-between-different-asr-providers-in-fluidvoice)

Easily switch ASR providers in FluidVoice, from OpenAI Whisper to Qwen 3. Learn how to manage speech-to-text engines with our complete guide.

- Tags: how-to-guide
- Published: 2026-08-14

### [Can FluidVoice Use Local ASR Models Without an Internet Connection?](/altic-dev/FluidVoice/can-fluidvoice-use-local-asr-models-without-internet-connection)

Yes FluidVoice runs speech-to-text offline. Use local Whisper models without an internet connection. Learn how to configure it now.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Speech Models Does FluidVoice Support? A Complete Technical Guide](/altic-dev/FluidVoice/what-speech-models-does-fluidvoice-support)

Explore FluidVoice's comprehensive speech model support. Discover 15 models across FluidAudio, Apple Native, and Whisper families for advanced ASR.

- Tags: deep-dive
- Published: 2026-08-14

### [How to Set Up FluidVoice for macOS: Complete Installation and Configuration Guide](/altic-dev/FluidVoice/how-to-set-up-fluidvoice-for-macos)

Learn how to set up FluidVoice for macOS with our complete guide. Install via Homebrew or manually, grant permissions, and configure hotkeys for efficient voice dictation.

- Tags: how-to-guide
- Published: 2026-08-14

### [How FluidVoice Handles Text Insertion into Applications via Accessibility APIs Using TypingService](/altic-dev/FluidVoice/how-fluidvoice-text-insertion-accessibility-apis-typingservice)

FluidVoice TypingService reliably inserts text into macOS apps using Accessibility APIs and six fallback strategies ensuring seamless integration.

- Tags: how-to-guide
- Published: 2026-07-09

### [How to Implement Transcription Post-Processing Using FluidVoice's DictationPostProcessingService](/altic-dev/FluidVoice/how-implement-transcription-post-processing-dictationpostprocessingservice)

Implement transcription post-processing with FluidVoice's DictationPostProcessingService. Route raw transcripts through LLMs like OpenAI for refined text output.

- Tags: how-to-guide
- Published: 2026-07-09

### [How to Implement Custom Vocabulary and Word Boosting with ParakeetProvider in FluidVoice](/altic-dev/FluidVoice/how-implement-custom-vocabulary-word-boosting-parakeetprovider)

Implement custom vocabulary and word boosting in FluidVoice using ParakeetProvider. Persist boost terms, enable settings, and inject tokens into the transcription pipeline for enhanced accuracy.

- Tags: how-to-guide
- Published: 2026-07-09

### [How FluidVoice Command Mode Executes Terminal Commands from Voice Input](/altic-dev/FluidVoice/how-fluidvoice-command-mode-execute-terminal-commands-voice)

Learn how FluidVoice Command Mode executes terminal commands with voice input. It transcribes speech, uses an LLM to validate and execute, and verifies zsh subprocess commands.

- Tags: how-to-guide
- Published: 2026-07-09

### [How to Add Custom API Providers Like OpenAI and Groq for AI Enhancement in FluidVoice](/altic-dev/FluidVoice/how-add-custom-api-providers-openai-groq-fluidvoice)

Easily add custom API providers like OpenAI and Groq to FluidVoice for AI enhancement. Configure your preferred service via URL and API key in the UI for seamless integration.

- Tags: how-to-guide
- Published: 2026-07-09

### [Release Cycle for FluidVoice: How Feature-Driven Updates Work](/altic-dev/FluidVoice/what-is-the-release-cycle-for-fluidvoice)

Discover FluidVoice's feature-driven release cycle. Learn how semantic-versioned Git tags automate updates via GitHub Actions for timely new versions.

- Tags: how-to-guide
- Published: 2026-07-08

### [How to Handle Configuration Changes in FluidVoice: A Complete Guide to SettingsStore](/altic-dev/FluidVoice/how-to-handle-configuration-changes-in-fluidvoice)

Learn to manage configuration changes in FluidVoice using SettingsStore. This guide explains type-safe access, ObservableObject publishing, and NotificationCenter broadcasting for seamless UI updates.

- Tags: how-to-guide
- Published: 2026-07-08

### [What Swift Version Does FluidVoice Use?](/altic-dev/FluidVoice/what-version-of-swift-does-fluidvoice-use)

Discover the Swift version FluidVoice uses. altic-dev/FluidVoice requires Swift 5.9 as specified in its Package.swift file. Learn more now.

- Tags: getting-started
- Published: 2026-07-08

### [How to Customize UI Elements in FluidVoice: A Complete SwiftUI Theming Guide](/altic-dev/FluidVoice/how-to-customize-ui-elements-in-fluidvoice)

Customize UI elements in FluidVoice by editing ThemePalette for global changes or individual SwiftUI views for component overrides. Follow this comprehensive theming guide.

- Tags: tutorial
- Published: 2026-07-08

### [What Functionalities Do the Core Services Provide in FluidVoice? A Complete Architecture Guide](/altic-dev/FluidVoice/what-functionalities-do-the-core-services-provide-in-fluidvoice)

Explore FluidVoice core services functionalities like ASR, voice commands, transcription management, and more. Learn about their architecture and lightweight service classes for SwiftUI.

- Tags: architecture
- Published: 2026-07-08

### [How to Manage State in FluidVoice: A Complete Guide to SwiftUI Architecture](/altic-dev/FluidVoice/how-to-manage-state-in-fluidvoice)

Master FluidVoice state management with singletons like SettingsStore AppServices and MenuBarManager Discover efficient SwiftUI architecture for your app

- Tags: how-to-guide
- Published: 2026-07-08

### [How to Debug the FluidVoice Application: A Complete Guide for macOS Developers](/altic-dev/FluidVoice/how-to-debug-fluidvoice-application)

Debug FluidVoice on macOS with ease. Learn to enable logs instrument key subsystems and monitor real-time output to pinpoint audio transcription or AI processing issues.

- Tags: how-to-guide
- Published: 2026-07-08

### [How to Access Application Settings in FluidVoice: Complete Guide to SettingsStore](/altic-dev/FluidVoice/how-to-access-application-settings-in-fluidvoice)

Learn how to access application settings in FluidVoice using the SettingsStore. This guide explains how SwiftUI views subscribe to changes and persist data effortlessly.

- Tags: how-to-guide
- Published: 2026-07-08

### [What Programming Language Is Used for FluidVoice? A Deep Dive into the Swift-Based Codebase](/altic-dev/FluidVoice/what-programming-language-is-used-for-fluidvoice)

Discover the programming language behind FluidVoice. This article explores the Swift and SwiftUI codebase, revealing how Swift powers its modern macOS interface and CoreAudio integration.

- Tags: deep-dive
- Published: 2026-07-08

### [Can FluidVoice Be Used on Other Apple Platforms? macOS Compatibility and Roadmap](/altic-dev/FluidVoice/can-fluidvoice-be-used-on-other-apple-platforms)

Explore FluidVoice macOS compatibility and roadmap. Discover its current limitations and planned support for other Apple platforms in this technical overview.

- Tags: compatibility
- Published: 2026-07-08

### [How FluidVoice SettingsStore Works: Complete Technical Guide](/altic-dev/FluidVoice/how-does-the-settingsstore-work-in-fluidvoice)

Explore the technical guide to FluidVoice's SettingsStore. Learn how this observable singleton manages app state with UserDefaults, Keychain, and SwiftUI for reactive updates.

- Tags: technical-guide
- Published: 2026-07-08

### [Where Is the Main UI Code Located in FluidVoice? A Complete SwiftUI Architecture Guide](/altic-dev/FluidVoice/where-is-the-main-ui-code-located-in-fluidvoice)

Discover the main UI code location in FluidVoice. Explore the SwiftUI architecture and find the application entry point in Sources/Fluid/fluidApp.swift and ContentView.swift.

- Tags: architecture
- Published: 2026-07-08

### [FluidVoice Architecture: A Deep Dive into the macOS Dictation App's Modular Design](/altic-dev/FluidVoice/what-is-the-architecture-of-fluidvoice)

Explore the FluidVoice architecture, a modular macOS dictation app. Discover its clean separation of concerns, interchangeable components, and real-time AI-enhanced speech processing.

- Tags: architecture
- Published: 2026-07-08

### [How to Set Up FluidVoice on macOS: Complete Installation and Configuration Guide](/altic-dev/FluidVoice/how-to-set-up-fluidvoice-on-macos)

Learn how to set up FluidVoice on macOS. Install via Homebrew, grant permissions, and configure settings for local voice dictation.

- Tags: how-to-guide
- Published: 2026-07-08

### [Which Swift Actor Serializes CoreML Operations in FluidVoice?](/altic-dev/FluidVoice/which-swift-actor-is-used-to-serialize-coreml-operations-in-fluidvoice)

Discover how the TranscriptionExecutor Swift actor in FluidVoice serializes CoreML operations, preventing race conditions and ensuring smooth performance. Learn more now.

- Tags: internals
- Published: 2026-07-07

### [What Programming Language Powers FluidVoice? Swift Development Explained](/altic-dev/FluidVoice/what-is-the-primary-programming-language-used-for-fluidvoice-development)

Discover how Swift powers FluidVoice. Learn about Swift development, SwiftUI interfaces, and CoreAudio integration in this in-depth technical explanation.

- Tags: deep-dive
- Published: 2026-07-07

### [How the AudioCapturePipeline Processes Incoming Audio Samples Asynchronously in FluidVoice](/altic-dev/FluidVoice/how-does-the-audiocapturepipeline-process-incoming-audio-samples-asynchronously)

FluidVoice's AudioCapturePipeline processes audio samples asynchronously, avoiding main thread blockages. Learn how it handles real-time audio processing efficiently.

- Tags: internals
- Published: 2026-07-07

### [How FluidVoice Manages Custom Dictation Prompts: From Legacy Strings to Profile Collections](/altic-dev/FluidVoice/how-are-custom-dictation-prompts-managed-in-fluidvoice)

Discover how FluidVoice expertly manages custom dictation prompts by migrating legacy strings to structured profile collections. Learn about backward compatibility and multi-profile support for seamless integration in your proj...

- Tags: internals
- Published: 2026-07-07

### [How AppleSpeechProvider Works in FluidVoice: Architecture, Implementation, and Advantages](/altic-dev/FluidVoice/how-does-applespeechprovider-work-in-fluidvoice-and-what-are-its-advantages)

Explore how AppleSpeechProvider works in FluidVoice. Learn its architecture implementing SFSpeechRecognizer for fast, zero-download speech transcription on macOS 10.15+.

- Tags: architecture
- Published: 2026-07-07

### [NemotronProvider in FluidVoice: Features, Implementation, and Usage Guide](/altic-dev/FluidVoice/what-are-the-features-of-nemotronprovider-in-fluidvoice)

Explore NemotronProvider in FluidVoice. Get high-accuracy offline and ultra-low-latency streaming speech recognition exclusively on Apple Silicon for NVIDIA Nemotron 3.5 models.

- Tags: how-to-guide
- Published: 2026-07-07

### [Is FluidVoice Compatible with Intel Macs? Architecture Detection and Whisper Implementation](/altic-dev/FluidVoice/is-fluidvoice-compatible-with-intel-macs-and-how)

FluidVoice runs natively on Intel Macs! Learn how it detects architecture and implements Whisper for seamless transcription by disabling Apple Silicon features.

- Tags: architecture
- Published: 2026-07-07

### [How WhisperProvider in FluidVoice Works: On-Device Speech Recognition with whisper.cpp](/altic-dev/FluidVoice/how-does-the-whisperprovider-in-fluidvoice-work-and-what-models-does-it-support)

Explore how FluidVoice's WhisperProvider enables on-device speech recognition for Intel Macs using whisper.cpp. Discover support for six Whisper models with automatic downloads and safe loading.

- Tags: internals
- Published: 2026-07-07

### [What Is the TranscriptionProvider Protocol in FluidVoice? A Swift ASR Architecture Guide](/altic-dev/FluidVoice/what-is-the-transcriptionprovider-protocol-and-why-is-it-important)

Explore the TranscriptionProvider protocol in FluidVoice a Swift ASR architecture. Seamlessly integrate Apple Intelligence Whisper or custom back-ends without altering your code.

- Tags: architecture
- Published: 2026-07-07

### [ASRService in FluidVoice Architecture: The Core Speech Recognition Engine](/altic-dev/FluidVoice/what-is-the-role-of-asrservice-in-the-fluidvoice-architecture)

Discover ASRService, the core speech recognition engine in FluidVoice. Understand its role in audio capture, model management, and real-time transcription for your app.

- Tags: architecture
- Published: 2026-07-07

### [How FluidVoice Implements macOS Menu Bar Integration with Quick Access](/altic-dev/FluidVoice/fluidvoice-menubar-integration-quick-access)

Discover how FluidVoice implements macOS menu bar integration with quick access. Learn about its MenuBarManager service, NSStatusItem, NSMenu, and one-shot navigation.

- Tags: how-to-guide
- Published: 2026-07-03

### [PrivateAIIntegrationService in FluidVoice: How Local AI Enhancement Works](/altic-dev/FluidVoice/privateaiintegrationservice-local-ai-enhancement)

Discover how PrivateAIIntegrationService enables local AI enhancement in FluidVoice. Understand its seamless integration with LLMs and graceful fallback mechanisms for a private dictation experience.

- Tags: internals
- Published: 2026-07-03

### [How FluidVoice Handles Audio Device Selection and Management in macOS](/altic-dev/FluidVoice/fluidvoice-audio-device-selection-management)

FluidVoice simplifies macOS audio device selection and management using its AudioDevice API. Discover how it handles input/output, defaults, and app-local modes for your ASR pipeline.

- Tags: how-to-guide
- Published: 2026-07-03

### [FluidVoice Analytics Service Architecture and Event Tracking Implementation](/altic-dev/FluidVoice/fluidvoice-analytics-service-architecture-events)

Explore the FluidVoice analytics service architecture and discover its event tracking implementation. Understand how this privacy-focused pipeline dispatches and flushes data to PostHog.

- Tags: architecture
- Published: 2026-07-03

### [How FluidVoice Uses macOS Accessibility APIs to Type Text into Other Applications](/altic-dev/FluidVoice/fluidvoice-accessibility-apis-typing-applications)

Learn how FluidVoice leverages macOS accessibility APIs to type text into other applications using AX APIs, CGEvent injection, attribute manipulation, and clipboard fallback. Explore the process in TypingService.swift.

- Tags: how-to-guide
- Published: 2026-07-03

### [How FluidVoice's Meeting Transcription Service Detects and Transcribes Meetings](/altic-dev/FluidVoice/fluidvoice-meeting-transcription-service)

FluidVoice's meeting transcription service uses MeetingTranscriptionService to validate audio, load ASR models, and process content for accurate transcriptions. Learn how it works.

- Tags: how-to-guide
- Published: 2026-07-03

### [ThreadSafeAudioBuffer in FluidVoice: Safe Concurrent Audio Processing for Real-Time Speech Recognition](/altic-dev/FluidVoice/threadsafeaudiobuffer-concurrent-audio-processing)

Discover ThreadSafeAudioBuffer in FluidVoice for safe concurrent audio processing. Prevent data races and corruption with this Swift utility for real-time speech recognition.

- Tags: internals
- Published: 2026-07-03

### [How FluidVoice Handles Analytics Privacy: Anonymous Usage Tracking Explained](/altic-dev/FluidVoice/fluidvoice-analytics-privacy-handling)

FluidVoice privacy ensures anonymous usage tracking. Learn how we collect only nonidentifying metrics, protecting your data while improving our service.

- Tags: privacy-guide
- Published: 2026-07-03

### [How FluidVoice Rewrite Mode Works with Text Selection in Any macOS Application](/altic-dev/FluidVoice/fluidvoice-rewrite-mode-text-selection)

Discover how FluidVoice rewrite mode uses macOS Accessibility to capture selected text, process it with an LLM, and insert AI-generated replacements into any application.

- Tags: how-to-guide
- Published: 2026-07-03

### [How FluidVoice Handles Overlay Positioning Around the MacBook Notch](/altic-dev/FluidVoice/fluidvoice-overlay-positioning-macbook-notch)

Discover how FluidVoice's NotchOverlayManager intelligently positions overlays around the MacBook notch using NSScreen auxiliary areas for optimal UI presentation.

- Tags: how-to-guide
- Published: 2026-07-03

### [FluidVoice LocalAPI Server Architecture and Endpoints: A Technical Deep Dive](/altic-dev/FluidVoice/localapi-server-architecture-endpoints)

Explore FluidVoice LocalAPI server architecture and endpoints. Discover its RESTful interface powered by Apple's Network framework for transcription on localhost.

- Tags: deep-dive
- Published: 2026-07-03

### [How FluidVoice Implements the Global Hotkey for Background Voice Capture](/altic-dev/FluidVoice/fluidvoice-global-hotkey-background-voice-capture)

Learn how FluidVoice uses a system-wide event tap and GlobalHotkeyManager to implement background voice capture with custom hotkeys. Discover the technical details behind its efficient audio recording.

- Tags: how-to-guide
- Published: 2026-07-03

### [How FluidVoice's Audio History System Works with Budget Controls and ZIP Export](/altic-dev/FluidVoice/fluidvoice-audio-history-budget-zip-export)

Discover how FluidVoice's audio history system manages WAV files, enforces gigabyte budgets, and enables ZIP export with JSON manifests. Optimize your storage effortlessly.

- Tags: internals
- Published: 2026-07-03

### [Fluid Intelligence: How the Local On-Device AI Runtime Works in FluidVoice](/altic-dev/FluidVoice/what-is-fluid-intelligence-on-device-ai-runtime)

Discover Fluid Intelligence locally on macOS. This 3.5GB AI runtime provides smart formatting and context-aware capitalization for FluidVoice dictation without external servers.

- Tags: internals
- Published: 2026-07-03

### [How FluidVoice Manages Per-App Configuration and Different Prompt Sets](/altic-dev/FluidVoice/fluidvoice-per-app-configuration-prompt-sets)

FluidVoice intelligently manages per-app configuration and prompt sets using a hierarchical system. Discover how it customizes Dictate and Edit modes for each application efficiently.

- Tags: internals
- Published: 2026-07-03

### [LLMClient Architecture: How FluidVoice Handles SSE Streaming and Tool Calls](/altic-dev/FluidVoice/llmclient-architecture-sse-streaming-tool-calls)

Explore the LLMClient architecture powering FluidVoice. Learn how it centralizes AI networking, manages SSE streaming, and parses tool calls in real time for efficient AI communication.

- Tags: architecture
- Published: 2026-07-03

### [How DictationPostProcessingService Integrates with AI Providers in FluidVoice](/altic-dev/FluidVoice/dictationpostprocessingservice-ai-provider-integration)

Learn how FluidVoice's DictationPostProcessingService seamlessly integrates with AI providers like Apple Intelligence and cloud LLMs. Explore unified abstraction for dictation processing.

- Tags: internals
- Published: 2026-07-03

### [How FluidVoice Implements Command Mode and Executes Terminal Commands Securely](/altic-dev/FluidVoice/fluidvoice-command-mode-secure-terminal-execution)

Discover how FluidVoice securely executes terminal commands using Command Mode. Learn about its dual-service architecture, sandboxing, and safety checks for robust remote execution.

- Tags: how-to-guide
- Published: 2026-07-03

### [ASRService Architecture and CoreML Serialization in FluidVoice](/altic-dev/FluidVoice/asrservice-architecture-coreml-serialization)

Explore the FluidVoice ASRService architecture. Learn how TranscriptionExecutor serializes CoreML operations using Swift actors to prevent crashes and manage real-time transcription.

- Tags: architecture
- Published: 2026-07-03

### [How FluidVoice Switches Between Multiple Speech Recognition Models: A Complete Guide](/altic-dev/FluidVoice/how-fluidvoice-handles-multiple-speech-recognition-models)

Discover how FluidVoice efficiently manages multiple speech recognition models. Learn about its SettingsStore and VoiceEngineSettingsViewModel for seamless ASR engine switching and optimized performance.

- Tags: how-to-guide
- Published: 2026-07-03

### [MeetingTranscriptionService in FluidVoice: How It Handles Multi-Speaker Transcription](/altic-dev/FluidVoice/meetingtranscriptionservice-multi-speaker-transcription)

Discover FluidVoice's MeetingTranscriptionService. Learn how this @MainActor ObservableObject handles multi-speaker transcription by orchestrating audio processing, speaker diarization, and result aggregation.

- Tags: deep-dive
- Published: 2026-07-01

### [What Analytics Does FluidVoice Collect and How It Protects User Privacy](/altic-dev/FluidVoice/fluidvoice-analytics-collection-user-privacy)

FluidVoice collects anonymous usage metrics and hardware snapshots, protecting your privacy with an opt-in pipeline you control. Learn more about secure analytics.

- Tags: privacy-policy
- Published: 2026-07-01

### [FluidVoice ModelRepository: How Voice Models Are Managed and Downloaded](/altic-dev/FluidVoice/modelrepository-voice-model-management-download)

Explore the FluidVoice ModelRepository to learn how AI provider configurations and on-device voice recognition models are managed and downloaded securely from Hugging Face.

- Tags: internals
- Published: 2026-07-01

### [How FluidVoice's MenuBarManager Provides Quick Access and Status Display](/altic-dev/FluidVoice/menubarmanager-quick-access-status-display)

Discover how FluidVoice's MenuBarManager offers quick access to features and displays real-time recording status with dynamic icon and text updates directly in your macOS status bar.

- Tags: internals
- Published: 2026-07-01

### [LLMClient Architecture and Multi-Provider Support in FluidVoice](/altic-dev/FluidVoice/llmclient-architecture-multiple-ai-providers)

Explore the LLMClient architecture in FluidVoice. This Swift layer unifies LLM interactions, supports multiple AI providers, and handles streaming responses and tool calls effectively.

- Tags: architecture
- Published: 2026-07-01

### [How FluidVoice Manages Audio History Storage: Budget Controls and ZIP Export](/altic-dev/FluidVoice/fluidvoice-audio-history-storage-budget-zip-export)

Learn how FluidVoice manages audio history storage. Discover budget controls for automatic cleanup and ZIP export options for your dictations. Optimize your storage efficiently.

- Tags: how-to-guide
- Published: 2026-07-01

### [PrivateAIIntegrationService: Managing Local AI Runtime in FluidVoice](/altic-dev/FluidVoice/privateaiintegrationservice-local-ai-runtime-management)

Discover PrivateAIIntegrationService in FluidVoice for thread-safe local AI runtime management. Learn about model installation, runtime state, and dictation enhancement.

- Tags: internals
- Published: 2026-07-01

### [How DictationPostProcessingService Integrates with Cloud AI Providers in FluidVoice](/altic-dev/FluidVoice/dictationpostprocessingservice-cloud-ai-integration)

Discover how FluidVoice's DictationPostProcessingService seamlessly integrates with cloud AI providers. Learn how it routes transcripts, constructs requests, and executes them for enhanced dictation.

- Tags: how-to-guide
- Published: 2026-07-01

### [How FluidVoice Implements Per-App Prompt Configuration for Dictation and Editing Contexts](/altic-dev/FluidVoice/fluidvoice-per-app-prompt-configuration-contexts)

Discover how FluidVoice enables per app prompt configuration for dictation and editing. Learn its fallback logic using SettingsStore for dictation and editing.

- Tags: deep-dive
- Published: 2026-07-01

### [NotchOverlayManager: Handling MacBook Notch-Aware Displays in FluidVoice](/altic-dev/FluidVoice/notchoverlaymanager-and-macbook-notch-aware-overlays)

Learn how NotchOverlayManager handles MacBook notch-aware displays in FluidVoice. Discover seamless UI orchestration and automatic display detection for better user experience.

- Tags: internals
- Published: 2026-07-01

### [How FluidVoice Interacts with macOS System Services for Dictation: Speech, CoreAudio, and Accessibility APIs](/altic-dev/FluidVoice/fluidvoice-macos-system-services-dictation-interaction)

Discover how FluidVoice uses macOS Speech, CoreAudio, and Accessibility APIs to capture audio, convert speech to text, and inject dictations into any app. Learn about its system integrations.

- Tags: internals
- Published: 2026-06-30

### [How FluidVoice Handles and Stores User Data: A Local-First Architecture Guide](/altic-dev/FluidVoice/fluidvoice-user-data-handling-storage)

Discover how FluidVoice securely handles and stores user data locally on macOS. Learn about its robust local-first architecture and data privacy.

- Tags: architecture
- Published: 2026-06-30

### [How to Customize the AI Behavior in FluidVoice: Provider Setup, Prompt Profiles, and Local Model Configuration](/altic-dev/FluidVoice/fluidvoice-customize-ai-behavior)

Customize AI behavior in FluidVoice. Learn to configure AI providers, prompt profiles, and local models for tailored dictation. Master AI settings and programmatic control.

- Tags: how-to-guide
- Published: 2026-06-30

### [FluidVoice AI Enhancement Features: Multi-Provider Speech-to-Text Customization](/altic-dev/FluidVoice/fluidvoice-ai-enhancement-features)

Explore FluidVoice AI enhancement features. Customize multi-provider speech-to-text with local models and granular controls for advanced audio processing.

- Tags: deep-dive
- Published: 2026-06-30

### [How FluidVoice Handles Real-Time Transcription Updates: A Deep Dive into the Streaming Pipeline](/altic-dev/FluidVoice/fluidvoice-real-time-transcription-updates)

Discover how FluidVoice manages real-time transcription updates. Learn about its streaming pipeline for instant audio processing and UI refresh while users speak.

- Tags: deep-dive
- Published: 2026-06-30

### [Is There a Dedicated Module for AI Processing in FluidVoice? A Technical Deep Dive](/altic-dev/FluidVoice/fluidvoice-ai-processing-module)

Explore FluidVoice's dedicated AI processing module. Discover how AIProvider unifies cloud APIs, Apple Intelligence, and offline Core ML models for seamless integration.

- Tags: deep-dive
- Published: 2026-06-30

### [How FluidVoice Manages Audio Input for Transcription: A Deep Dive into ASRService](/altic-dev/FluidVoice/fluidvoice-audio-input-management-transcription)

Discover how FluidVoice uses ASRService to manage audio input for transcription including microphone permissions, real-time buffering, and thread-safe sample delivery to transcription providers.

- Tags: deep-dive
- Published: 2026-06-30

### [Dependencies for Building FluidVoice from Source: A Complete Guide](/altic-dev/FluidVoice/fluidvoice-source-build-dependencies)

Discover the essential dependencies for building FluidVoice from source. This guide details the six external Swift packages needed for macOS 15+ development with Swift Package Manager.

- Tags: how-to-guide
- Published: 2026-06-30

### [How to Configure AI Enhancement Settings in FluidVoice: A Complete Guide](/altic-dev/FluidVoice/fluidvoice-configure-ai-enhancement-settings)

Configure FluidVoice AI enhancement settings easily. Learn to select providers, secure API keys, and customize models for optimal audio performance. Master your sound today.

- Tags: how-to-guide
- Published: 2026-06-30

### [FluidVoice Configuration Options: Complete Guide to SettingsStore and Customization](/altic-dev/FluidVoice/fluidvoice-available-configuration-options)

Explore FluidVoice configuration options with our complete guide to SettingsStore and customization. Learn how FluidVoice manages settings securely using UserDefaults and the macOS Keychain.

- Tags: how-to-guide
- Published: 2026-06-30

### [How FluidVoice Manages AI Services: Architecture and Provider System](/altic-dev/FluidVoice/fluidvoice-ai-service-management)

Discover how FluidVoice manages AI services with its layered provider architecture. Explore seamless integration from cloud OpenAI APIs to local Apple Intelligence models.

- Tags: architecture
- Published: 2026-06-30

### [What AI Models or Services Are Used for Enhancing Voice Dictation in FluidVoice?](/altic-dev/FluidVoice/fluidvoice-ai-models-for-dictation-enhancement)

Discover the AI models enhancing FluidVoice dictation. Explore OpenAI, Apple Intelligence, Groq, local models, and custom endpoints for superior voice transcription.

- Tags: deep-dive
- Published: 2026-06-30

### [Swift Code for the App Entry of FluidVoice: Complete @main Implementation](/altic-dev/FluidVoice/fluidvoice-app-entry-swift-code)

Explore the Swift code for the FluidVoice app entry using @main. Discover how SwiftUI state management, singleton services, and AppKit delegates are integrated for a robust application launch.

- Tags: getting-started
- Published: 2026-06-30

### [Where to Find ContentView.swift in the FluidVoice Repository](/altic-dev/FluidVoice/fluidvoice-contentviewswift-source-code)

Discover the ContentView.swift source code in the FluidVoice repository. Find the main SwiftUI view coordinating UI, hotkeys, and AI services at Sources/Fluid/ContentView.swift.

- Tags: how-to-guide
- Published: 2026-06-30

### [How FluidVoice Handles Configuration Settings: Architecture and Implementation](/altic-dev/FluidVoice/fluidvoice-configuration-handling)

FluidVoice manages settings using a thread-safe SettingsStore singleton. It stores preferences in UserDefaults and sensitive data like API keys in the macOS Keychain.

- Tags: architecture
- Published: 2026-06-30

### [FluidVoice macOS Application Entry Point: Located in fluidApp.swift](/altic-dev/FluidVoice/fluidvoice-macos-app-entry-point)

Discover the FluidVoice macOS application entry point located in fluidApp.swift. Learn how the SwiftUI @main struct initializes services and hosts the main window.

- Tags: internals
- Published: 2026-06-30

### [FluidVoice App Architecture: A Deep Dive into the macOS SwiftUI Structure](/altic-dev/FluidVoice/fluidvoice-app-architecture)

Explore the FluidVoice app architecture a three layer SwiftUI design. Learn how heavy audio and AI services are separated from the UI to ensure stability and responsiveness.

- Tags: architecture
- Published: 2026-06-30

### [PrivateAIProviderFeature Integration Flow in FluidVoice: Architecture & Implementation Guide](/altic-dev/FluidVoice/fluidvoice-privateaiproviderfeature-integration-flow)

Explore the PrivateAIProviderFeature integration flow in FluidVoice. Learn about its lazy bootstrap, runtime registration, and how PrivateAIIntegrationService manages model lifecycles for enhanced dictation.

- Tags: architecture
- Published: 2026-06-29

### [How FluidVoice Handles Parakeet and Nemotron Model Downloads and Caching](/altic-dev/FluidVoice/fluidvoice-parakeet-nemotron-model-download-caching)

FluidVoice efficiently downloads and caches Parakeet and Nemotron models on-demand, ensuring integrity with validation before loading them as Core ML providers.

- Tags: internals
- Published: 2026-06-29

### [FluidVoice Global Hotkey Event Tap System Architecture: A Deep Dive](/altic-dev/FluidVoice/fluidvoice-global-hotkey-event-tap-system-architecture)

Explore the FluidVoice global hotkey event tap system architecture. Discover its three-layer design, retry-aware pipeline, and Core Graphics API implementation on macOS. Learn how it ensures robust event dispatch.

- Tags: architecture
- Published: 2026-06-29

### [Write Mode vs Rewrite Mode in FluidVoice: Functional Differences Explained](/altic-dev/FluidVoice/fluidvoice-writemode-vs-rewritemode-rewritemodeservice)

Discover the functional differences between FluidVoice Write Mode and Rewrite Mode. Learn how each mode creates new content or enhances existing text for better AI interactions.

- Tags: deep-dive
- Published: 2026-06-29