Xport Blog

How to Fix Applio and RVC Install Errors

Most Applio and RVC install failures come from a handful of causes: where the folder lives, how the installer was started, and old guides. Here is what each common error means and the fix.

Read the first error, not the last

An install log usually fails once and then prints a long chain of follow-on errors. The useful line is the first failure. Applio's own documentation says the same thing for its desktop app: read the first failure in the setup log, fix it, then run Install / Repair again.

Everything below is checked against Applio 3.7.1, the current release at the time of writing, its Windows installer script and its release notes, plus the current requirements files of the original RVC WebUI. If you are following a video from two years ago, some of its steps no longer apply.

"The current working directory contains spaces"

When Applio starts, it checks the folder it is running from and stops with an Installation Error if the path breaks one of three rules. The messages are: the current working directory contains spaces, the current working directory is located in OneDrive, and the current working directory contains non-ASCII characters.

The fix is the same for all three: move the whole Applio folder somewhere short and plain, such as C:\Applio, and run it from there. A folder called New Folder, a Windows user name with an accent or a space in it, or anything under Desktop or Documents when OneDrive backup is switched on will all trigger it. The release notes repeat the rule: keep the install path free of spaces and special characters.

Do not run the installer as administrator

Every recent Applio release note says not to run run-install.bat with administrator privileges. The installer sets up Miniconda for your own user account, and running it elevated can put files where your normal account cannot use them later. Double-click it as your normal user. If you already ran it as admin and things are half broken, delete the folder, extract a fresh copy and install again.

The same notes suggest temporarily disabling your antivirus and firewall during installation, because a blocked download leaves dependencies missing. If you do that, only do it for the official release from the IAHispano/Applio GitHub page, and switch protection back on as soon as the install finishes.

"Download failed" or "Miniconda installation failed"

On Windows, run-install.bat does more than people expect. It downloads Miniconda into your user folder, creates an environment with Python 3.12, installs the uv package installer, then pulls every dependency, including the CUDA 12.8 builds of PyTorch. That is a large download, so a dropped connection, a captive Wi-Fi portal or a proxy at work will stop it.

If you see Download failed, check your connection and run the installer again. If you see Miniconda installation failed, there is usually a broken earlier attempt in the way: delete the half-finished Miniconda3 folder in your user directory and the env folder inside Applio, then rerun. You do not need to install Python yourself first; the installer brings its own.

"Microsoft Visual C++ 14.0 or greater is required"

This one comes from older RVC guides and forks. They install a package called fairseq, which has to be compiled on your machine, and Windows cannot compile it without Microsoft's C++ build tools. The log shows Microsoft Visual C++ 14.0 or greater is required, often followed by Could not build wheels for fairseq.

The cleanest fix is to stop following the old guide. Neither the current Applio requirements nor the current RVC WebUI requirements files list fairseq, so a fresh install of either one skips the problem. If you really need the old fork, install Microsoft C++ Build Tools with the Desktop development with C++ workload, restart, and run the install again.

Skip the install script: use the compiled Windows build

If run-install.bat keeps failing, Applio's release notes offer a way around it. Each Windows release links a compiled zip on Applio's Hugging Face page. Extract the whole zip into a short folder such as C:\Applio, then open run-applio.bat. There is no install step to fail, because the environment is already inside the zip.

To update a compiled build later, close Applio and run run-updater.bat, which installs the latest release while keeping your models, logs, audio, presets and settings. Older compiled builds can add the updater by extracting ApplioUpdater.zip from the GitHub release into the existing folder.

GPU problems after a clean install

The Windows installer pulls the NVIDIA CUDA build of PyTorch. If the install finishes but training is painfully slow, the app may be running on your CPU. Update your NVIDIA driver first. AMD and Apple machines have different requirements, and Applio's documentation warns that old CUDA or HIP/ZLUDA recipes copied from tutorials may conflict with the current environment, so use its repair workflow before you change PyTorch by hand.

On a Mac, download the build that matches your chip: arm64 for Apple Silicon, x64 for Intel. The Mac app is not notarized by Apple yet, so the first launch needs the Terminal step Applio documents on its download page. Our RVC on Mac guide covers the options in more detail.

If you would rather skip the setup

Applio is free, open source and worth the effort if you enjoy the tinkering. We compare it with the original WebUI in Applio vs RVC. For a side-by-side with Xport, see Xport Studio vs Applio. If you only want to convert vocals with a .pth model and get back to making music, there is another route.

Xport Studio is a desktop app for Mac and Windows that runs the same RVC models on your own computer with no Python, no conda and no install script. The Mac build is notarized and needs macOS 15 or later. It also trains models and splits stems. See the AI vocal converter. Voice conversion is free for 7 days, then part of Xport Pro, $79 one time.

Quick answers

Why does Applio say the current working directory contains spaces?

Applio checks its own folder at startup and refuses paths with spaces, non-ASCII characters or a OneDrive location. Move the whole folder to a short path such as C:\Applio and run it again.

Should I run run-install.bat as administrator?

No. Applio's release notes say not to run it with administrator privileges. Run it as your normal user. If you already ran it elevated, delete the folder, extract a fresh copy and install again.

How do I fix Microsoft Visual C++ 14.0 or greater is required?

It usually means an old guide is installing fairseq. Current Applio and RVC WebUI installs do not need it. If you must use the old fork, install Microsoft C++ Build Tools with the Desktop development with C++ workload.

Keep reading

Who writes this?

We're the small team behind Xport Studio, a private desktop app for AI vocals, stems, and mastering that processes your audio on your own machine. We also build free in-browser audio tools, and this blog covers the questions people bring to them.

Meet Xport Studio