🧪 Run Jupyter Notebook with a Virtual Environment

This guide helps you configure and run Jupyter Notebooks inside a Python virtual environment (venv).

🚀 Getting Started

1. Fork this repository to your own GitHub account.

2. Clone your fork to your local machine:

   git clone https://github.com/YOUR_USERNAME/ai-agent-workshop.git
   cd ai-agent-workshop

3. Activate Your Virtual Environment

   python3 -m venv .venv
   source ./.venv/bin/activate

---

4. Install Jupyter and Dependencies

Ensure all required packages—including Jupyter Notebook and IPython kernel support—are installed within your virtual environment. Use the following command to install dependencies listed in the requirements.txt

pip install -r requirements.txt

---

5. Add the Virtual Environment to Jupyter as a Kernel

Register your virtual environment with Jupyter so it appears as a kernel option:

python -m ipykernel install --user --name=myenv --display-name "Python (myenv)"

• --name: internal name for the kernel
• --display-name: the name shown in the Jupyter interface

---

6. Launch Jupyter Notebook

Still inside the activated virtual environment, launch Jupyter Notebook:

jupyter notebook

Then, in the Notebook UI, select your kernel from:

Kernel → Change kernel → Python (myenv)

---

✅ You're all set! You can now work with isolated environments in Jupyter with full control.