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

AppImage (Portable)

Portable application format that runs on most Linux distributions without installation.

# Download latest AppImage curl -L https://github.com/gestura-ai/gestura-app/releases/latest/download/gestura-app.AppImage -o gestura-app.AppImage # Make executable chmod +x gestura-app.AppImage # Run directly ./gestura-app.AppImage # Optional: Integrate with desktop # Install AppImageLauncher for better integration sudo apt install appimagelauncher  # Ubuntu/Debian # or download from https://github.com/TheAssassin/AppImageLauncher

Manual Downloads

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

Windows

Installation Steps

1. Download: Get the Windows installer (.exe) 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 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. 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
5. 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: Get the AppImage file from the downloads section
2. Make Executable: chmod +x gestura-app.AppImage
3. Run: ./gestura-app.AppImage
4. Desktop Integration (Optional):
   • Install AppImageLauncher: sudo apt install appimagelauncher
   • Or manually create desktop entry in ~/.local/share/applications/
5. Audio Setup: Ensure your user is in the audio group: sudo usermod -a -G audio $USER

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

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%\Gestura\gestura.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:

• Read the Quick Start Guide
• Learn about Configuration Options
• Join our Discord Community for help
• Check out Voice Commands Guide