Skip to content

Document transparent x86_64 emulation on aarch64 #16041

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.

Sign up for GitHub

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
konstin merged 1 commit into from
Oct 2, 2025
Merged

Document transparent x86_64 emulation on aarch64 #16041

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions docs/concepts/python-versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -466,6 +466,15 @@ Pyodide distributions are provided by the [Pyodide project](https://github.com/p

Pyodide is a port of CPython for the WebAssembly / Emscripten platform.

## Transparent x86_64 emulation on aarch64

Both macOS and Windows support running x86_64 binaries on aarch64 through transparent emulation.
This is called [Rosetta 2](https://support.apple.com/en-gb/102527) or
[Windows on ARM (WoA) emulation](https://learn.microsoft.com/en-us/windows/arm/apps-on-arm-x86-emulation).
It's possible to use x86_64 uv on aarch64, and also possible to use an x86_64 Python interpreter on
aarch64. Either uv binary can use either Python interpreter, but a Python interpreter needs packages
for its architecture, either all x86_64 or all aarch64.
Comment on lines +474 to +476
Copy link
Copy Markdown
Member Author

@konstin konstin Sep 26, 2025

Choose a reason for hiding this comment

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

These is my assumption based on previous issues. There are exceptions (https://learn.microsoft.com/en-us/windows/arm/arm64x-pe), but it seems to be advisable to have the user stay either all on x86_64 or all on aarch64 for their venv.


## Registration in the Windows registry

On Windows, installation of managed Python versions will register them with the Windows registry as
Expand Down
Loading
⚡