From d4d09e794a817cabe0cd9bb15bb75268be4cc194 Mon Sep 17 00:00:00 2001
From: Nick Ferguson <98440329+itprodirect@users.noreply.github.com>
Date: Thu, 5 Jun 2025 20:45:26 -0400
Subject: [PATCH] docs: add FAQ section

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index 71b458b7..c21752b2 100644
--- a/README.md
+++ b/README.md
@@ -153,5 +153,22 @@ Contributions are welcome! Feel free to fork the repo, submit pull requests, or
 ## 📬 Contact
 For questions or collaborations, connect with me on **LinkedIn** or open an **Issue** in this repository.
 
+---
+## ❓ Common Issues
+
+**Virtual environment won't activate**
+Make sure you run `python -m venv venv` and then activate it with
+`source venv/bin/activate` on Mac/Linux or `venv\Scripts\activate` on Windows.
+Verify Python 3.8+ is installed.
+
+**Missing packages**
+Run `pip install -r requirements.txt` from the project root while your virtual
+environment is active. This installs all dependencies, including Jupyter.
+
+**Notebook won't launch**
+Activate your virtual environment and run
+`jupyter notebook notebooks/Model-Context-Protocol-101.ipynb`. If the command is
+not found, install Jupyter using `pip install jupyter`.
+
 ---
 🔥 *This README is designed for clarity, readability, and ease of navigation!* 🚀