Skip to content
BSWEN
Blog

How to use uv in pycharm?

Cowrie
Cowrie
Dev @ Bswen

1. Purpose

In this post, I will demonstrate how to solve the following error when using uv in pycharm.

When I’m trying to use uv in my pycharm project, I got following error:

Terminal window
The following command was executed:
 /Users/zzz/.local/bin/uv init --python /Users/zzz/.local/bin/uv --no-readme --no-pin-python --vcs none
 The exit code: 2
 The error output of the command:
 error: Failed to inspect Python interpreter from provided path at `/Users/zzz/.local/bin/uv`
 Caused by: Querying Python at `/Users/zzz/.local/bin/uv` failed with exit status exit status: 2
 [stderr] error: unexpected argument '-I' found  Usage: uv [OPTIONS]
 For more information, try '--help'.

Just as the following picture shows: uv1

2. The Solution

2.1 What is uv?

uv is an fast Python package and project manager, written in Rust. It’s 100x faster then pip. And aside from managing packages in python, it also support project management, like creating a python project, manage multiple python versions on your system etc.

2.2 How to install uv?

Install uv with the standalone installers:

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh


# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Or, from PyPI:

# With pip.
pip install uv
# Or pipx.
pipx install uv

If installed via the standalone installer, uv can update itself to the latest version:

uv self update

See the installation documentation for details and alternative installation methods.

2.3 How to solve the error in pycharm?

To solve the problem , I tried to start the project from scratch.

Step1: create the project as follows: uv2 Just as the above picture shows, make sure to choose custom env and select create new menu, and choose the type uv.

Step2: Confirm to create the uv project pycharm will use uv to create the project, we can see the pyenv.cfg file in the project’s root directory:

pyenv.cfg
home = /Users/zzz/.pyenv/versions/3.10.16/bin
implementation = CPython
uv = 0.6.9
version_info = 3.10.16
include-system-site-packages = false
prompt = hello_mcp

You can see that uv has created the pycharm project, and has created a virtual env for us.

Now it works!

3. Summary

In this post, I demonstrated how to install uv and use uv in pycharm. That’s it, thanks for your reading.

Final Words + More Resources

My intention with this article was to help others who might be considering solving such a problem. So I hope that’s been the case here. If you still have any questions, don’t hesitate to ask me by email: Email me

Here are also the most important links from this article along with some further resources that will help you in this scope:

Oh, and if you found these resources useful, don’t forget to support me by starring the repo on GitHub!

Tags: