02 - Setup Python Environment¶

Get the Video Course

Before running any scripts, you need a Python environment with the required packages. This section guides you through installing Miniconda, creating a dedicated conda environment, and verifying your setup.

Why Virtual Environments?¶

Table of Contents¶

Step-01: Install Miniconda¶

Download Miniconda from: https://docs.anaconda.com/miniconda/

Step-01-01: macOS¶

# Option 1: Download from the website
# Go to https://docs.anaconda.com/miniconda/ and download the macOS installer

# Option 2: Use Homebrew
brew install --cask miniconda

# After installation, initialize conda for your shell
# Check which shell you are using
echo $SHELL

# If /bin/zsh (default on macOS)
conda init zsh

# If /bin/bash
conda init bash

# Restart your terminal after running this

Step-01-02: Windows¶

1. Download the Windows installer (.exe)
2. Run the installer
3. Check "Add Miniconda to my PATH environment variable" during installation
4. Open Command Prompt or PowerShell

Verify Installation (both platforms)¶

conda --version

Expected Output:

conda 24.x.x

Accept Terms of Service (both platforms, one-time)¶

conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r

Note: This is required once after a fresh Miniconda install. Without it, conda create will fail with a Terms of Service error.

Step-02: Create Conda Environment¶

# Create environment with Python 3.14
conda create -n mlops-env1 python=3.14 -c conda-forge -y

# Activate environment
conda activate mlops-env1

Expected Output:

(mlops-env1) $    # Your prompt shows the active environment

Step-03: Install Dependencies¶

# Navigate to the project folder
cd 02_Setup_Python/ccfd-project

# Install from requirements file
pip install -r requirements.txt

Alternative: If you're using the shared folder, run from ccfd-project-main/ instead. See Shared Project Folder in the root README.

Key packages installed:

Note: Exact pinned versions are in requirements.txt for reproducibility.

Step-04: Verify Installation¶

python -c "import sklearn; import pandas; import numpy; print('All packages OK')"
python -c "import sklearn; print(f'sklearn version: {sklearn.__version__}')"

Expected Output:

All packages OK
sklearn version: 1.8.0

Environment Commands Reference¶

Troubleshooting¶

"conda: command not found" (macOS) - Restart your terminal after Miniconda installation - Run: conda init zsh and conda init bash, then restart terminal - Or manually: source ~/.zshrc

"conda is not recognized" (Windows) - Restart Command Prompt/PowerShell after installation - If still not found, Miniconda was not added to PATH during installation - Fix: Reinstall and check "Add Miniconda to my PATH environment variable"

Package conflicts (both platforms)

# Remove and recreate environment
conda env remove -n mlops-env1
conda create -n mlops-env1 python=3.14 -c conda-forge -y
conda activate mlops-env1
pip install -r requirements.txt

Next Steps¶

01 - Introduction Next: 03 - Generate Synthetic Dataset