Getting Your Python Environment Ready

Before you can start writing Python code, you need to set up your development environment properly. This lesson will guide you through installing Python, selecting an IDE (Integrated Development Environment), and running your first scripts.

Why Installation Matters

A proper setup ensures:

• Consistency: Your code runs the same way every time
• Efficiency: Good tools make you productive from day one
• Confidence: You know exactly where Python lives and how to access it
• Future-Proofing: Easy to upgrade and manage packages

What You'll Learn

1. How to install Python on Windows, macOS, and Linux
2. Verifying your Python installation works correctly
3. Choosing and setting up the best IDE for beginners
4. Running Python in three different ways (shell, scripts, IDE)
5. Troubleshooting common installation problems
6. Best practices for organizing your Python projects

Installing Python

Python runs on all major operating systems. Follow the instructions for your platform.

Windows Installation

Step-by-Step Guide:

1. Download Python:

   • Visit python.org/downloads
   • Click "Download Python 3.12" (or latest version)
   • Download the Windows installer (64-bit recommended)

2. Run the Installer:

• Double-click the downloaded installer
• ✅ Check "Add Python to PATH" (very important!)
• Click "Install Now" for standard installation
• Wait 2-3 minutes for installation to complete
• Click "Close" when finished

1. Verify Installation:

   • Press Windows Key + R, type cmd, press Enter
   • In Command Prompt, type:
   bash

   Copy

   python --version

   • Expected output: Python 3.12.0 (or your version)

macOS Installation

Step-by-Step Guide:

Option 1: Official Installer (Easier)

1. Visit python.org/downloads
2. Download the macOS installer
3. Open the .pkg file
4. Follow the installation wizard
5. Enter your password when prompted

Option 2: Homebrew (Recommended for Developers)

Homebrew is a package manager that makes installing tools easier.

1. Install Homebrew (if not installed):

   • Open Terminal (Applications → Utilities → Terminal)
   • Visit brew.sh and follow instructions
   • Or run:
   bash

   Copy

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install Python via Homebrew:

   bash

   Copy

   brew install python3

3. Verify Installation:

   bash

   Copy

   python3 --version

   Expected: Python 3.12.0

Linux Installation

Most Linux distributions include Python, but you may need to install Python 3.

Ubuntu/Debian:

# Update package list
sudo apt update
# Install Python 3 and pip (package manager)
sudo apt install python3 python3-pip python3-venv
# Verify installation
python3 --version

Fedora/RHEL/CentOS:

# Install Python 3
sudo dnf install python3 python3-pip
# Verify
python3 --version

Arch Linux:

# Install Python 3
sudo pacman -S python python-pip
# Verify
python --version

Choosing an IDE or Code Editor

An IDE (Integrated Development Environment) provides tools to write, run, and debug code efficiently. Here are the best options for Python beginners:

1. VS Code (Highly Recommended for Beginners)

Why VS Code?

• ✅ Free and open-source
• ✅ Lightweight but powerful
• ✅ Excellent Python extension
• ✅ Integrated terminal
• ✅ Auto-completion and IntelliSense
• ✅ Used by professionals worldwide

Installation Steps:

1. Download from code.visualstudio.com
2. Install VS Code (follow platform-specific instructions)
3. Launch VS Code
4. Click Extensions icon (left sidebar) or press Ctrl+Shift+X
5. Search for "Python"
6. Install "Python" extension by Microsoft (has 50M+ downloads)
7. Reload VS Code if prompted

First-Time Setup:

1. Create a new file: File → New File
2. Save it as hello.py (the .py extension activates Python features)
3. VS Code will prompt you to select a Python interpreter
4. Choose the Python 3.x version you installed

2. PyCharm Community Edition (Feature-Rich)

Why PyCharm?

• ✅ Purpose-built for Python development
• ✅ Intelligent code completion
• ✅ Powerful built-in debugger
• ✅ Project management
• ✅ Free Community Edition

Installation Steps:

1. Download from jetbrains.com/pycharm/download
2. Choose "Community Edition" (free)
3. Install and launch PyCharm
4. Create a new project
5. Select Python interpreter (PyCharm auto-detects)

3. IDLE (Perfect for Absolute Beginners)

Why IDLE?

• ✅ Comes pre-installed with Python
• ✅ Zero setup required
• ✅ Simple and distraction-free
• ✅ Interactive shell built-in

How to Launch:

• Windows: Search "IDLE" in Start menu
• macOS: Open Terminal, type idle3
• Linux: Type idle3 or idle in terminal

4. Jupyter Notebook (For Interactive Learning)

Why Jupyter?

• ✅ Run code in cells (experiment easily)
• ✅ Mix code, text, and visuals
• ✅ Popular in data science
• ✅ Great for tutorials and learning

Installation:

# Install Jupyter
pip install jupyter
# Launch Jupyter Notebook
jupyter notebook

Running Python Code - Three Methods

Understanding different ways to run Python helps you work efficiently in various scenarios.

Method 1: Interactive Python Shell (REPL)

The Python shell lets you type code and see results instantly-perfect for learning and experimenting.

How to Access the REPL:

# Windows
python
# macOS/Linux
python3

What You'll See:

Python 3.12.0 (main, Oct 2024)
Type "help", "copyright", "credits" or "license" for more information.
>>>

The >>> prompt means Python is waiting for your command.

Try These Examples:

>>> print("Hello, Python!")
Hello, Python!
>>> 2 + 2
4
>>> name = "Alex"
>>> print(f"Hello, {name}!")
Hello, Alex!
>>> # You can use Python as a calculator
>>> 15 * 7
105
>>> # Get help on any function
>>> help(print)

Exit the REPL:

• Type exit() and press Enter
• Or press Ctrl+D (macOS/Linux) or Ctrl+Z then Enter (Windows)

When to Use the REPL:

• ✅ Quick calculations and math
• ✅ Testing syntax you're unsure about
• ✅ Experimenting with new functions
• ✅ Learning Python interactively

Method 2: Running Script Files (.py)

Scripts are files containing Python code that you can run repeatedly. This is how most Python programs work.

Creating Your First Script:

1. Create a file called hello.py:

# hello.py - My first Python script
print("Hello, World!")
print("Welcome to Python programming!")
# Variables work in scripts too
name = "Learner"
print(f"Hello, {name}!")
# Basic calculation
result = 10 + 5
print(f"10 + 5 = {result}")

1. Save the file with a .py extension

2. Navigate to the file's directory:

# Windows
cd Documents\PythonProjects
# macOS/Linux
cd ~/Documents/PythonProjects

1. Run the script:

# Windows
python hello.py
# macOS/Linux
python3 hello.py

Expected Output:

Hello, World!
Welcome to Python programming!
Hello, Learner!
10 + 5 = 15

When to Use Scripts:

• ✅ Programs you want to save and reuse
• ✅ Automation tasks
• ✅ Complete applications
• ✅ Production code

Method 3: Running Code in an IDE

IDEs make running code as simple as clicking a button.

In VS Code:

1. Open or create a .py file
2. Write your code
3. Click the ▶️ (Run) button in the top-right
4. Output appears in the integrated terminal

In PyCharm:

1. Open or create a .py file
2. Write your code
3. Right-click anywhere in the file
4. Select "Run 'filename'" or press Shift+F10

In IDLE:

1. Create a new file: File → New File
2. Write your code
3. Save the file (Ctrl+S)
4. Press F5 or click Run → Run Module

When to Use IDE:

• ✅ During active development
• ✅ When using debugging tools
• ✅ Working on large projects
• ✅ Want integrated features (auto-complete, error detection)

Understanding Python Versions

Python 2 vs Python 3

Key Differences:

• Python 2: print "Hello" (no parentheses)
• Python 3: print("Hello") (function call)

How to Check Which Version You're Using:

python --version

If it shows Python 2.x, use python3 instead:

python3 --version

Minor Versions (3.8, 3.9, 3.10, 3.11, 3.12)

Recommendation: Use Python 3.10 or newer for the best features and performance.

Checking Your Version:

import sys
print(f"Python {sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}")

Project Organization Best Practices

Recommended Folder Structure

Documents/
└── PythonProjects/
    ├── lesson01/
    │   ├── hello.py
    │   └── check_installation.py
    ├── lesson02/
    │   └── variables.py
    └── practice/
        └── experiments.py

Naming Conventions

Python File Names:

• ✅ Use lowercase: calculator.py
• ✅ Use underscores for spaces: student_grades.py
• ✅ Be descriptive: temperature_converter.py
• ❌ Avoid: Test1.py, new.py, asdf.py

Common Installation Problems & Solutions

Problem 1: "Python is not recognized as a command"

Symptom: When you type python --version in Command Prompt, you get:

'python' is not recognized as an internal or external command

Cause: Python wasn't added to your system PATH

Solution (Windows):

1. Search for "Environment Variables" in the Start menu
2. Click "Environment Variables"
3. Under "System variables", find and select "Path"
4. Click "Edit"
5. Click "New" and add: C:\Users\YourUsername\AppData\Local\Programs\Python\Python312
6. Click "OK" on all windows
7. Close and reopen Command Prompt
8. Try python --version again

Problem 2: "python3: command not found" (macOS/Linux)

Cause: Python 3 isn't installed or uses a different command name

Solution:

# Check if python3 exists
which python3
# If not found, install it
# macOS:
brew install python3
# Ubuntu/Debian:
sudo apt install python3
# Try again:
python3 --version

Problem 3: Code Runs But Shows No Output

Cause: Forgot to use print() in your script file

Wrong:

# script.py
2 + 2  # This calculates but doesn't display

Correct:

# script.py
result = 2 + 2
print(result)  # Now it displays!

Problem 4: "Cannot Find File or Directory"

Cause: Your terminal is in the wrong folder

Solution:

# Find your current location
pwd  # macOS/Linux
cd   # Windows (shows current directory)
# Navigate to your script's location
cd Documents/PythonProjects
# List files to verify your script is there
ls    # macOS/Linux
dir   # Windows
# Now run your script
python3 hello.py

Quick Reference Commands

Essential Commands

# Check Python version
python --version         # Windows
python3 --version        # macOS/Linux
# Launch interactive Python shell
python                   # Windows
python3                  # macOS/Linux
# Run a Python script
python script.py         # Windows
python3 script.py        # macOS/Linux
# Install a package
pip install package_name    # Windows
pip3 install package_name   # macOS/Linux
# Upgrade pip (Python's package installer)
python -m pip install --upgrade pip        # Windows
python3 -m pip install --upgrade pip       # macOS/Linux

Terminal Navigation

# Show current directory
pwd              # macOS/Linux
cd               # Windows
# Change directory
cd folder_name
# Go up one level
cd ..
# List files in current directory
ls               # macOS/Linux
dir              # Windows

What's Next?

Congratulations on setting up Python! Now you're ready to:

1. ✅ Write your first Python programs
2. ✅ Experiment in the interactive shell
3. ✅ Use your IDE's features
4. ✅ Start learning Python syntax

Your Next Steps

1. Practice running code in all three methods (REPL, scripts, IDE)
2. Get familiar with your IDE - explore the features
3. Create a project folder to organize your learning
4. Move to the next lesson to start writing real Python code!

The setup might feel overwhelming at first, but you only do it once. From now on, it's all about learning to code! 🚀

Set up your Python development environment from scratch. Learn how to install Python on Windows, macOS, and Linux, choose the right IDE, and run your first Python scripts with confidence.