This is Data Science

Introduction

This guide walks through the complete process of setting up a professional Python development environment on a macOS machine — from scratch. It covers every layer of the toolchain: command-line developer tools, a package manager, Python version management, virtual environments, Jupyter notebooks, and version-controlled collaboration via GitHub.

Why Python?

Python has become one of the most widely adopted programming languages in the world. Its syntax is clean and readable, its ecosystem is vast, and its community is extraordinarily active. Whether you are building a quick automation script, a production-grade web service, or a machine learning model, Python has a mature library for it. For data science in particular, Python is effectively the lingua franca of the field. A few reasons explain why:

  • Rich scientific stack: Libraries such as NumPy, pandas, SciPy, and Matplotlib form the numerical and analytical backbone of the ecosystem. They are battle-tested, GPU-accelerated where it matters, and designed to interoperate seamlessly.
  • Machine learning and AI: TensorFlow, PyTorch, scikit-learn, and Hugging Face Transformers are all Python-first. The latest research models are almost exclusively published with Python code and pre-trained weights.
  • Interactive exploration: Jupyter notebooks let data scientists write code, visualise results, and document insights in a single living document — a workflow that no other language ecosystem matches as seamlessly.
  • Rapid prototyping: Python's dynamic typing and REPL-driven workflow shorten the feedback loop dramatically, making it ideal for the iterative nature of data exploration and model experimentation.
  • Industry adoption: Python consistently tops the IEEE and Stack Overflow developer surveys. Hiring teams expect it, open datasets ship with Python loaders, and cloud ML platforms — AWS SageMaker, GCP Vertex AI, Azure ML — expose Python-first SDKs. In short, investing in a proper Python setup is an investment that pays dividends across virtually every data science and software engineering task.

What This Guide Covers?

This guide is a progressive setup walkthrough. Each chapter addresses one layer of the stack, and later chapters build on earlier ones. Work through them in order when starting from a fresh macOS installation. Chapters are arraged in following order:

  1. Introduction: Current chapter.
  2. Command Line Tools: Install Apple's Xcode CLT, which unlocks developer utilities including git and python3 from the terminal.
  3. Package Manager (Homebrew): Install Homebrew, the de-facto package manager for macOS.
  4. Python: Understand the difference between the system Python and a managed installation, and why you should never use the system Python for project work.
  5. Pyenv and VirtualEnv: Install pyenv and pyenv-virtualenv, and configure the shell to use them.
  6. Managing Python Versions: Install multiple Python versions and set global or per-project defaults.
  7. Virtual Environments: Create isolated environments per project so dependencies never bleed across projects.
  8. Kernels and Notebooks: Install JupyterLab, create named ipykernel kernels, and understand how they map to virtual environments.
  9. GitHub: Set up SSH key-pairs, link them to GitHub, and manage multiple GitHub accounts.
  10. Conclusion: Summary of all the previous chapters and tasks performed.

Prerequisites

  • This guide targets macOS Catalina (10.15) or later with the zsh shell (the default since Catalina).
  • Commands use the % prompt prefix typical of zsh.
  • Administrator access is required to install packages and modify shell configuration files.
  • An internet connection is required for all downloads.

All set? Let's get started !!