Skip to content

Update windows install instructions for windows #14293

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 8, 2025
Merged

Conversation

MegaIng
Copy link
Contributor

@MegaIng MegaIng commented Jun 17, 2025

Use the py launcher and don't use the pip shortcut for upgrading pip itself. The latter is a required change since pip install -U pip is blocked by pip because it can't function correctly (pip can't replace the pip.exe wrapper while it is running). The former is more of a style change to get inline with the common suggestions for windows users to not have global python executables visible.

Use the `py` launcher and don't use the `pip` script for upgrading pip itself
@srittau
Copy link
Collaborator

srittau commented Jul 7, 2025

Cc @Avasam: I think you have experience with Windows and typeshed? Could you have a look if you find a minute?

Copy link
Collaborator

@Avasam Avasam left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

don't use the pip shortcut for upgrading pip itself. The latter is a required change since pip install -U pip is blocked by pip because it can't function correctly (pip can't replace the pip.exe wrapper while it is running).

This is correct and your change is absolutely the right one. Looks like I missed it when I rewrote that doc.

Use the py launcher [...] more of a style change to get inline with the common suggestions for windows users to not have global python executables visible.

I don't personally use the py launcher, I personally used to alias python3.X.exe, at least, before uv. I also completely disabled the "python to Microsoft Store" redirection on my machines. I know py -3.X can be used to target a specific python version installed and indeed it acts as a manager.

These instructions are for users that don't globally install uv anyway. I don't mind this change either way.

@srittau srittau merged commit f6bb513 into python:main Jul 8, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants