Troubleshooting UV and UVX

This is a page explaining how to solve the UV and UVX problem you might experience when installing the Armor MCP

On Windows devices, it's common to experience a UV and UVX issue during the installation process.

The first thing you should do is open your Command Prompt and type in:

pip install uv

After pressing Enter, you need to type in:

uv --version

And if you get the output as in this picture, it means you're running into a UV error. Let's go through the steps on how to fix it.

Solution 1

After you've installed UV in the Command Prompt, your system might not be able to find it. This means you need to manually import the UV command as an Environment Variable. Here's how to do it.

Open your Command Prompt and type in this:

python -m site --user-base

The output should look something like this:

Copy that part by pressing CTRL+C, open your File Explorer, paste the location in the Nav Bar, and press Enter. You'll see a folder named Python311 (or whichever Python version you have).

Open the Python311 Folder and open the Scripts Folder. You'll see a couple of files, and two of them will be uv and uvx.

After you've found these two files, copy the location address by selecting the Nav Bar and pressing CTRL + C.

After you have the location copied, go to your Windows search and type in Environment. You'll see a suggestion from the Control Panel - Edit the system environment variables.

Select it, and go to Environment Variables.

Once you click on Environment Variables, find the Path command in User variables and System variables and click Edit.

In both cases (User and System variables) add a new Environment Variable, and paste the address you copied from the File Explorer where the UV and UVX are located.

Click OK and save the progress you've made, and then check in the Command Prompt whether you have UV installed:

uv --version

If you get the version, you'll be ready to use the Armor MCP.

If not, you need to try out the second solution.

Solution 2

This solution is simpler than the first one and it requires you to manually paste UV and UVX into your System32 Folder. Here's what you need to do step by step:

Open your Command Prompt and type in this:

python -m site --user-base

The output should look something like this:

Copy that part by pressing CTRL+C, open your File Explorer, paste the location in the Nav Bar, and press Enter. You'll see a folder named Python311 (or whichever Python version you have).

Open the Python311 Folder and open the Scripts Folder. You'll see a couple of files, and two of them will be uv and uvx.

Copy the UV and UVX files, then navigate to:

This PC -> Local Disk C -> Windows -> System32

And then paste the two files into System32.

Then check in the Command Prompt whether you have UV installed:

uv --version

With this try, you'll have UV and UVX installed. If not, go to the Armor Wallet Discord and ask for help by opening a ticket.

Video Explanation