Course: Python Training Course
Topic: Installing and Configuring Python
Course Link: Python Training Course – JustAcademy
Demo Link: Register for a Free Course Demo
Website: JustAcademy Official Website
Python is a popular, high-level programming language used in web development, automation, data analysis, artificial intelligence, machine learning, and software development. Before writing and executing Python programs, developers need to install Python or access an appropriate Python environment and configure it correctly.
Installing Python means setting up the Python interpreter and related tools on a computer. Configuring Python involves making the interpreter accessible, selecting an appropriate development environment, organizing project dependencies, and verifying that programs execute correctly.
A correct setup helps beginners avoid common errors such as commands not being recognized, incorrect interpreter selection, missing packages, and conflicts between project dependencies.
The Python interpreter is the software responsible for executing Python code. It reads Python instructions and runs them according to the implementation being used. The interpreter allows developers to test expressions interactively or execute complete program files.
Python programs are commonly saved in files with the .py extension. For example, a file named hello.py may contain the following code:
print("Hello, Python!")When this file is executed through the Python interpreter, the output is:
Hello, Python!Before installing Python, confirm that your operating system is supported and that you have permission to install software. Exact requirements vary by Python release and operating system.
| Requirement | Description |
|---|---|
| Operating system | A supported version of Windows, macOS, or Linux. |
| Processor | A compatible processor supported by the selected Python distribution. |
| Memory | Sufficient RAM to run the interpreter, editor, and intended development tools. |
| Storage | Free disk space for Python, development tools, libraries, and project files. |
| Permissions | Permission to install software or access an approved installation location. |
| Internet connection | Usually required to download the installer and packages, although offline installation is possible. |
| Code editor | An editor such as Visual Studio Code, PyCharm, or a basic text editor. |
Best practice: Choose a Python version supported by your operating system, development tools, and project dependencies. For new projects, use a currently supported Python 3 release rather than an obsolete Python 2 release.
The official Python website provides installers, source code, and installation guidance. Download Python from the official source whenever possible to reduce the risk of obtaining modified or unsafe installation files.
Official download page: Download Python
Do not download an installer simply because it has the highest version number. Confirm that the release is compatible with your computer and any libraries or applications you need to use.
Windows users can generally install Python through the official installer or an approved package-management method. The graphical installer is a convenient option for beginners.
Open Command Prompt and run:
python --versionOn Windows, the Python launcher may also be available:
py --versionA successful command displays the installed Python version, for example:
Python 3.x.yThe exact version number depends on the release you installed. If one command is not recognized, try the other available command and check your installation settings.
pip is the standard package installer commonly used to install third-party Python packages.
python -m pip --versionIf you use the Windows Python launcher, you can also try:
py -m pip --versionUsing python -m pip helps ensure that pip runs through the interpreter associated with the selected Python command.
macOS users can install Python through the official macOS installer or a package manager. The appropriate approach depends on the developer's environment and project requirements.
Run:
python3 --versionTo check pip, run:
python3 -m pip --versionOn many macOS systems, python3 is the appropriate command for a Python 3 installation. Do not assume that the command python points to the Python version you intend to use.
Developers who use Homebrew may choose to install Python through it. Homebrew is a third-party package manager, not part of the Python language itself.
brew --version
brew install python3The first command checks whether Homebrew is available. If it is not installed, follow the official instructions at Homebrew's website. Package names and commands can vary by package-manager version, so consult the current documentation when necessary.
After installation, verify the Python command and interpreter path:
python3 --version
which python3Many Linux distributions provide Python through their package managers. Python may already be installed because operating-system tools or applications depend on it. Before changing the system installation, check which version is available.
python3 --version
which python3If Python is already available, you may not need another system-wide installation. You can often create a virtual environment for your project using the existing interpreter.
On Ubuntu or Debian-based systems, you can use APT to install Python and related tools. The exact package version depends on your distribution's repositories.
sudo apt update
sudo apt install python3 python3-pip python3-venvThese commands refresh package information and install Python 3, pip, and virtual-environment support where those packages are available.
On Fedora systems, DNF can be used to install Python packages:
sudo dnf install python3 python3-pipPackage availability and exact package names may vary by Fedora release.
python3 --version
python3 -m pip --versionImportant: Avoid replacing or removing the system-managed Python interpreter without understanding the consequences. Some Linux tools rely on the distribution's Python environment. Use virtual environments or a separate development installation when you need an isolated project setup.
The PATH environment variable contains directories that the operating system searches when a user enters a command in a terminal. If the Python executable is not accessible through PATH, typing python or python3 may fail even when Python is installed.
In Command Prompt, run:
where python
where pyThese commands show matching executable locations when available. In PowerShell, you can also run:
Get-Command python
Get-Command pyTo inspect the PATH environment variable in Command Prompt:
echo %PATH%which python3
echo "$PATH"The which command commonly reports the executable found through PATH. Some shells also provide the command -v command:
command -v python3python --version and python -m pip --version again.Installation paths differ between users, installation methods, and Python releases. Use the actual directories on your computer rather than copying an example path blindly. Avoid deleting unrelated PATH entries.
Interactive mode allows you to enter Python statements directly into the interpreter and see the results immediately. It is useful for learning syntax, testing expressions, and experimenting with built-in functions.
On Windows, try:
pythonAlternatively, if the Python launcher is available:
pyOn macOS or Linux, try:
python3A Python prompt commonly appears as >>>. You can now type Python expressions.
>>> 10 + 5
15
>>> print("Learning Python")
Learning Python
>>> name = "Asha"
>>> print(name)
AshaTo leave the interactive interpreter, you can use:
exit()Depending on your terminal and operating system, keyboard shortcuts such as Ctrl+Z followed by Enter on Windows or Ctrl+D on macOS/Linux may also exit the interpreter.
Although interactive mode is useful for quick tests, most applications are written in script files. A script can contain multiple statements and can be saved, reused, tested, and shared.
hello.py.print("Hello, Python!")
print("Python is installed and ready to use.")
print(5 + 7)Open Command Prompt or PowerShell and navigate to the directory containing the file.
cd path\to\your\project
python hello.pyIf your setup uses the Python launcher, you can run:
py hello.pycd path/to/your/project
python3 hello.pyHello, Python!
Python is installed and ready to use.
12Replace the example directory with the actual location where you saved your file. If the terminal reports that the file cannot be found, verify the current working directory and the filename.
A code editor helps developers write and organize Python code. An integrated development environment (IDE) may also provide debugging, project management, testing tools, and other development features.
| Tool | Description | Suitable For |
|---|---|---|
| Visual Studio Code | A flexible code editor that supports Python through extensions. | Beginners, web development, scripting, and general-purpose projects. |
| PyCharm | An IDE designed for Python development, with code navigation and debugging features. | Structured Python projects and larger applications. |
| IDLE | A basic Python development environment included with many standard Python installations. | Learning Python and running small examples. |
| JupyterLab | An interactive environment for notebooks, code, explanatory text, and data analysis. | Data science, experimentation, and education. |
| Terminal or command line | Allows direct interpreter execution and command-line workflows. | Automation, scripting, server work, and development operations. |
.py file.Installing the Python extension does not necessarily install Python itself. Confirm that an interpreter is installed and select the correct one in the editor.
A Python package contains reusable code that can be installed and imported into a project. Packages extend Python's capabilities and may provide tools for web development, data processing, testing, visualization, and many other tasks.
pip is the standard package installer used with many Python installations. It downloads and installs packages from configured package indexes, commonly the Python Package Index (PyPI).
Official package index: Python Package Index (PyPI)
python -m pip --versionOn macOS or Linux, use the appropriate Python 3 command if needed:
python3 -m pip --versionFor example, to install the requests package into the currently selected Python environment, run:
python -m pip install requestsOn macOS or Linux, the corresponding command may be:
python3 -m pip install requestspython -m pip listpython -m pip show requestspython -m pip install --upgrade requestsInstall packages only from sources you trust. Review compatibility requirements and avoid installing unnecessary packages into a global environment.
A virtual environment is an isolated Python environment for a particular project. It keeps project-specific packages separate from packages used by other projects and helps reduce dependency conflicts.
mkdir python-project
cd python-projectRun the following command from the project directory:
python -m venv .venvOn macOS or Linux, use python3 -m venv .venv if that is the command for your Python installation.
For Command Prompt:
.venv\Scripts\activate.batFor PowerShell:
.venv\Scripts\Activate.ps1If PowerShell blocks the activation script, review your organization's security policy and Microsoft's guidance before changing execution-policy settings. You can use Command Prompt or invoke the environment's Python executable directly as an alternative.
source .venv/bin/activateAfter activation, the environment name often appears at the start of the terminal prompt.
python -m pip install requestsWhen the environment is activated, this command installs the package into that environment, assuming the terminal's python command points to the environment interpreter.
deactivateDeactivation returns the terminal to its previous environment context. It does not delete the virtual environment or its installed packages.
A virtual environment is usually recreated on another computer instead of being committed to source control. Add the following entry to a project's .gitignore file:
.venv/Dependencies are external packages that a project requires to operate. Documenting dependencies helps developers reproduce the project's environment and collaborate with other team members.
After installing the packages required by your project in its virtual environment, run:
python -m pip freeze > requirements.txtThis writes the environment's installed package versions to requirements.txt. For larger projects, ensure the environment contains only the dependencies you intend to document.
python -m pip install -r requirements.txtRun this command with the intended project's virtual environment active. The file should be reviewed and maintained so that unnecessary or incompatible dependencies are not introduced.
requests==2.32.0This is an illustrative version pin. Choose package versions that are compatible with your project, and verify current releases and security requirements before using them in production.
Developers may have multiple Python versions installed on the same computer. Different projects may require different versions because of compatibility constraints or deployment requirements.
On Windows, use:
where python
py --listThe available launcher options may vary with the installed Python launcher version.
On macOS or Linux, use:
which python3
python3 --versionInside Python, you can inspect the executable currently running:
import sys
print(sys.version)
print(sys.executable)When a package appears to be missing, verify the interpreter path and use that interpreter to run pip. For example, use python -m pip install package_name rather than assuming a standalone pip command targets the correct environment.
Python can support a variety of development workflows. The basic interpreter setup remains similar, but the packages, tools, and environment configuration may differ by project type.
| Development Area | Common Tools or Packages | Configuration Considerations |
|---|---|---|
| Web development | Django, Flask, FastAPI | Use a virtual environment, configure application settings, and manage development dependencies. |
| Data analysis | pandas, NumPy | Install compatible packages and consider using JupyterLab or notebooks. |
| Machine learning | scikit-learn and other specialized libraries | Check supported Python versions and any platform-specific installation requirements. |
| Automation | Standard library modules, requests, and task-specific packages | Configure file permissions, paths, and credentials safely. |
| Testing | pytest and other testing tools | Install test dependencies in the project environment and organize test files. |
| API development | FastAPI, Flask, HTTP clients | Configure dependencies, local ports, environment variables, and application settings. |
| Error or Symptom | Possible Cause | Solution |
|---|---|---|
python is not recognized |
Python is not installed, or its location is not available through PATH. | Verify installation, try the available Python launcher, and correct PATH if necessary. |
python3: command not found |
The command is unavailable or Python 3 is not installed under that name. | Check the operating system's installation method and locate the correct executable. |
pip is not recognized |
pip may be missing or its Scripts directory may not be available through PATH. | Try python -m pip --version or the equivalent command for your interpreter. |
No module named package_name |
The package is not installed in the active interpreter's environment. | Activate the correct virtual environment and install the package with that interpreter's pip. |
| Wrong Python version displayed | Multiple installations or a different PATH order may select another interpreter. | Check executable locations and explicitly select the intended interpreter. |
| Permission denied | The user may lack permission to write to the selected installation location. | Use an approved user-level environment or virtual environment rather than changing system permissions indiscriminately. |
| Package installation fails | Network, compatibility, package-index, or build-tool issues may be involved. | Read the complete error message, verify compatibility, and follow the package's official installation instructions. |
| Virtual environment activation fails | The command may be incorrect for the shell, or script execution may be restricted. | Use the correct shell-specific command and review the applicable security settings. |
| Editor runs a different interpreter | The editor has selected a different environment from the terminal. | Select the correct interpreter in the editor and verify its executable path. |
| Script cannot be found | The terminal is in a different directory or the filename is incorrect. | Navigate to the correct folder and check the file's exact name and extension. |
python -m pip or the equivalent command to install packages through the intended interpreter.Objective: Install Python, verify its configuration, create a virtual environment, and execute a Python program.
Open your terminal and run the appropriate version command for your operating system.
python --versionIf this command is unavailable, try py --version on Windows or python3 --version on macOS/Linux, as applicable.
mkdir python-practice
cd python-practicepython -m venv .venvUse the appropriate Python 3 command if your system requires it.
Use the activation command that matches your operating system and shell.
python -m pip --versionCreate a file named setup_check.py with the following code:
import sys
import platform
print("Python setup check")
print("Python version:", sys.version)
print("Python executable:", sys.executable)
print("Operating system:", platform.system())
print("Setup completed successfully.")python setup_check.pyReview the output to confirm that the expected Python interpreter is running and that the operating system is identified correctly.
If your project has installed dependencies, create a requirements file:
python -m pip freeze > requirements.txtFor a project with no third-party dependencies, the file may be empty. That is acceptable.
Build a small program that displays details about the current Python environment. This project reinforces the use of the standard library and helps confirm that Python is working correctly.
import sys
import platform
import os
def display_environment():
print("=== Python Environment Information ===")
print("Python version:", sys.version.split()[0])
print("Python executable:", sys.executable)
print("Operating system:", platform.system())
print("Operating system version:", platform.version())
print("Current directory:", os.getcwd())
if __name__ == "__main__":
display_environment()sys.version provides information about the running Python version.sys.executable identifies the interpreter executable.platform.system() identifies the operating-system family.platform.version() returns operating-system version information.os.getcwd() returns the current working directory.if __name__ == "__main__": condition runs the function when the file is executed directly.The program prints environment details for the computer on which it runs. Exact output varies according to the operating system, Python release, installation location, and current directory.
Answer: Python installation is the process of setting up the Python interpreter and related components so that Python programs can be executed on a computer.
Answer: The Python interpreter processes and executes Python code. It supports running scripts and evaluating statements in interactive mode.
Answer: PATH is an environment variable containing directories that the operating system searches when locating executable commands.
python fail after installation?Answer: Python may not be installed correctly, its directory may not be on PATH, or the system may use a different command such as python3 or py.
Answer: pip is a package installer commonly used to download and install Python packages and their dependencies.
Answer: Run an appropriate terminal command, such as python --version, python3 --version, or py --version, depending on the installation.
Answer: A virtual environment is an isolated Python environment that allows a project to use its own installed packages without mixing them with other projects' dependencies.
Answer: Run python -m venv .venv from the project directory, or use the appropriate Python 3 command for the system.
python -m pip?Answer: It runs pip through the selected Python interpreter, helping ensure that packages are installed into the intended environment.
Answer: Interactive mode executes statements entered directly into the Python shell, while script execution runs code saved in a file, usually with a .py extension.
Answer: The editor may be using a different Python interpreter or virtual environment from the one where the package was installed.
Answer: Yes. Developers can install multiple versions, but they should verify which interpreter is selected for each project.
Answer: It is a text file commonly used to record Python package dependencies, often including version specifications, so an environment can be recreated more consistently.
Answer: Usually not without a clear reason. System tools may depend on the distribution-managed Python installation. Virtual environments are often safer for project-specific dependencies.
Answer: Run import sys; print(sys.executable) inside Python to display the executable path.
.py files for reusable programs.Installing and configuring Python is the foundation of Python programming. A reliable setup includes a compatible Python interpreter, a working terminal command, a suitable code editor, package-management tools, and a clear approach to project dependencies.
By learning how to verify Python, manage PATH, run scripts, select interpreters, install packages, and create virtual environments, beginners can establish a development environment that supports both small practice programs and larger professional applications.
Continue learning through the Python Training Course at JustAcademy, explore course options through the course demo registration page, or visit the JustAcademy website.
