π 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.