🚀 Recommended Way (Professional Setup – 2026)
We will use:
✅ Homebrew Python
✅ Virtual Environment
✅ JupyterLab (modern)
✅ Proper PATH handling
🧩 Step 0 — Check Mac Type
uname -m
arm64→ Apple Silicon (M1/M2/M3)x86_64→ Intel
🧩 Step 1 — Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Verify:
brew --version
🧩 Step 2 — Install Clean Python (Do NOT use system Python)
brew install python
Check:
which python3
Should show:
/opt/homebrew/bin/python3 (Apple Silicon)
/usr/local/bin/python3 (Intel)
🧩 Step 3 — Create Isolated Jupyter Environment (Best Practice)
mkdir ~/jupyter-projects
cd ~/jupyter-projects
python3 -m venv jupyter-env
source jupyter-env/bin/activate
Your terminal will now show:
(jupyter-env)
🧩 Step 4 — Upgrade pip Properly
pip install --upgrade pip
🧩 Step 5 — Install JupyterLab (Recommended Over Notebook)
pip install jupyterlab
If you specifically want classic notebook:
pip install notebook
🧩 Step 6 — Run Jupyter
Modern UI:
jupyter lab
Classic UI:
jupyter notebook
Opens at:
http://localhost:8888
🧩 Step 7 — Make It Easier (Optional Alias)
Open:
nano ~/.zshrc
Add:
alias jl="source ~/jupyter-projects/jupyter-env/bin/activate && jupyter lab"
alias jn="source ~/jupyter-projects/jupyter-env/bin/activate && jupyter notebook"
Reload:
source ~/.zshrc
Now you can simply run:
jl
🔥 If You See “command not found: jupyter”
Do NOT panic.
Just run:
source jupyter-env/bin/activate
jupyter lab
If needed:
export PATH="$HOME/jupyter-projects/jupyter-env/bin:$PATH"
🧠 Why This Is the Best Method
| Method | Problem |
|---|---|
| System Python | Breaks with macOS updates |
| User pip install | PATH mismatch |
| Anaconda | Heavy (2–3 GB) |
| Virtualenv + Brew Python | Clean & Stable ✅ |
🎯 Optional: Install Common Packages
For AI/Data:
pip install numpy pandas matplotlib seaborn scikit-learn
For DevOps:
pip install requests pyyaml boto3 kubernetes
For AI/LLM:
pip install openai transformers langchain
🛑 If You Already Installed Jupyter Globally (Cleanup)
You can remove old user installation:
pip uninstall notebook jupyterlab
Then follow the clean setup above.