GitHubDiscord

Windows Installation

Yumi runs natively on Windows 10 and 11. Because she is optimized to run on standard CPUs, no NVIDIA GPU or CUDA setups are required.

⚡ One-Line Quick Install

The easiest way to install Yumi on Windows is via the automated PowerShell script.

Open a PowerShell terminal (no Administrator privileges required) and paste:

irm https://raw.githubusercontent.com/CodeNeuron58/Yumi/main/install.ps1 | iex

What this script does:

  1. Checks if Python 3.12+ is installed (prompts if missing).
  2. Installs the uv package manager securely.
  3. Clones the Yumi repository to C:\Users\YourName\Yumi.
  4. Creates a virtual environment and runs uv sync to set up all packages (pinning CPU-only Torch).
  5. Creates a global yumi alias so you can launch the app from any directory.

🛠️ Prerequisites & Common Hurdles

Before launching Yumi, ensure you have the following Windows settings calibrated:

1. Default Recording Device

Yumi captures audio from your default system microphone.

  1. Right-click the speaker icon in your Windows Taskbar and select Sound settings.
  2. Under Input, ensure your primary microphone is selected as the default device.
  3. Test your microphone to ensure the volume bar moves when you speak.

2. Windows Defender & Security Keyring

Yumi saves your Groq, OpenAI, and ElevenLabs API keys in the Windows Credential Manager using the OS keychain library (keyring).

  • Privacy: This ensures keys are never committed to your disk in plaintext.
  • Approval: The first time you configure keys, Windows might show a prompt asking to grant python.exe access to the Credential Manager. Click Allow.

💡 Troubleshooting Windows Audio

Error: KMP_DUPLICATE_LIB_OK

If your backend console crashes immediately with a KMP duplicate library error, this is a known conflict on Windows when loading both faster-whisper and certain Intel OpenMP runtimes.

  • The Fix: The Yumi CLI handles this automatically by setting os.environ["KMP_DUPLICATE_LIB_OK"] = "TRUE" prior to importing. If you run manually, make sure this environment variable is set in your shell: 
    $env:KMP_DUPLICATE_LIB_OK="TRUE"

Proceed to the macOS Installation or Core Senses sections to learn more!