diff --git a/INSTALLING.md b/INSTALLING.md index fedfe5f..7466b77 100644 --- a/INSTALLING.md +++ b/INSTALLING.md @@ -2,6 +2,8 @@ A comprehensive guide to setting up Python and Visual Studio Code across Windows, macOS, and Linux. +You can use online IDE, recommended using @Ericwasepic127's [SUPY3IDE](https://ericwasepic127.github.io/ide.html) + ## Contents - [Windows Installation](#windows-installation) - [macOS Installation](#macos-installation) @@ -84,4 +86,70 @@ Get your development environment ready by installing Visual Studio Code for your * **macOS:** Follow the official macOS Setup Guide. * **Linux:** Follow the official Linux Setup Guide for .deb, .rpm, or Snap packages. -Contributed by @Ericwasepic127 \ No newline at end of file +Contributed by @Ericwasepic127 +### Method 2: Using the Direct Executable Installer +> ⚠️ **Note:** Standard `.exe` direct installers are deprecated starting from Python 3.15. For newer versions, please use Method 1. + +1. Navigate to the official [Python Downloads page](https://python.org/downloads/). +2. Select the latest release, or download the [recommended Python 3.13 version](https://www.python.org/downloads/release/python-313/). +3. Download the **Windows installer** executable (`.exe`). +4. Double-click the downloaded file to run the installer. +5. **Crucial:** Ensure you check the box that says **"Add Python to PATH"** before clicking install, then follow the remaining prompts. + +--- + +## macOS Installation + +1. **Download the Installer:** Visit the official [Python Downloads page](https://python.org/downloads/) and download the macOS installer package (`.pkg`). The [recommended version is 3.13](https://www.python.org/downloads/release/python-313/). +2. **Run the Installer:** Open the downloaded `.pkg` file and follow the on-screen installation steps. You will be prompted to enter your Mac's administrator password. +3. **Install Certificates:** + - Once complete, open your `Applications` folder and locate the newly created `Python 3.x` directory. + - Double-click the `Install Certificates.command` file. *This step is required to ensure Python can securely connect to the internet.* + +--- + +## Linux Installation (using pyenv) + +For Linux distributions, we recommend using `pyenv`, a robust Python environment manager that functions similarly to Windows' Install Manager. + +### 1. Install Dependencies +Open your terminal and run the appropriate command for your package manager to install the required build dependencies: + +* **Ubuntu / Debian / Mint:** + ```bash + sudo apt update + sudo apt install -y git make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev``` + + +* **Fedora / RHEL / CentOS:** + ```bash + sudo dnf groupinstall "Development Tools" + sudo dnf install git openssl-devel bzip2-devel libffi-devel readline-devel sqlite-devel xz-devel tk-devel``` + +* **Arch Linux:** + ```bash + sudo pacman -S --needed base-devel + sudo pacman -S git openssl zlib bzip2 readline sqlite3 libffi xz tk + ``` +### 2. Install and Configure pyenv + 1. Run the automatic installer script: + ```bash + curl [https://pyenv.run](https://pyenv.run) | bash + ``` +2. Follow the instructions printed in the terminal to add pyenv to your shell profile configurations (e.g., .bashrc or .zshrc). +3. Restart your terminal or source your profile to apply the changes. + +### 3. Install Python +Install your desired version using pyenv. We recommend version 3.13: +```bash +pyenv install 3.13 +pyenv global 3.13 +``` + +## Visual Studio Code Installation +Get your development environment ready by installing Visual Studio Code for your platform: + * **Windows:** Download via the Microsoft Store Link. + * **macOS:** Follow the official macOS Setup Guide. + * **Linux:** Follow the official Linux Setup Guide for .deb, .rpm, or Snap packages. + +Contributed by @Ericwasepic127 diff --git a/README.md b/README.md index 55ec821..b30f000 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ This repository is designed to help Python learners at all levels, starting with - See the [Python & VS Code Installation Guide](INSTALLING.md) to install python by step by step. Visual Studio Code installation steps are also included in this. > [!TIP] -> We use Visual Studio Code. It's fast, efficient, and has many extensions and customizability options. +> We use Visual Studio Code. It's fast, efficient, and has many extensions and customizability options. You can also use @Ericwasepic127's [SUPY3IDE](https://ericwasepic127.github.io/ide.html) ## Project Difficulty Ratings