Python Setup Guide

Python Setup Guide

Installing Python is only the first step. A usable development setup also needs environment isolation, predictable package installation, and a repeatable workflow.

1. Create a Project Folder

mkdir my-python-project
cd my-python-project

2. Create a Virtual Environment

python -m venv .venv

Using a project-local virtual environment keeps dependencies isolated and avoids contaminating the global interpreter.

3. Activate the Environment

Windows PowerShell

.venv\Scripts\Activate.ps1

Windows Command Prompt

.venv\Scripts\activate

macOS or Linux

source .venv/bin/activate

4. Upgrade the Packaging Tools

python -m pip install --upgrade pip setuptools wheel

5. Install Packages

python -m pip install requests

List installed packages:

python -m pip list

6. Keep Dependencies Explicit

For simple projects:

python -m pip freeze > requirements.txt

That is not the only packaging strategy, but it is a workable starting point for smaller repos and tutorials.

7. Run a Sanity Check Script

import requests

print("Environment is ready")

When a Custom Package Repository Matters

If you work inside an enterprise environment, your team may use an internal mirror or repository manager. In that case:

• follow your team’s package index rules
• configure the index URL intentionally
• document the expected setup inside the project README

Good Defaults for Everyday Python Work

• use one virtual environment per project
• prefer python -m pip over bare pip
• keep secrets out of source control
• use formatting and linting early, not only at the end

Related Pages

• Install Python
• Python Tools
• Python Learning Roadmap