Python installation is the process of downloading, installing, configuring, and verifying the Python programming language on a computer. Python is widely used for web development, automation, data analysis, artificial intelligence, machine learning, scripting, testing, and many other software development tasks.
For Selenium automation, Python is commonly used because it provides a simple syntax, a large ecosystem of testing libraries, and strong integration with Selenium WebDriver. Before writing Python-based Selenium automation scripts, Python must be installed and configured correctly on the system.
In this chapter, we will learn how to install Python, configure the environment, verify the installation, understand PATH, use pip, create a virtual environment, install Selenium, and troubleshoot common Python installation problems.
Python is a high-level, interpreted, general-purpose programming language. It was designed with an emphasis on readability and developer productivity.
Python programs can be written using a simple and readable syntax, making Python suitable for beginners as well as professional developers.
Selenium WebDriver supports multiple programming languages, including Python, Java, C#, JavaScript, and others. Python is one of the commonly used languages for Selenium automation because its syntax is easy to understand and Selenium provides a Python package that can be installed using pip.
A typical Python Selenium automation environment contains the following components:
Operating System
|
v
Python
|
v
pip
|
v
Selenium Package
|
v
Browser
|
v
WebDriver / Selenium Manager
|
v
Automated Web Application Testing
Before installing Python, make sure that your computer satisfies the basic requirements for the operating system and that you have permission to install software.
Python can be downloaded from the official Python website. The official documentation provides platform-specific installation instructions for Windows, macOS, and Unix-like systems.
For current Windows installations, the Python documentation describes the Python Install Manager, which can be obtained from the official Python website or Microsoft Store.
Official Python documentation:
Windows is one of the most commonly used operating systems for Selenium automation. Python can be installed on Windows using the official Python installation tools.
Open a browser and visit the official Python website:
https://www.python.org/downloads/
Download the appropriate Python installation option for your Windows system. Current Python documentation describes the Python Install Manager as the modern installation method for Windows.
Open the downloaded installer or install the Python Install Manager according to the instructions shown by Python.
After installation, the python, py, and pymanager commands may be available depending on the installation configuration.
PATH is an operating system environment variable that tells the command-line shell where executable programs can be found.
If Python is correctly configured in PATH, you can execute Python from Command Prompt or PowerShell without entering the complete installation path.
python --versionIf the command works, the terminal can locate the Python executable.
Open Command Prompt or PowerShell and execute:
python --versionYou can also use:
py --versionA successful installation displays the installed Python version.
PATH is an environment variable maintained by the operating system. It contains directories where executable programs can be searched for when a command is entered in the terminal.
For example, when you type:
pythonthe operating system searches configured locations to find the Python executable.
User enters command
|
v
python
|
v
Operating System checks PATH
|
v
Python executable found
|
v
Python interpreter starts
python and pip to be used from the terminal.After installing Python, the first verification step is checking the installed version.
python --versionAnother command that may be used on Windows is:
py --versionExample output:
Python 3.x.xThe exact version displayed depends on the Python runtime installed on your computer.
The Python interpreter allows you to execute Python statements interactively from the terminal.
Open Command Prompt or PowerShell and type:
pythonYou may see a Python prompt similar to:
>>>Now execute a simple Python statement:
print("Hello Python")Expected output:
Hello PythonTo exit the Python interpreter, you can use:
exit()A Python program is commonly stored in a file with the .py extension.
Create a file named:
hello.pyAdd the following code:
print("Hello, Python!")Save the file and open a terminal in the directory containing the file.
Run the program using:
python hello.pyOutput:
Hello, Python!pip is the package installer commonly used to install Python packages from the Python Package Index (PyPI). The Python documentation describes pip as the preferred installer program and shows usage through python -m pip.
Check whether pip is available:
python -m pip --versionYou can also try:
pip --versionUsing python -m pip explicitly associates pip with the Python interpreter being used.
python -m pip install seleniumThis is particularly useful when multiple Python versions are installed.
Keeping pip updated can help when working with modern Python packages.
python -m pip install --upgrade pipVerify the installed version:
python -m pip --versionAfter Python and pip are available, Selenium can be installed using pip.
python -m pip install seleniumThe Python packaging documentation uses the python -m pip install PackageName pattern for installing packages and their dependencies.
python -m pip show seleniumYou can also test the import:
python -c "import selenium; print(selenium.__version__)"A virtual environment creates an isolated Python environment for a project. This allows project-specific packages to be installed without unnecessarily affecting the system-wide Python environment.
Python provides the standard venv module for creating virtual environments.
python -m venv venvThis creates a directory named venv.
venv\Scripts\activateAfter activation, the terminal generally shows the environment name at the beginning of the command prompt.
deactivateA Selenium project can be organized using a separate virtual environment and source-code directory.
selenium-project/
│
├── venv/
│
├── tests/
│ ├── test_login.py
│ └── test_home.py
│
├── pages/
│ ├── login_page.py
│ └── home_page.py
│
└── requirements.txt
This structure helps keep test code organized as the automation project grows.
First activate the virtual environment:
venv\Scripts\activateThen install Selenium:
python -m pip install seleniumVerify the installation:
python -m pip show seleniumAfter installing Selenium, create a file named:
test_google.pyAdd the following code:
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://www.google.com")
print(driver.title)
driver.quit()
This program creates a Chrome browser session, opens Google, prints the page title, and closes the browser.
Python
|
v
Selenium Package
|
v
WebDriver
|
v
Browser
|
v
Web Application
|
v
Automation Actions
Modern Selenium can use Selenium Manager to assist with browser-driver management, so a simple webdriver.Chrome() setup may work without manually downloading a separate driver executable.
Python provides macOS installers through the official Python distribution. The Python documentation recommends using a current supported Python version where possible.
python3 --versionpython3 -m pip --versionpython3 -m venv venvsource venv/bin/activatepython3 -m pip install seleniumMany Linux distributions provide Python as part of the operating system or through their package management system. Care should be taken when modifying the system Python installation because operating-system tools may depend on it. Python documentation recommends virtual environments or per-user installations for many package-installation scenarios.
python3 --versionpython3 -m pip --versionpython3 -m venv venvsource venv/bin/activatepython3 -m pip install seleniumAfter completing the installation, verify each component.
| Component | Command | Purpose |
|---|---|---|
| Python | python --version |
Checks Python version |
| Python Launcher | py --version |
Checks Windows Python launcher |
| pip | python -m pip --version |
Checks package installer |
| Virtual Environment | python -m venv venv |
Creates isolated environment |
| Selenium | python -m pip show selenium |
Checks Selenium package |
Create a file named test_python.py:
name = "Selenium Student"
print("Python installation successful")
print("Welcome,", name)
Run the program:
python test_python.pyExpected output:
Python installation successful
Welcome, Selenium Student
Once Selenium has been installed, create a simple browser automation program.
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://www.google.com")
print("Page Title:", driver.title)
driver.quit()
If the browser opens successfully and the page title is printed, the basic Python and Selenium environment is working.
This usually indicates that the Python command is not available through the current command environment.
Try:
py --versionIf py works but python does not, review the Python installation and command configuration.
Instead of calling pip directly, use:
python -m pip --versionIf pip is not installed in an environment where it should be, Python documentation provides ensurepip as one possible mechanism for bootstrapping pip.
python -m ensurepip --default-pipIf multiple Python versions are installed, explicitly select the required version using the available Python launcher or version-specific command.
For example, on Windows:
py -3 --versionThe Python documentation recommends using the Windows py launcher for scenarios involving multiple Python runtimes.
First check Python:
python --versionThen check pip:
python -m pip --versionThen upgrade pip:
python -m pip install --upgrade pipFinally try:
python -m pip install seleniumDepending on the operating system and installation configuration, Python may be invoked using different commands.
| Environment | Common Command |
|---|---|
| Windows | python |
| Windows Launcher | py |
| macOS | python3 |
| Linux | python3 |
The exact command can depend on the operating system and local configuration.
A basic Selenium Python environment can be represented as:
Computer
|
+-- Python
|
+-- pip
|
+-- Virtual Environment
|
+-- Selenium
|
+-- Browser
|
+-- Selenium Manager / Driver
|
+-- Automation Script
For professional projects, dependencies can be stored in a requirements.txt file.
Example:
seleniumInstall the dependencies using:
python -m pip install -r requirements.txtThis allows a project environment to be recreated more easily.
To display installed packages, use:
python -m pip listTo display information about a specific package:
python -m pip show seleniumTo save installed packages into a requirements file:
python -m pip freeze > requirements.txtpython -m pip when package-to-interpreter association matters.For Selenium automation, a clean setup can follow this sequence:
Step 1: Install Python
|
v
Step 2: Verify Python
|
v
Step 3: Verify pip
|
v
Step 4: Create Project
|
v
Step 5: Create Virtual Environment
|
v
Step 6: Activate Virtual Environment
|
v
Step 7: Install Selenium
|
v
Step 8: Create Automation Script
|
v
Step 9: Launch Browser
|
v
Step 10: Execute Automation Test
Create a project folder:
mkdir selenium-project
cd selenium-project
Create a virtual environment:
python -m venv venvActivate it on Windows:
venv\Scripts\activateInstall Selenium:
python -m pip install seleniumCreate a Python file:
test_browser.pyAdd:
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://www.google.com")
print("Title:", driver.title)
driver.quit()
Run:
python test_browser.pyThe Python interpreter is the software component that reads and executes Python code.
Python Source Code
|
v
Python Interpreter
|
v
Execution
|
v
Program Output
For Selenium, the Python interpreter executes the automation script, while the Selenium library communicates with the browser automation infrastructure.
A Python package is a collection of reusable Python modules and resources. Packages allow developers to add functionality without implementing everything from scratch.
Selenium is installed as a Python package.
python -m pip install seleniumAfter installation, Python code can import Selenium modules:
from selenium import webdriver| Python Installation | Selenium Installation |
|---|---|
| Installs Python interpreter | Installs Selenium Python package |
| Provides Python runtime | Provides browser automation APIs |
Verified using python --version |
Verified using python -m pip show selenium |
| Required before installing Selenium | Required for Python-based Selenium automation |
Virtual environments provide isolation between projects. For example, one Selenium project can have one set of dependencies while another project can use different dependency versions.
Project A
|
+-- venv
+-- Selenium
+-- Project Dependencies
Project B
|
+-- venv
+-- Selenium
+-- Other Dependencies
This reduces dependency conflicts and helps keep projects reproducible. Python's documentation recommends creating a virtual environment for each project in its Windows setup guidance.
If the terminal cannot find Python, first determine whether the installation is available through another command.
python --versionOn Windows, also try:
py --versionOn macOS or Linux, try:
python3 --versionIf none of these commands work, review the Python installation and command configuration.
Check pip using the Python interpreter:
python -m pip --versionUpgrade pip:
python -m pip install --upgrade pipInstall Selenium:
python -m pip install seleniumIf you are using a virtual environment, make sure that it is activated before installing project dependencies.
Python is a high-level, interpreted, general-purpose programming language widely used in software development, automation, testing, data analysis, and other areas.
Python provides simple syntax, a large ecosystem, and a Selenium package that makes browser automation development straightforward.
pip is a Python package installer used to install and manage Python packages.
python --versionpython -m pip --versionpython -m pip install seleniumA virtual environment is an isolated Python environment used to manage project-specific packages and dependencies.
python -m venv venvvenv\Scripts\activatedeactivateA professional Selenium automation project can contain multiple test cases, page objects, utilities, configuration files, reports, and dependency definitions.
selenium-automation/
│
├── venv/
│
├── tests/
│ ├── test_login.py
│ ├── test_search.py
│ └── test_checkout.py
│
├── pages/
│ ├── login_page.py
│ ├── home_page.py
│ └── checkout_page.py
│
├── utils/
│ └── helpers.py
│
├── requirements.txt
│
└── README.md
Python installation is the foundation of this environment because the test scripts and Selenium package run through the Python interpreter.
requirements.txt file.| Task | Command |
|---|---|
| Check Python | python --version |
| Check Windows Python Launcher | py --version |
| Check Python 3 | python3 --version |
| Check pip | python -m pip --version |
| Upgrade pip | python -m pip install --upgrade pip |
| Create virtual environment | python -m venv venv |
| Activate Windows environment | venv\Scripts\activate |
| Activate macOS/Linux environment | source venv/bin/activate |
| Deactivate environment | deactivate |
| Install Selenium | python -m pip install selenium |
| Show Selenium information | python -m pip show selenium |
| List installed packages | python -m pip list |
| Save dependencies | python -m pip freeze > requirements.txt |
| Install requirements | python -m pip install -r requirements.txt |
If you want to learn Selenium in a structured way, you can explore the Selenium training course:
JustAcademy Selenium Training Course
You can also register for a course demo:
Register for Selenium Course Demo
Installing Python is the first major step toward creating a Python-based Selenium automation environment. The installation process includes obtaining Python from an official source, configuring the command environment, verifying Python, checking pip, and creating an isolated virtual environment for automation projects.
After Python is installed, Selenium can be installed using pip. A clean Selenium environment can then be used to create browser automation scripts, execute test cases, implement Page Object Model, manage dependencies, and develop complete automation frameworks.
Install Python
|
v
Verify Python
|
v
Verify pip
|
v
Create Virtual Environment
|
v
Activate Environment
|
v
Install Selenium
|
v
Create Selenium Script
|
v
Launch Browser
|
v
Automate Web Application
After completing this topic, you should be able to:
