From 3d89aa6b3102371968fabb459cb0cb80518e90b8 Mon Sep 17 00:00:00 2001 From: Jakob Klotz Date: Thu, 12 Feb 2026 17:14:15 +0100 Subject: [PATCH 1/8] docs: remove troubleshooting section (not needed anymore) --- docs/python/installation.md | 109 +----------------------------------- 1 file changed, 1 insertion(+), 108 deletions(-) diff --git a/docs/python/installation.md b/docs/python/installation.md index cc79b216..6423d0a9 100644 --- a/docs/python/installation.md +++ b/docs/python/installation.md @@ -92,8 +92,7 @@ Now run the Python installer. ## Step 3: :fontawesome-solid-check: Done! If everything went smoothly, you have successfully installed -**:fontawesome-brands-python: Python**! You can now skip the -troubleshooting part and proceed with the next chapter. :party_popper: +**:fontawesome-brands-python: Python**!
+
-???+ tip ":fontawesome-brands-apple: Are you on Apple silicon?" + If you prefer a written guide follow the next couple of sections. - If you are using an Apple silicon Mac (M1, ... M4), you can also pick - the `macOS 64-bit universal2 installer`. +

Step 1: :fontawesome-solid-download: Download

-## Step 2: :fontawesome-solid-arrow-pointer: Run installer + We recommend installing **:fontawesome-brands-python: Python** `3.14`. -No matter which operating system you're on, When installing Python, make sure -that you check the box `Add python to PATH`! + 1. Visit the official website + [python.org :octicons-link-external-16:](https://www.python.org) + 1. Navigate to **Downloads** + 1. Select the *Python install manager* to automatically trigger the download + 1. Once downloaded, open the MSIX file (MSIX is the Windows application + distribution format) -Now run the Python installer. +

Step 2: :fontawesome-solid-arrow-pointer: Run installer

-=== ":fontawesome-brands-windows: Windows" + 1. Click **"Install Python"** to begin the installation -
- -
+ 1. A new Terminal window will open - After the successful installation, we recommend to open a command prompt - (use the Windows search with the keyword `cmd`) and verify the installation - by typing + 1. **Optional:** If prompted with "Open Settings to modify App execution + aliases": - ```commandline - python --version - ``` + - Type `y` and press ++enter++ + - In the Settings app, search for `alias` + - Navigate to **App execution aliases** + - Toggle the Python aliases **on** - which should result in - - ```title="CMD Output" - Python 3.12.9 - ``` + ???+ info + + The app alias configuration is an optional step that may appear during + installation. It might not be necessary on your machine. Properly configured + aliases allow you to execute Python commands from the terminal. + + 1. When prompted `Install CPython now? [Y/n]`: + + - Press ++enter++ to accept the default option (Yes) + + 1. When prompted `View online help? [y/N]`: + + - Press ++enter++ to skip this step + - The terminal will close automatically + +

Step 3: :fontawesome-solid-check-circle: Verify Installation

+ + 1. Open a new terminal window (use Windows search with the keyword `terminal`) + + 1. Check your installation by running: + + ```commandline + python --version + ``` + + 1. You should see output similar to: + + ``` + Python 3.14.* + ``` + + where `*` represents the specific patch version. === ":fontawesome-brands-apple: macOS" - + + ???+ tip ":fontawesome-brands-apple: Are you on Apple silicon?" + + If you are using an Apple silicon Mac (M1, ... M4), you can also pick the + `macOS 64-bit universal2 installer`. + ???+ info - Unfortunately, we do not have a installation video for macOS (yet). - If you're having any trouble, please reach out to us! + Unfortunately, we do not have a installation video for macOS (yet). If you're + having any trouble, please reach out to us! Nevertheless, the installation process is straightforward. Double click the downloaded `python-3.12.9-macos11.pkg` file and follow the installation @@ -75,23 +106,23 @@ Now run the Python installer. Make sure to `Add python to PATH` during the installation process! After the successful installation, open a terminal (use the spotlight search - with the keyword `terminal`) and verify the installation by typing + with the keyword `terminal`) and verify the installation by typing ```bash python3 --version ``` which should result in - + ``` Python 3.12.9 ``` ---- +______________________________________________________________________ -## Step 3: :fontawesome-solid-check: Done! +

Done!

-If everything went smoothly, you have successfully installed +If everything went smoothly, you have successfully installed **:fontawesome-brands-python: Python**!
@@ -102,7 +133,7 @@ If everything went smoothly, you have successfully installed
---- +______________________________________________________________________ With **:fontawesome-brands-python: Python** installed, the next step is to set up a code editor. In the following section, we will install Visual Studio Code From 3fac3a79539d4022f00311634caa2031e98070b6 Mon Sep 17 00:00:00 2001 From: JakobKlotz Date: Wed, 25 Feb 2026 08:37:44 +0100 Subject: [PATCH 3/8] docs (fix): broken gif link --- docs/python/installation.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/docs/python/installation.md b/docs/python/installation.md index 88738969..c9041bcc 100644 --- a/docs/python/installation.md +++ b/docs/python/installation.md @@ -123,14 +123,10 @@ ______________________________________________________________________

Done!

If everything went smoothly, you have successfully installed -**:fontawesome-brands-python: Python**! +**:fontawesome-brands-python: Python**! :tada:
- +
______________________________________________________________________ From baecfda905bdfabb89296bc1d323aca2eaad581c Mon Sep 17 00:00:00 2001 From: JakobKlotz Date: Wed, 25 Feb 2026 08:58:25 +0100 Subject: [PATCH 4/8] docs: update Python installation on macOS --- docs/python/installation.md | 89 +++++++++++++++++++++++++------------ 1 file changed, 60 insertions(+), 29 deletions(-) diff --git a/docs/python/installation.md b/docs/python/installation.md index c9041bcc..b67df02f 100644 --- a/docs/python/installation.md +++ b/docs/python/installation.md @@ -23,7 +23,7 @@ ______________________________________________________________________ autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" - allowfullscreen> + allowfullscreen style="border-radius: 15px;"> @@ -31,17 +31,19 @@ ______________________________________________________________________

Step 1: :fontawesome-solid-download: Download

- We recommend installing **:fontawesome-brands-python: Python** `3.14`. + We recommend installing **:fontawesome-brands-python: Python** `3.14`! 1. Visit the official website [python.org :octicons-link-external-16:](https://www.python.org) 1. Navigate to **Downloads** - 1. Select the *Python install manager* to automatically trigger the download - 1. Once downloaded, open the MSIX file (MSIX is the Windows application - distribution format) + 1. A section **"Download for Windows"** will automatically appear + 1. Click the button **Python install manager** + 1. Locate the downloaded `.msix` file in your Downloads folder

Step 2: :fontawesome-solid-arrow-pointer: Run installer

+ 1. Double-click the `.msix` file to launch the install manager. + 1. Click **"Install Python"** to begin the installation 1. A new Terminal window will open @@ -69,9 +71,10 @@ ______________________________________________________________________ - Press ++enter++ to skip this step - The terminal will close automatically -

Step 3: :fontawesome-solid-check-circle: Verify Installation

+

Step 3: :fontawesome-solid-check-circle: Verify Installation

- 1. Open a new terminal window (use Windows search with the keyword `terminal`) + 1. Open a new terminal window (use Windows search with the keyword + `terminal`) 1. Check your installation by running: @@ -82,41 +85,69 @@ ______________________________________________________________________ 1. You should see output similar to: ``` - Python 3.14.* + Python 3.14.x ``` - where `*` represents the specific patch version. + where `x` represents the specific patch version (e.g., `3.14.3` or + `3.14.4`). === ":fontawesome-brands-apple: macOS" - ???+ tip ":fontawesome-brands-apple: Are you on Apple silicon?" - - If you are using an Apple silicon Mac (M1, ... M4), you can also pick the - `macOS 64-bit universal2 installer`. - ???+ info - Unfortunately, we do not have a installation video for macOS (yet). If you're - having any trouble, please reach out to us! + Unfortunately, we do not have a installation video for macOS (yet). + If you're having any trouble, reach out to us! + +

Step 1: :fontawesome-solid-download: Download

+ + We recommend installing **:fontawesome-brands-python: Python** `3.14`. - Nevertheless, the installation process is straightforward. Double click the - downloaded `python-3.12.9-macos11.pkg` file and follow the installation - instructions. + 1. Visit the official website + [python.org :octicons-link-external-16:](https://www.python.org) + 1. Navigate to the **Downloads** tab + 1. A section **"Download for macOS"** will automatically appear + 1. Click the **Python 3.14.x** button to download + 1. Locate the downloaded `.pkg` file in your Downloads folder - Make sure to `Add python to PATH` during the installation process! +

Step 2: :fontawesome-solid-arrow-pointer: Run installer

- After the successful installation, open a terminal (use the spotlight search - with the keyword `terminal`) and verify the installation by typing + 1. Double-click the `.pkg` file to launch the installer + 1. Follow the installation wizard: + - Click **Continue** through the introduction screens + - Accept the license agreement + - Click **Install** and enter your password if prompted + - Wait for the installation to complete + + ???+ danger + + **Important:** After installation completes, Finder will automatically open, + showing the Python installation folder. You **must** complete this final step: + + - Double-click the `Install Certificates.command` file + - A Terminal window will open and execute the certificate installation + - Wait for it to complete and close automatically + + This step is required for Python to make secure HTTPS connections. + +

Step 3: :fontawesome-solid-check-circle: Verify Installation

+ + 1. After the successful installation, open a terminal (use the spotlight + search with the keyword `terminal`) + + 1. Verify the installation by typing: + + ```bash + python3 --version + ``` - ```bash - python3 --version - ``` + 1. You should see output similar to: - which should result in + ``` + Python 3.14.x + ``` - ``` - Python 3.12.9 - ``` + where `x` represents the specific patch version (e.g., `3.14.3` or + `3.14.4`). ______________________________________________________________________ From 7c7f70e2d26d92f3e75aca0651a7791102cdaca9 Mon Sep 17 00:00:00 2001 From: JakobKlotz Date: Wed, 25 Feb 2026 09:03:11 +0100 Subject: [PATCH 5/8] docs: use a info admonition --- docs/python/installation.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/python/installation.md b/docs/python/installation.md index b67df02f..30d2b47f 100644 --- a/docs/python/installation.md +++ b/docs/python/installation.md @@ -27,7 +27,9 @@ ______________________________________________________________________ - If you prefer a written guide follow the next couple of sections. + ???+ info + + If you prefer a written guide follow the next couple of sections.

Step 1: :fontawesome-solid-download: Download

From 78ed34879fb5190767a75cacfa46173a765b161d Mon Sep 17 00:00:00 2001 From: Jakob Klotz Date: Fri, 27 Feb 2026 09:34:26 +0100 Subject: [PATCH 6/8] docs: use a info admonition for Win10 users --- docs/python/installation.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/python/installation.md b/docs/python/installation.md index 30d2b47f..47d0e5a7 100644 --- a/docs/python/installation.md +++ b/docs/python/installation.md @@ -77,6 +77,11 @@ ______________________________________________________________________ 1. Open a new terminal window (use Windows search with the keyword `terminal`) + + ???+ info + + If you are using Windows 10, search for **Command Prompt** (`cmd`) + instead of Terminal. All consecutive steps stay the same. 1. Check your installation by running: From 649eaea7faaa2a1998b0b8311a2f262eb7e84388 Mon Sep 17 00:00:00 2001 From: Jakob Klotz Date: Fri, 27 Feb 2026 09:40:32 +0100 Subject: [PATCH 7/8] docs (chore): open links in blank target --- docs/python/installation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/python/installation.md b/docs/python/installation.md index 47d0e5a7..bea17fa8 100644 --- a/docs/python/installation.md +++ b/docs/python/installation.md @@ -36,7 +36,7 @@ ______________________________________________________________________ We recommend installing **:fontawesome-brands-python: Python** `3.14`! 1. Visit the official website - [python.org :octicons-link-external-16:](https://www.python.org) + [python.org :octicons-link-external-16:](https://www.python.org){target="_blank" rel="noreferrer"} 1. Navigate to **Downloads** 1. A section **"Download for Windows"** will automatically appear 1. Click the button **Python install manager** @@ -77,7 +77,7 @@ ______________________________________________________________________ 1. Open a new terminal window (use Windows search with the keyword `terminal`) - + ???+ info If you are using Windows 10, search for **Command Prompt** (`cmd`) @@ -110,7 +110,7 @@ ______________________________________________________________________ We recommend installing **:fontawesome-brands-python: Python** `3.14`. 1. Visit the official website - [python.org :octicons-link-external-16:](https://www.python.org) + [python.org :octicons-link-external-16:](https://www.python.org){target="_blank" rel="noreferrer"} 1. Navigate to the **Downloads** tab 1. A section **"Download for macOS"** will automatically appear 1. Click the **Python 3.14.x** button to download From d507fba07529c3868508ded69117f6e9e5c79675 Mon Sep 17 00:00:00 2001 From: Jakob Klotz Date: Mon, 2 Mar 2026 16:41:24 +0100 Subject: [PATCH 8/8] docs (chore): do not display related videos --- docs/python/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/python/installation.md b/docs/python/installation.md index bea17fa8..c0c45a33 100644 --- a/docs/python/installation.md +++ b/docs/python/installation.md @@ -18,7 +18,7 @@ ______________________________________________________________________