# FluidVoice Deployment Options: 3 Ways to Install on macOS

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

- Repository: [ALTIC/FluidVoice](https://github.com/altic-dev/FluidVoice)
- Tags: deployment-options
- Published: 2026-08-16

---

**FluidVoice deployment options include Homebrew cask, manual download from GitHub Releases, and building from source using Swift Package Manager and Xcode.**

This guide covers every installation method for FluidVoice, a macOS voice-interface application developed by altic-dev. Whether you need a one-line command, a pre-built signed bundle, or full control over compilation, the repository supports three distinct deployment paths optimized for different user needs.

## Homebrew Cask Deployment

The **Homebrew cask** method offers the fastest path to a working installation. This approach pulls a signed `.app` bundle from the latest GitHub release and places it directly in `/Applications`.

According to the [README.md](https://github.com/altic-dev/FluidVoice/blob/main/README.md#install-with-homebrew) in the FluidVoice repository, the cask handles code signing verification automatically.

```bash
brew install --cask fluidvoice

```

After installation, launch FluidVoice from `/Applications` or Spotlight. No additional configuration is required.

## Manual Download from GitHub Releases

For users who prefer direct control over the installation process, **manual download** fetches the compiled release asset without package managers. The bundle arrives signed and ready for the Applications folder.

The [README.md](https://github.com/altic-dev/FluidVoice/blob/main/README.md#manual-download) notes that releases include both signed and optionally unsigned variants depending on your security requirements.

```bash
curl -L -o FluidVoice.zip "$(curl -s https://api.github.com/repos/altic-dev/FluidVoice/releases/latest | grep browser_download_url | cut -d '"' -f 4)"
unzip FluidVoice.zip -d /Applications

```

This method suits air-gapped environments or organizations with specific binary verification workflows.

## Build-From-Source Deployment

Developers and power-users can **compile FluidVoice from source** using the Swift toolchain. This path requires Xcode and the Swift Package Manager dependencies declared in [[`Package.swift`](https://github.com/altic-dev/FluidVoice/blob/main/Package.swift)](https://github.com/altic-dev/FluidVoice/blob/main/Package.swift).

The repository includes [[`build.sh`](https://github.com/altic-dev/FluidVoice/blob/main/build.sh)](https://github.com/altic-dev/FluidVoice/blob/main/build.sh), a helper script that automates both signed and unsigned builds.

### Signed Build

```bash
git clone https://github.com/altic-dev/FluidVoice.git
cd FluidVoice
./build.sh
open DerivedData/Build/Products/Debug/FluidVoice\ Debug.app

```

The script uses your macOS Developer Team ID for code signing. Verify your signing identity in Xcode settings before running.

### Unsigned Build

```bash
./build.sh unsigned
open DerivedData/Build/Products/Debug/FluidVoice\ Debug.app

```

Unsigned builds suit **CI pipelines**, **test environments**, or systems without Apple Developer accounts. The resulting app lacks notarization and may trigger Gatekeeper warnings.

## Key Source Files for Deployment

Understanding these files helps troubleshoot installation issues or customize builds:

- **[`Package.swift`](https://github.com/altic-dev/FluidVoice/blob/main/Package.swift)** — Declares Swift package dependencies including SwiftUI and voice-processing frameworks
- **[`build.sh`](https://github.com/altic-dev/FluidVoice/blob/main/build.sh)** — Convenience script invoking `xcodebuild` with configurable signing parameters
- **[`Sources/Fluid/fluidApp.swift`](https://github.com/altic-dev/FluidVoice/blob/main/Sources/Fluid/fluidApp.swift)** — Application entry point compiled into the final bundle
- **`Fluid.xcodeproj/project.pbxproj`** — Xcode project configuration referenced by the build script

## Platform Availability and Future Roadmap

All current FluidVoice deployment options target **macOS only**. The [repository documentation](https://github.com/altic-dev/FluidVoice/blob/main/README.md) indicates iOS and Windows versions are planned but not yet released. Build configurations and dependency management in [`Package.swift`](https://github.com/altic-dev/FluidVoice/blob/main/Package.swift) are structured to support cross-platform expansion.

## Summary

- **Homebrew cask** — One-command installation with automatic updates via `brew upgrade`
- **Manual download** — Direct release acquisition for controlled environments
- **Build from source** — Full customization through [`./build.sh`](https://github.com/altic-dev/FluidVoice/blob/main/./build.sh) (signed) or `./build.sh unsigned`

Each method installs the same core application defined in [`fluidApp.swift`](https://github.com/altic-dev/FluidVoice/blob/main/fluidApp.swift) and managed through the Xcode project system.

## Frequently Asked Questions

### What are the system requirements for FluidVoice deployment?

FluidVoice requires macOS with Xcode installed for source builds, or just macOS 11+ for pre-built bundles. The Homebrew cask and manual download methods need approximately 50MB of disk space plus dependencies.

### Can I deploy FluidVoice without code signing?

Yes. Run `./build.sh unsigned` to generate an unnotarized build. Note that macOS Gatekeeper will block unsigned apps by default; you must grant security exceptions in System Preferences to launch them.

### Which FluidVoice deployment method supports automatic updates?

Only the **Homebrew cask** installation receives automatic updates through `brew upgrade`. Manual download and source builds require explicit re-download or re-compilation when new releases appear on the [GitHub Releases](https://github.com/altic-dev/FluidVoice/releases) page.

### Is FluidVoice available for Linux or Windows deployment?

No. The current source code in [`Package.swift`](https://github.com/altic-dev/FluidVoice/blob/main/Package.swift) and [`fluidApp.swift`](https://github.com/altic-dev/FluidVoice/blob/main/fluidApp.swift) uses macOS-specific frameworks including SwiftUI and AVFoundation. Windows and iOS ports are documented as planned features but lack release timelines.