Python Notes
HubHistory of Python - Complete Guide 2026Python Applications - Complete Guide 2026Python Features - Complete Guide 2026What is Python? - Complete Guide 2026Why Learn Python? - Complete Guide 2026Your First Python Program – Hello World & Beyond 2026How to Install Python on Windows, Mac & Linux – Complete Guide 2026Install VS Code for Python – Complete Setup Guide with Extensions 2026Python Environment Setup – Virtual Environments, pip & Project Structure 2026Python IDLE – Complete Guide for Beginners 2026Python CommentsPython Data TypesPython Input and OutputPython OperatorsPython SyntaxPython Strings BasicsPython Type CastingPython VariablesBreak, Continue and Pass in PythonElif Statement in PythonFor Loop in PythonIf-Else Statement in PythonIf Statement in PythonNested If in PythonPattern Programs in PythonWhile Loop in PythonDecorators in PythonFunction Arguments in PythonFunctions Basics in PythonGenerators in PythonLambda Functions in PythonRecursive Functions in PythonReturn Statement in PythonScope of Variables in PythonAbstraction in PythonClasses and Objects in PythonConstructors in PythonEncapsulation in PythonInheritance in PythonMagic Methods (Dunder Methods) in PythonMethod Overriding in PythonPolymorphism in PythonPython Comprehensions – List, Dict, Set & GeneratorPython Dictionaries – Key-Value StorePython Dictionary Methods – Complete ReferencePython List Methods – All Built-in MethodsPython Lists – Complete GuidePython Set Methods – Complete ReferencePython Sets – Unordered Unique CollectionsPython Tuples – Immutable SequencesPython Asynchronous Programming with asyncioPython Context ManagersAdvanced Python DecoratorsAdvanced Python GeneratorsPython Iterators - Advanced GuidePython Memory ManagementPython MultiprocessingPython MultithreadingCRUD Operations in Python DatabasesMySQL with Python (mysql-connector-python)ORM Introduction with SQLAlchemyPostgreSQL with Python (psycopg2)SQLite3 with PythonIntroduction to DjangoDjango Models and ORMDjango REST API with DRFDjango ViewsIntroduction to FlaskFlask RoutingFlask Templates with Jinja2Email Automation with PythonPDF Automation with PythonSelenium Web Automation with PythonTask Scheduler with PythonWeb Scraping with PythonData Analysis with PythonData Cleaning with PythonData Visualization ProjectData Visualization with MatplotlibNumPy IntroductionPandas IntroductionStatistical Visualization with SeabornClassification AlgorithmsClustering AlgorithmsIntroduction to Machine LearningMachine Learning Project: Churn PredictionModel Evaluation and SelectionRegression AlgorithmsSave pipeline (includes preprocessing + model)AI Assistant ProjectCalculator ProjectChatbot ProjectExpense Tracker ProjectFace Detection ProjectPassword Generator ProjectWeather App ProjectPython Coding Interview QuestionsPython OOP Interview Questions and AnswersPython Master CheatsheetPython Interview Questions and AnswersPython Best PracticesCommon Python Errors and SolutionsPython Debugging TechniquesPython Learning Resources
Complete guide to setting up a professional Python development environment. Learn virtual environments, pip package manager, .env files, project structure, and best practices. Python environment setup kaise karein – Hindi mein.
Hindi: Professional Python development ke liye sirf Python install karna kaafi nahi hai. Iss guide mein seekhein virtual environments, pip, project structure, aur woh sab cheezein jo ek real developer use karta hai.
🎯 Why Environment Setup Matters
Hindi: Sochi – aap ek project karte ho jo Python 3.11 aur library X version 1.0 maangta hai, aur doosra project Python 3.13 aur library X version 3.0 maangta hai. Agar sab ek hi jagah install hoga toh clash hoga! Virtual environments isko solve karte hain.
| │ Without Virtual Environments | │ |
| │ │ ├── Project A | requests==2.28.0 │ │ |
| │ │ ├── Project B | requests==2.31.0 ← CONFLICT! │ │ |
| │ │ ├── Project C | numpy==1.21.0 │ │ |
| │ │ └── Project D | numpy==1.26.0 ← CONFLICT! │ │ |
| │ With Virtual Environments | │ |
🚫 The Problem Without Virtual Environments
Scenario:
Example
You install Django 3.2 for an old project
You install Django 4.2 for a new project
→ Django 4.2 OVERWRITES Django 3.2
→ Your old project breaks!
Real-world Consequences:
- 🔴 Project A stops working after installing packages for Project B
- 🔴 Package version conflicts cause mysterious bugs
- 🔴 "Works on my machine" syndrome – works locally but not on server
- 🔴 Difficult to reproduce exact package versions for deployment
Hindi: Bina virtual environment ke, ek project ke liye install kiya package doosre project ko break kar sakta hai. Yeh professional development mein ek bada problem hai. Virtual environment is problem ko solve karta hai.
🌐 Virtual Environments (venv)
A virtual environment is an isolated Python environment where you can install packages without affecting other projects or the system Python.
Hindi: Virtual environment ek isolated sandbox hai – iske andar jo bhi package install karo woh sirf is environment tak hi limited rehta hai. Ek box mein ek project ke tools, doosre box mein doosre project ke tools.
Built-in venv Module (Recommended)
Python 3.3+ includes venv – no installation needed!
┌──────────────────────────────────────────────────────────────┐
│ VIRTUAL ENVIRONMENT WORKFLOW │
│ │
│ 1. Create venv python -m venv myenv │
│ │ │
│ ▼ │
│ 2. Activate venv source myenv/bin/activate (Linux/Mac) │
│ myenv\Scripts\activate (Windows) │
│ │ │
│ ▼ │
│ 3. Install pkgs pip install django requests numpy │
│ │ │
│ ▼ │
│ 4. Work on project (packages isolated to this env) │
│ │ │
│ ▼ │
│ 5. Deactivate deactivate │
└──────────────────────────────────────────────────────────────┘
Step 1: Create a Project Folder
bash example
# Create and navigate to your project
mkdir my_python_project
cd my_python_projectStep 2: Create Virtual Environment
bash example
# Create a virtual environment named 'venv'
python -m venv venv
# Or with a custom name
python -m venv my_env
python -m venv .venv # Hidden folder (popular convention)# What gets created:
my_python_project/
└── venv/
├── Include/
├── Lib/
│ └── site-packages/ ← Your packages go here
├── Scripts/ ← Python executables (Windows)
│ ├── activate
│ ├── activate.bat
│ ├── deactivate.bat
│ ├── pip.exe
│ └── python.exe
└── pyvenv.cfg
Step 3: Activate the Virtual Environment
bash example
# Windows (Command Prompt)
venv\Scripts\activate
# Windows (PowerShell)
venv\Scripts\Activate.ps1
# macOS / Linux
source venv/bin/activateAfter activation, your prompt changes:
Example
# Before activation:
C:\my_python_project>
# After activation:
(venv) C:\my_python_project>
# ↑ (venv) indicates virtual environment is active
Hindi:(venv)prompt ke aage aana matlab virtual environment active ho gaya. Ab aap jo bhipip installkarenge woh sirf is environment mein install hoga.
Step 4: Verify the Environment
bash example
# Check which Python is being used
(venv) $ python --versionOutput
Python 3.13.0
bash example
# Check Python path (should point to venv)
(venv) $ which python # Mac/Linux
(venv) $ where python # WindowsOutput
/home/user/my_python_project/venv/bin/python # Linux C:\my_python_project\venv\Scripts\python.exe # Windows
bash example
# List installed packages (should be minimal)
(venv) $ pip listOutput
Package Version ---------- ------- pip 24.0 setuptools 69.0.2
Step 5: Install Packages in the Environment
bash example
(venv) $ pip install requests
(venv) $ pip install flask
(venv) $ pip install pandas numpy matplotlibOutput
Successfully installed requests-2.31.0 ... Successfully installed flask-3.0.0 ... Successfully installed pandas-2.1.3 numpy-1.26.2 matplotlib-3.8.2
Step 6: Deactivate
bash example
(venv) $ deactivateExample
# Prompt returns to normal:
C:\my_python_project>
Deleting a Virtual Environment
bash example
# Simply delete the venv folder
rm -rf venv/ # Mac/Linux
rmdir /s venv # Windows Command Prompt📦 pip – Python Package Manager
pip is Python's official package installer. It downloads packages from PyPI (Python Package Index) – a repository of 500,000+ packages.
Hindi: pip Python ka package manager hai – jaise phone mein Play Store hota hai waise Python mein pip hota hai. pip install se koi bhi package PyPI se download aur install kar sakte hain.| │ Full name | pip installs packages │ |
| │ Source | PyPI (https://pypi.org) │ |
| │ Packages | 500,000+ available │ |
| │ Usage | pip install package_name │ |
Essential pip Commands:
bash example
# INSTALL PACKAGES
pip install requests # Install latest version
pip install requests==2.28.0 # Install specific version
pip install "requests>=2.25,<3" # Install version range
pip install requests flask django # Install multiple packages
# UPGRADE PACKAGES
pip install --upgrade requests # Upgrade to latest
pip install -U requests # Short form
# UNINSTALL
pip uninstall requests
pip uninstall requests flask -y # Skip confirmation (-y)
# LIST PACKAGES
pip list # All installed packages
pip list --outdated # Packages with newer versions
pip show requests # Details about a package
# SEARCH (limited in newer pip versions)
pip index versions requests # Show all available versions
# CHECK FOR DEPENDENCY CONFLICTS
pip check
# UPGRADE pip ITSELF
pip install --upgrade pip
python -m pip install --upgrade pip # Alternative
# INSTALL FROM FILE
pip install -r requirements.txt # Install from requirements file
# INSTALL IN DEVELOPMENT MODE
pip install -e . # Editable install (for your own packages)pip show – Package Details:
bash example
pip show requestsOutput
Name: requests Version: 2.31.0 Summary: Python HTTP for Humans. Home-page: https://requests.readthedocs.io Author: Kenneth Reitz Author-email: me@kennethreitz.org License: Apache 2.0 Location: /home/user/venv/lib/python3.13/site-packages Requires: certifi, charset-normalizer, idna, urllib3 Required-by: flask, httpx
pip list –outdated:
bash example
pip list --outdatedOutput
Package Version Latest Type ---------- ------- ------ ----- Pillow 9.5.0 10.1.0 wheel numpy 1.24.0 1.26.2 wheel pandas 1.5.3 2.1.3 wheel
Hindi: pip list --outdated se pata chalta hai kaunse packages ke newer versions available hain. Production mein update karne se pehle test zaroor karein.📋 Managing Dependencies with requirements.txt
When you share a project, others need to install the same packages. requirements.txt records all your dependencies.
Hindi: requirements.txt file mein project ke saare packages aur unke versions listed hote hain. Isse dusra developer ek hi command se saare packages install kar sakta hai.Generate requirements.txt:
bash example
# Freeze current environment's packages to file
(venv) $ pip freeze > requirements.txtExample
# requirements.txt contents:
certifi==2023.11.17
charset-normalizer==3.3.2
click==8.1.7
Flask==3.0.0
idna==3.4
itsdangerous==2.1.2
Jinja2==3.1.2
MarkupSafe==2.1.3
requests==2.31.0
urllib3==2.1.0
Werkzeug==3.0.1
Install from requirements.txt:
bash example
# Create a new virtual environment first
python -m venv venv
source venv/bin/activate # Mac/Linux
venv\Scripts\activate # Windows
# Install all packages from requirements.txt
pip install -r requirements.txtOutput
Collecting certifi==2023.11.17 (from -r requirements.txt (line 1)) Collecting charset-normalizer==3.3.2 (from -r requirements.txt (line 2)) ... Successfully installed all packages!
Best Practice: Separate requirements files:
requirements/
├── base.txt # Core dependencies
├── development.txt # Dev tools (pytest, black, flake8)
└── production.txt # Production only (gunicorn, etc.)
Example
# requirements/base.txt
Flask==3.0.0
SQLAlchemy==2.0.23
requests==2.31.0
# requirements/development.txt
-r base.txt # Include base requirements
pytest==7.4.3
black==23.11.0
flake8==6.1.0
ipython==8.17.2
# requirements/production.txt
-r base.txt
gunicorn==21.2.0
Hindi: Professional projects mein alag-alag requirements files hoti hain – ek development ke liye, ek production ke liye. Isse server par sirf zaroori packages install hote hain.
🔐 Environment Variables & .env Files
Sensitive information (passwords, API keys, database URLs) should never be hardcoded in your code. Use environment variables instead.
Hindi: Passwords, API keys, database credentials kabhi bhi directly code mein mat likhein – yeh security risk hai. Inhe.envfile mein store karein aur.gitignoremein add karein.
Why Environment Variables?
python example
# ❌ DANGEROUS – Never do this!
DB_PASSWORD = "mypassword123"
API_KEY = "sk-abc123xyz789"
SECRET_KEY = "my_super_secret_key"
# ✅ SAFE – Use environment variables
import os
DB_PASSWORD = os.environ.get("DB_PASSWORD")
API_KEY = os.environ.get("API_KEY")
SECRET_KEY = os.environ.get("SECRET_KEY")Using python-dotenv:
bash example
# Install dotenv
pip install python-dotenvCreate .env file:
bash example
# .env file (in project root)
# Never commit this to Git!
DATABASE_URL=postgresql://user:password@localhost/mydb
SECRET_KEY=your-super-secret-key-here
API_KEY=sk-abcdef123456789
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_USER=myemail@gmail.com
EMAIL_PASSWORD=myemailpasswordLoad .env in Python:
python example
# config.py
from dotenv import load_dotenv
import os
# Load .env file
load_dotenv()
# Access environment variables
DATABASE_URL = os.getenv("DATABASE_URL")
SECRET_KEY = os.getenv("SECRET_KEY")
API_KEY = os.getenv("API_KEY")
DEBUG = os.getenv("DEBUG", "False").lower() == "true"
print(f"Database: {DATABASE_URL}")
print(f"Debug Mode: {DEBUG}")Output
Database: postgresql://user:password@localhost/mydb Debug Mode: True
.gitignore for .env:
bash example
# .gitignore
.env
.env.local
.env.production
*.env
venv/
__pycache__/
*.pyc
.DS_StoreHindi:.envfile ko.gitignoremein daalna bahut zaroori hai – warna GitHub par push karte waqt aapka password sab dekh sakte hain! Kabhi bhi.envfile commit mat karein.
📁 Python Project Structure
Hindi: Professional Python project ki ek standard folder structure hoti hai. Yeh follow karne se code organize rehta hai aur team mein samajhna aasaan hota hai.
Simple Script Project:
my_script_project/
├── .gitignore
├── README.md
├── requirements.txt
├── .env
├── venv/ ← Virtual environment (NOT committed to git)
└── main.py ← Main script
Small Python Application:
my_app/
├── .gitignore
├── README.md
├── requirements.txt
├── .env
├── .env.example ← Template without real values (committed)
├── venv/
├── config.py ← Configuration settings
├── main.py ← Entry point
├── utils.py ← Helper functions
└── tests/
└── test_main.py
Medium Flask Web App:
flask_project/
├── .gitignore
├── README.md
├── requirements.txt
├── .env
├── .env.example
├── venv/
├── app.py ← Main Flask application
├── config.py ← Configuration
├── models.py ← Database models
├── routes/
│ ├── __init__.py
│ ├── auth.py
│ └── main.py
├── templates/ ← HTML templates
│ ├── base.html
│ ├── index.html
│ └── auth/
│ └── login.html
├── static/ ← CSS, JS, images
│ ├── css/
│ ├── js/
│ └── images/
└── tests/
├── conftest.py
└── test_routes.py
Python Package/Library:
my_package/
├── .gitignore
├── README.md
├── LICENSE
├── setup.py ← Package setup (old style)
├── pyproject.toml ← Package setup (new style)
├── requirements.txt
├── CHANGELOG.md
├── my_package/ ← The actual package
│ ├── __init__.py
│ ├── core.py
│ ├── utils.py
│ └── exceptions.py
├── tests/
│ ├── __init__.py
│ ├── test_core.py
│ └── test_utils.py
└── docs/
├── index.md
└── api.md
Hindi:__init__.pyfile ek folder ko Python package banati hai.tests/folder mein test files rakhte hain.docs/folder mein documentation hoti hai.
pyproject.toml (Modern Package Config):
Example
# pyproject.toml
[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.backends.legacy:build"
[project]
name = "my-python-package"
version = "1.0.0"
description = "A sample Python package"
readme = "README.md"
license = {text = "MIT"}
authors = [
{name = "Your Name", email = "your@email.com"}
]
requires-python = ">=3.10"
dependencies = [
"requests>=2.28.0",
"flask>=3.0.0",
]
[project.optional-dependencies]
dev = [
"pytest>=7.0",
"black>=23.0",
"flake8>=6.0",
]
[tool.black]
line-length = 88
target-version = ["py310", "py311", "py312", "py313"]
[tool.pytest.ini_options]
testpaths = ["tests"]
🐍 Conda Environments (Alternative)
Anaconda/Conda is an alternative environment manager, especially popular in data science.
Hindi: Conda especially data science aur machine learning projects ke liye popular hai. Isme Python packages ke alawa non-Python packages (like CUDA) bhi manage ho sakte hain.
bash example
# Install Anaconda from https://www.anaconda.com/
# Create conda environment
conda create -n myenv python=3.13
# Activate
conda activate myenv
# Install packages (conda or pip)
conda install numpy pandas matplotlib
pip install flask requests
# List environments
conda env list
# Deactivate
conda deactivate
# Remove environment
conda env remove -n myenv
# Export environment
conda env export > environment.yml
# Create from yml file
conda env create -f environment.ymlyaml example
# environment.yml
name: data_science_env
channels:
- defaults
- conda-forge
dependencies:
- python=3.13
- numpy=1.26.2
- pandas=2.1.3
- matplotlib=3.8.2
- jupyter=1.0.0
- scikit-learn=1.3.2
- pip:
- flask==3.0.0
- requests==2.31.0🔄 pyenv – Managing Python Versions
Hindi: pyenv se ek computer par multiple Python versions install aur switch kar sakte hain – har project ke liye alag Python version!
Example
# Install pyenv (Linux/Mac)
curl https://pyenv.run | bash
# Add to ~/.bashrc or ~/.zshrc:
export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
# Reload shell
source ~/.bashrc
# Install Python versions
pyenv install 3.13.0
pyenv install 3.12.7
pyenv install 3.11.9
# List installed versions
pyenv versions
Output
system 3.11.9 3.12.7 * 3.13.0 (set by /home/user/.python-version)
bash example
# Set global (default) version
pyenv global 3.13.0
# Set local version for a specific project
cd my_old_project
pyenv local 3.11.9
# Check current version
python --versionOutput
Python 3.11.9
bash example
# pyenv + venv combined (best practice):
cd my_new_project
pyenv local 3.13.0 # Set Python version for this project
python -m venv venv # Create venv with that Python
source venv/bin/activate # Activate
pip install -r requirements.txt🖥️ VS Code + Virtual Environment
Hindi: VS Code mein virtual environment ko properly configure karna zaroori hai taaki IntelliSense aur debugging sahi kaam karein.
Select venv in VS Code:
1. Open your project folder in VS Code
2. Press Ctrl+Shift+P
3. Type: "Python: Select Interpreter"
4. You'll see your venv listed:
┌────────────────────────────────────────────────────────────┐
│ Select Interpreter │
│ ───────────────────────────────────────────────────── │
│ ★ Python 3.13.0 ('venv': venv) │
│ /my_project/venv/Scripts/python.exe ◄── Select this │
│ Python 3.13.0 │
│ /usr/bin/python3 │
└────────────────────────────────────────────────────────────┘
5. Select the venv Python
.vscode/settings.json for venv:
Example
{
"python.defaultInterpreterPath": "${workspaceFolder}/venv/Scripts/python.exe",
"python.terminal.activateEnvironment": true,
"python.venvFolders": ["venv", ".venv", "env"],
"python.venvPath": "${workspaceFolder}"
}
VS Code Terminal Auto-activates venv:
Example
When you open a new terminal in VS Code with a project that has venv:
It automatically runs: venv\Scripts\activate
Your terminal shows: (venv) PS C:\my_project>
📌 Useful pip Commands Reference
Hindi: Yeh pip commands ka quick reference card hai – save karein ya print karein!
┌─────────────────────────────────────────────────────────────────┐
│ pip QUICK REFERENCE │
├─────────────────────────────────────────────────────────────────┤
│ │
│ INSTALL │
│ pip install package # Latest version │
│ pip install package==1.0.0 # Exact version │
│ pip install "package>=1.0,<2.0" # Version range │
│ pip install package1 package2 # Multiple packages │
│ pip install -r requirements.txt # From file │
│ pip install -e . # Editable install │
│ pip install --user package # User install (no sudo) │
│ │
│ UPGRADE │
│ pip install -U package # Upgrade package │
│ pip install --upgrade pip # Upgrade pip │
│ │
│ UNINSTALL │
│ pip uninstall package # Uninstall │
│ pip uninstall package -y # No confirmation │
│ │
│ INFO │
│ pip list # All packages │
│ pip list --outdated # Outdated packages │
│ pip show package # Package details │
│ pip freeze # Requirements format │
│ pip check # Check conflicts │
│ │
│ EXPORT/IMPORT │
│ pip freeze > requirements.txt # Export │
│ pip install -r requirements.txt # Import │
│ │
└─────────────────────────────────────────────────────────────────┘
Install Most Popular Python Packages:
bash example
# Data Science
pip install numpy pandas matplotlib seaborn scikit-learn
# Web Development
pip install flask django fastapi uvicorn
# Database
pip install sqlalchemy psycopg2-binary pymongo redis
# HTTP / API
pip install requests httpx aiohttp
# Environment / Config
pip install python-dotenv pydantic
# Testing
pip install pytest pytest-cov coverage
# Code Quality
pip install black flake8 pylint isort mypy
# Utilities
pip install pillow boto3 celery📚 Complete Environment Setup – Step by Step
Hindi: Ek nayi Python project start karne ka poora process yahan ek jagah diya gaya hai.
Example
# Step 1: Create project directory
mkdir my_new_project
cd my_new_project
# Step 2: Initialize git repository
git init
# Step 3: Create virtual environment
python -m venv venv
# Step 4: Activate virtual environment
# Windows:
venv\Scripts\activate
# Mac/Linux:
source venv/bin/activate
# Step 5: Upgrade pip
pip install --upgrade pip
# Step 6: Install required packages
pip install flask python-dotenv requests
# Step 7: Freeze requirements
pip freeze > requirements.txt
# Step 8: Create project files
echo "# My Python Project" > README.md
# Step 9: Create .env file
echo "DEBUG=True" > .env
echo "SECRET_KEY=your-secret-key-here" >> .env
# Step 10: Create .env.example (template, safe to commit)
echo "DEBUG=True" > .env.example
echo "SECRET_KEY=change-this-key" >> .env.example
# Step 11: Create .gitignore
cat > .gitignore << EOF
venv/
.env
__pycache__/
*.pyc
.DS_Store
*.egg-info/
dist/
build/
.pytest_cache/
.coverage
EOF
# Step 12: Create main application file
cat > main.py << EOF
from flask import Flask
from dotenv import load_dotenv
import os
load_dotenv()
app = Flask(__name__)
app.config['SECRET_KEY'] = os.getenv('SECRET_KEY')
app.config['DEBUG'] = os.getenv('DEBUG', 'False').lower() == 'true'
@app.route('/')
def home():
return "Hello, Flask!"
if __name__ == '__main__':
app.run()
EOF
# Step 13: Verify project structure
# my_new_project/
# ├── .gitignore
# ├── .env
# ├── .env.example
# ├── README.md
# ├── requirements.txt
# ├── venv/
# └── main.py
# Step 14: Run the application
python main.py
Output
* Serving Flask app 'main' * Debug mode: on * Running on http://127.0.0.1:5000 Press CTRL+C to quit
✅ Best Practices Checklist
┌─────────────────────────────────────────────────────────────────┐
│ PYTHON ENVIRONMENT BEST PRACTICES │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Virtual Environments │
│ ☐ Always use a virtual environment for every project │
│ ☐ Never install project packages in system Python │
│ ☐ Add venv/ to .gitignore │
│ ☐ Use .venv as the folder name (VS Code auto-detects it) │
│ │
│ Dependencies │
│ ☐ Always maintain requirements.txt │
│ ☐ Pin versions for production: flask==3.0.0 │
│ ☐ Use ranges for libraries: "requests>=2.28,<3" │
│ ☐ Regularly update and test upgrades │
│ │
│ Security │
│ ☐ Store secrets in .env file, never in code │
│ ☐ Add .env to .gitignore │
│ ☐ Create .env.example with dummy values │
│ ☐ Review pip audit for security vulnerabilities │
│ │
│ Project Structure │
│ ☐ Follow consistent folder structure │
│ ☐ Have a README.md with setup instructions │
│ ☐ Use meaningful file and variable names │
│ ☐ Write tests in tests/ folder │
│ │
│ Code Quality │
│ ☐ Use black for code formatting │
│ ☐ Use flake8 or pylint for linting │
│ ☐ Configure pre-commit hooks │
│ ☐ Use type hints for better code documentation │
│ │
└─────────────────────────────────────────────────────────────────┘
🔧 Troubleshooting
❌ Error 1: venv not recognized
bash example
# Error:
$ python -m venv venv
# Error: No module named venv
# Fix (Ubuntu/Debian):
sudo apt install python3-venv
# Fix (other systems – use virtualenv instead):
pip install virtualenv
virtualenv venvHindi: Ubuntu mein python3-venv alag package hai jo install karna padta hai.❌ Error 2: Cannot activate venv on Windows PowerShell
Example
venv\Scripts\Activate.ps1 cannot be loaded because running scripts is disabled
Fix:
powershell example
# Run PowerShell as Administrator and execute:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# Then activate venv:
venv\Scripts\Activate.ps1❌ Error 3: pip install fails with SSL error
Example
pip: WARNING: Retrying ... ProxyError ... SSLError
Fix:
bash example
# Temporary fix:
pip install --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org requests
# Or use a different index:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
# Fix SSL permanently:
pip install certifi
python -m pip install --upgrade pip certifi❌ Error 4: Module not found after installing
Example
ModuleNotFoundError: No module named 'flask'
Cause: Package installed in wrong Python/venv.
Fix:
bash example
# Check which Python is running
which python # Mac/Linux
where python # Windows
# Make sure venv is activated (check for (venv) in prompt)
# If not activated:
source venv/bin/activate # Mac/Linux
venv\Scripts\activate # Windows
# Install in activated venv
pip install flask❌ Error 5: requirements.txt has too many packages
bash example
# Problem: pip freeze includes ALL packages (including sub-dependencies)
# Better: use pipreqs to generate only direct dependencies
pip install pipreqs
pipreqs ./ # Generate requirements.txt from imports in code❌ Error 6: Different behavior on different machines
Example
# Usually caused by different package versions
# Fix: pin all versions in requirements.txt
pip freeze > requirements.txt
# This ensures everyone uses exact same versions
🏗️ Complete Architecture Diagram
┌──────────────────────────────────────────────────────────────────┐
│ PYTHON DEVELOPMENT ECOSYSTEM │
│ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ YOUR COMPUTER │ │
│ │ │ │
│ │ System Python 3.13 │ │
│ │ └── pip (global) │ │
│ │ └── pyenv (manages Python versions) │ │
│ │ │ │
│ │ Projects: │ │
│ │ ┌─────────────────────┐ ┌─────────────────────────┐ │ │
│ │ │ project_a/ │ │ project_b/ │ │ │
│ │ │ ├── venv/ │ │ ├── venv/ │ │ │
│ │ │ │ └── Python 3.13 │ │ │ └── Python 3.11 │ │ │
│ │ │ │ └── flask 3.0 │ │ │ └── django 4.2 │ │ │
│ │ │ │ └── numpy 1.26 │ │ │ └── pandas 2.1 │ │ │
│ │ │ ├── .env │ │ ├── .env │ │ │
│ │ │ ├── requirements.txt│ │ ├── requirements.txt │ │ │
│ │ │ └── main.py │ │ └── app.py │ │ │
│ │ └─────────────────────┘ └─────────────────────────┘ │ │
│ │ ↑ ↑ │ │
│ │ └────────────────────────┘ │ │
│ │ Isolated! No conflicts! │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ External: PyPI (Python Package Index) │
│ └── 500,000+ packages available via pip │
└──────────────────────────────────────────────────────────────────┘
🚀 Summary
You now know how to set up a professional Python development environment!
Example
✅ Understood why virtual environments are essential
✅ Created and used virtual environments with venv
✅ Mastered pip for package management
✅ Created and used requirements.txt
✅ Set up .env files for secure configuration
✅ Learned Python project structure best practices
✅ Explored conda and pyenv as alternatives
✅ Configured VS Code with virtual environments
✅ Know how to troubleshoot common issues
Hindi: Ab aap ek professional Python developer ki tarah environment setup karna jaante hain. Virtual environment, pip, requirements.txt, .env – yeh sab production-grade development ke liye zaroori hain. Inhe apni har project mein use karein!
Next Steps:
| Step | Topic | File |
|---|---|---|
| ← Previous | First Python Program | first-python-program.mdx |
| → Next | Python Data Types (Deep Dive) | Coming Soon |
| → Advanced | Python OOP | Coming Soon |
Quick Reference Commands:
bash example
# Create & activate new project environment (copy-paste ready!)
mkdir my_project && cd my_project
python -m venv venv
source venv/bin/activate # Mac/Linux
# venv\Scripts\activate # Windows
pip install --upgrade pip
pip freeze > requirements.txt
echo "venv/" >> .gitignore
echo ".env" >> .gitignore*Last Updated: June 12, 2026 | Author: WohoTech | Category: Python Setup*
Exam Focus
Revise definitions, diagrams, examples, and short-answer points for Python Environment Setup – Virtual Environments, pip & Project Structure 2026.
Interview Use
Prepare one clear explanation, one practical example, and one common mistake for this Python Master Course topic.
Search Terms
python-master-course, python master course, python, master, course, setup, environment, python environment setup – virtual environments, pip & project structure 2026
Related Python Master Course Topics
Continue learning this concept
SetupYour First Python Program – Hello World & Beyond 2026Write your first Python program step-by-step. Learn Hello World, variables, input/output, comments, and basic syntax. Pehla Python program kaise likhein – Hindi mein complete beginner guide.SetupHow to Install Python on Windows, Mac & Linux – Complete Guide 2026Learn how to download and install Python on Windows, macOS, and Linux step-by-step. Includes PATH setup, version verification, and troubleshooting. Python install kaise kare – Hindi mein samjhein.SetupInstall VS Code for Python – Complete Setup Guide with Extensions 2026Learn how to install Visual Studio Code for Python development. Setup Python extension, debugger, linter, formatter and essential tools. VS Code Python setup kaise karein – Hindi mein complete guide.SetupPython IDLE – Complete Guide for Beginners 2026Master Python IDLE – PythonAdvanced PythonPython Asynchronous Programming with asyncioDeep dive into Python async/await, asyncio event loop, coroutines, tasks, async generators, aiohttp, and real-world asynchronous patterns with Hindi explanations.Advanced PythonPython Context ManagersComprehensive guide to Python context managers using with statement, __enter__ and __exit__ methods, contextlib module, nested context managers and custom resource management.