Gestura.appgestura.app

User documentation

Installation

Get Gestura.app installed on your system. Choose from package managers, manual downloads, or build from source.

Package Managers

The easiest way to install and keep Gestura.app updated. Package managers automatically handle dependencies, updates, and system integration.

Windows

Winget (Recommended)

Windows Package Manager is built into Windows 10 1709+ and Windows 11.

winget install gestura-ai.gestura-app

Benefits: Automatic updates, system integration, uninstall support

Chocolatey

Popular third-party package manager for Windows.

# Install Chocolatey first (if not already installed)
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# Install Gestura.app
choco install gestura-app

Scoop

Command-line installer for Windows focused on developer tools.

# Add Gestura bucket
scoop bucket add gestura https://github.com/gestura-ai/scoop-bucket

# Install Gestura.app
scoop install gestura-app

# Update later with
scoop update gestura-app

macOS

Homebrew (Recommended)

The most popular package manager for macOS. Requires macOS 10.15+ or macOS 11+.

# Install Homebrew first (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Gestura.app
brew install --cask gestura-app

# Update later with
brew upgrade --cask gestura-app

Benefits: Automatic updates, easy uninstall, dependency management

MacPorts

Alternative package manager for macOS with extensive software collection.

# Install MacPorts first from https://www.macports.org/install.php
# Then install Gestura.app
sudo port install gestura-app

# Update later with
sudo port upgrade gestura-app

Linux

Snap (Universal)

Works across most Linux distributions. Provides automatic updates and sandboxing.

# Install snapd if not already installed (Ubuntu/Debian)
sudo apt update && sudo apt install snapd

# Install Gestura.app
sudo snap install gestura-app

# Grant microphone access
sudo snap connect gestura-app:audio-record

Flatpak (Universal)

Cross-distribution application framework with sandboxing.

# Install Flatpak if not already installed
# Ubuntu/Debian: sudo apt install flatpak
# Fedora: sudo dnf install flatpak
# Arch: sudo pacman -S flatpak

# Add Flathub repository
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Install Gestura.app
flatpak install flathub ai.gestura.app

# Run with
flatpak run ai.gestura.app

Direct DEB/RPM Packages

For manual Linux installs, use the canonical GitHub release packages that match your distribution.

# Debian / Ubuntu
curl -LO https://github.com/gestura-ai/gestura-app/releases/download/vX.Y.Z/gestura-vX.Y.Z-linux-x86_64.deb
sudo apt install ./gestura-vX.Y.Z-linux-x86_64.deb

# Fedora / RHEL / openSUSE
curl -LO https://github.com/gestura-ai/gestura-app/releases/download/vX.Y.Z/gestura-vX.Y.Z-linux-x86_64.rpm
sudo rpm -i gestura-vX.Y.Z-linux-x86_64.rpm

Manual Downloads

Download pre-built binaries directly from our downloads section. This method gives you full control over the installation process.

Each GitHub release also publishes a checksum manifest (`gestura-vX.Y.Z-SHA256SUMS.txt`) and release manifest (`gestura-vX.Y.Z-release-manifest.json`) so you can verify exactly what shipped.

Windows

Installation Steps

  1. Download: Get the signed Windows installer (`.msi`) from the downloads section
  2. Security Check: Windows may show a SmartScreen warning. Click "More info" → "Run anyway"
  3. Install: Run the installer and follow the setup wizard
    • Choose installation directory (default: C:\Program Files\Gestura)
    • Select whether to add to PATH (recommended)
    • Choose whether to create desktop shortcut
  4. Launch: Start Gestura.app from the Start menu or desktop shortcut
  5. First Run: Grant microphone permissions when prompted

Troubleshooting Windows

  • Antivirus blocking: Add Gestura.app to your antivirus whitelist
  • Permission denied: Run installer as Administrator
  • Missing dependencies: Install Visual C++ Redistributable 2019+

macOS

Installation Steps

  1. Download: Get the universal macOS installer (`.dmg`) from the downloads section
  2. Mount: Double-click the .dmg file to mount the disk image
  3. Install: Drag Gestura.app to the Applications folder
  4. Managed Deployments: If you need a non-interactive installer, use the `.pkg` asset from the same GitHub release instead
  5. Security: First launch may show a security warning:
    • Go to System Preferences → Security & Privacy → General
    • Click "Open Anyway" next to the Gestura.app warning
    • Or use Terminal: sudo xattr -rd com.apple.quarantine /Applications/Gestura.app
  6. Permissions: Grant microphone access in System Preferences → Security & Privacy → Privacy → Microphone

Troubleshooting macOS

  • "App is damaged": Download again or use the xattr command above
  • No microphone access: Check Privacy settings and restart the app
  • Crashes on startup: Check Console.app for error messages

Linux

Installation Steps

  1. Download: Choose the package that matches your distro from the downloads section: `.deb` for Debian/Ubuntu-based systems, `.rpm` for Fedora/RHEL/openSUSE-style systems
  2. Install:
    • Debian / Ubuntu: sudo apt install ./gestura-vX.Y.Z-linux-x86_64.deb
    • Fedora / RHEL / openSUSE: sudo rpm -i gestura-vX.Y.Z-linux-x86_64.rpm
  3. Desktop Integration: The native package registers the application with your system menu automatically
  4. CLI: The full Linux packages install the `gestura` CLI alongside the desktop app; a standalone CLI archive is also published on the GitHub release if you only need the terminal tool
  5. Audio Setup: Ensure your user is in the audio group: sudo usermod -a -G audio $USER
  6. Verification:
    • Debian / Ubuntu: dpkg -I gestura-vX.Y.Z-linux-x86_64.deb
    • Fedora / RHEL / openSUSE: rpm -qpi gestura-vX.Y.Z-linux-x86_64.rpm

Troubleshooting Linux

  • No audio device: Install PulseAudio or ALSA drivers
  • Permission denied: Check file permissions and audio group membership
  • Missing libraries: Install FUSE for AppImage support: sudo apt install fuse
  • Wayland issues: Try running with GDK_BACKEND=x11 ./gestura-app.AppImage

Build from Source

For developers who want to build from source, contribute to the project, or customize the build. This method gives you the latest features and allows for customization.

Prerequisites

Required Tools

  • Rust: 1.70 or later (install from rustup.rs)
  • Git: For cloning the repository
  • CMake: 3.15+ (for native dependencies)
  • Python: 3.8+ (for build scripts)

Platform-Specific Requirements

Windows
  • Visual Studio Build Tools 2019+ or Visual Studio Community
  • Windows SDK 10.0.19041+
  • LLVM/Clang (optional, for faster builds)
macOS
  • Xcode Command Line Tools: xcode-select --install
  • Homebrew: For additional dependencies
Linux
  • Build essentials: sudo apt install build-essential pkg-config
  • Audio libraries: sudo apt install libasound2-dev libpulse-dev
  • GUI libraries: sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev

Build Instructions

Quick Build

# Clone the repository
git clone https://github.com/gestura-ai/gestura-app.git
cd gestura-app

# Install Rust if not already installed
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

# Build release version
cargo build --release

# Run the application
./target/release/gestura-app

Development Build

# Clone and enter directory
git clone https://github.com/gestura-ai/gestura-app.git
cd gestura-app

# Install development dependencies
cargo install cargo-watch cargo-edit cargo-audit

# Build in debug mode (faster compilation)
cargo build

# Run with debug logging
RUST_LOG=debug cargo run

Development Setup

IDE Configuration

For the best development experience:

  • VS Code: Install rust-analyzer extension
  • IntelliJ/CLion: Install Rust plugin
  • Vim/Neovim: Use rust.vim and coc-rust-analyzer

Development Commands

# Run with hot reload
cargo watch -x run

# Run tests
cargo test

# Run tests with output
cargo test -- --nocapture

# Check code formatting
cargo fmt --check

# Run linter
cargo clippy

# Security audit
cargo audit

# Update dependencies
cargo update

Building for Distribution

# Build optimized release
cargo build --release

# Strip debug symbols (Linux/macOS)
strip target/release/gestura-app

# Create AppImage (Linux)
./scripts/build-appimage.sh

# Create DMG (macOS)
./scripts/build-dmg.sh

# Create installer (Windows)
./scripts/build-installer.ps1

Troubleshooting Build Issues

Common Problems

  • Linker errors: Install platform-specific build tools listed above
  • Audio library missing: Install audio development packages
  • Rust version too old: Update with rustup update
  • Dependency conflicts: Clear cache with cargo clean

Performance Optimization

# Use faster linker (Linux)
sudo apt install lld
export RUSTFLAGS="-C link-arg=-fuse-ld=lld"

# Use faster linker (macOS)
brew install llvm
export RUSTFLAGS="-C link-arg=-fuse-ld=/opt/homebrew/opt/llvm/bin/ld64.lld"

# Parallel compilation
export CARGO_BUILD_JOBS=8

System Requirements

Minimum Requirements

ComponentWindowsmacOSLinux
OS VersionWindows 10 1903+ (64-bit)macOS 11.0 (Big Sur)Ubuntu 20.04+ / equivalent
CPUx64 processor, 2+ coresIntel or Apple Siliconx86_64, 2+ cores
Memory4GB RAM4GB RAM4GB RAM
Storage500MB free space500MB free space500MB free space
AudioMicrophone requiredMicrophone requiredALSA/PulseAudio + mic

Recommended Requirements

  • Memory: 8GB RAM for better performance with multiple agents
  • Storage: 2GB free space for logs and temporary files
  • Network: Broadband internet for cloud features
  • Audio: Noise-canceling microphone for better voice recognition
  • Display: 1920x1080 or higher for optimal UI experience

Supported Architectures

  • Windows: x64 (Intel/AMD 64-bit)
  • macOS: Intel x64, Apple Silicon (M1/M2/M3)
  • Linux: x86_64, ARM64 (experimental)

Post-Installation Setup

Verification

After installation, verify Gestura.app is working correctly:

# Check version and basic functionality
gestura-app --version

# Run comprehensive health check
gestura-app --health

# Test microphone access
gestura-app --test-audio

# Verify MCP connectivity (if configured)
gestura-app --test-mcp

Initial Configuration

Set up your first configuration:

# Create default configuration
gestura-app init

# Edit configuration file
# Windows: notepad %APPDATA%Gesturagestura.toml
# macOS: open ~/Library/Application Support/Gestura/gestura.toml
# Linux: nano ~/.config/gestura/gestura.toml

Audio Setup

Microphone Configuration

  1. Grant Permissions: Allow microphone access when prompted
  2. Test Audio: Use gestura-app --test-audio to verify input
  3. Adjust Sensitivity: Configure in settings if voice detection is poor
  4. Background Noise: Use noise suppression if in noisy environment

Audio Troubleshooting

  • No microphone detected: Check system audio settings and permissions
  • Poor recognition: Ensure microphone is close (6-12 inches) and reduce background noise
  • Audio conflicts: Close other applications using the microphone

Next Steps

After installation:

© 2026 Gestura AI LLC. All rights reserved.