Installation Guide for macOS

System Requirements

• Operating System: macOS Sonoma 14.0 or macOS Sequoia 15.0+
• Architecture: Apple Silicon (M1/M2/M3/M4) recommended; Intel Macs fully supported.
• Memory: 8 GB RAM minimum (16 GB+ recommended for running 7B local Ollama models).
• Storage: 150 MB for the core Avelyn app; 3–5 GB optional disk space for local LLM weights.

Step-by-Step Installation

1. Download DMG: Download the latest .dmg installer from the official website or GitHub Releases repository.
2. Open Disk Image: Double-click Avelyn-v2.1.dmg to mount the volume.
3. Drag to Applications: Drag the Avelyn icon into your macOS /Applications directory.
4. Launch Avelyn: Open Avelyn from Launchpad or Spotlight (Cmd+Space).

Verifying Download Checksums

For security-conscious environments, verify the integrity of the downloaded installer using terminal SHA-256 validation:

shasum -a 256 Avelyn-v2.1.dmg

Compare the output against the published checksum hash on our GitHub Releases page.

Homebrew Installation

You can also install and update Avelyn using Homebrew Cask:

brew install --cask avelyn

Next Steps

Proceed to the Permissions Setup guide to grant Accessibility and Input Monitoring rights required for global hotkey text replacement.