Quickstart

Prerequisites

  • Python ≥3.7

  • Node.js ≥14

  • Electron (global)

    npm install -g electron

  • macOS Audio Loopback (BlackHole 2ch + Ladiocast):

    1. Install BlackHole 2ch:

      brew install blackhole-2ch

    2. Create a Multi-Output Device - Open Audio MIDI Setup - Click “+” → Create Multi-Output Device - Check both BlackHole 2ch and MacBook Pro Speakers

    3. Select Multi-Output Device System Preferences → Sound → Output → Multi-Output Device

    4. Configure Ladiocast - Input 1: BlackHole 2ch → route to Main - Main Output: MacBook Pro Speakers - Mute other channels

    This will route all system and microphone audio into VoxAI.

Install & Run

  1. Install from PyPI:

    pip install voxai

  2. Configure environment:

    cp .env.example .env

    Edit .env:

    GENAI_API_KEY=sk-…
GENAI_MODEL=gemini-1.5-flash

  3. Launch the app:

    voxai

    On first launch VoxAI will automatically run npm install inside its bundled electron/ folder, then open a desktop window.