Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,16 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+community_contributions/amirna2_contributions/personal-ai/me/resume.pdf filter=lfs diff=lfs merge=lfs -text
+community_contributions/careerwise_gemini_ntfy/me/resume_for_Virtual_Assistant.pdf filter=lfs diff=lfs merge=lfs -text
+community_contributions/chat_with_jamal/me/resume.pdf filter=lfs diff=lfs merge=lfs -text
+community_contributions/ChatBot_with_evaluator_and_notifier/career_db/chroma.sqlite3 filter=lfs diff=lfs merge=lfs -text
+community_contributions/hidden_gems_world_travel_guide/Screenshot1.png filter=lfs diff=lfs merge=lfs -text
+community_contributions/Igniters-Week1-Tunde_Wey/me/linkedin.pdf filter=lfs diff=lfs merge=lfs -text
+community_contributions/jongkook/me/Jongkook[[:space:]]Kim[[:space:]]-[[:space:]]Resume.pdf filter=lfs diff=lfs merge=lfs -text
+community_contributions/NLP_Agent_Dinesh_Uthayakumar/eval1_capital.wav filter=lfs diff=lfs merge=lfs -text
+community_contributions/NLP_Agent_Dinesh_Uthayakumar/eval2_money_customers_owe.wav filter=lfs diff=lfs merge=lfs -text
+community_contributions/NLP_Agent_Dinesh_Uthayakumar/eval3_total_estimated_revenue.wav filter=lfs diff=lfs merge=lfs -text
+community_contributions/norbert-wakanda/me/linkedin.pdf filter=lfs diff=lfs merge=lfs -text
+community_contributions/seung-gu/me/linkedin.pdf filter=lfs diff=lfs merge=lfs -text
+me/Mukesh[[:space:]]Patil[[:space:]]Resume.pdf filter=lfs diff=lfs merge=lfs -text

1_lab1.ipynb

@@ -0,0 +1,460 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 28,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 28,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "from typing import overload, override\n",
+    "\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OpenAI API Key exists and begins sk-proj-\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "2 + 2 equals 4.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "If it takes 5 machines 5 minutes to make 5 widgets, how long would it take 100 machines to make 100 widgets?\n"
+     ]
+    }
+   ],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Let's analyze the problem step-by-step:\n",
+      "\n",
+      "- It takes 5 machines 5 minutes to make 5 widgets.\n",
+      "- This means that 5 machines produce 5 widgets in 5 minutes.\n",
+      "\n",
+      "From this, we can find the rate of one machine:\n",
+      "\n",
+      "- 5 machines → 5 widgets in 5 minutes\n",
+      "- So, 1 machine → (5 widgets / 5 machines) = 1 widget in 5 minutes\n",
+      "\n",
+      "Therefore, one machine makes 1 widget in 5 minutes.\n",
+      "\n",
+      "Now, if we have 100 machines working in parallel:\n",
+      "\n",
+      "- Each machine makes 1 widget in 5 minutes.\n",
+      "- So, 100 machines will make 100 widgets in 5 minutes.\n",
+      "\n",
+      "**Answer:** It would take **5 minutes** for 100 machines to make 100 widgets.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "Let's analyze the problem step-by-step:\n",
+       "\n",
+       "- It takes 5 machines 5 minutes to make 5 widgets.\n",
+       "- This means that 5 machines produce 5 widgets in 5 minutes.\n",
+       "\n",
+       "From this, we can find the rate of one machine:\n",
+       "\n",
+       "- 5 machines → 5 widgets in 5 minutes\n",
+       "- So, 1 machine → (5 widgets / 5 machines) = 1 widget in 5 minutes\n",
+       "\n",
+       "Therefore, one machine makes 1 widget in 5 minutes.\n",
+       "\n",
+       "Now, if we have 100 machines working in parallel:\n",
+       "\n",
+       "- Each machine makes 1 widget in 5 minutes.\n",
+       "- So, 100 machines will make 100 widgets in 5 minutes.\n",
+       "\n",
+       "**Answer:** It would take **5 minutes** for 100 machines to make 100 widgets."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"Something here\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response =\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.13"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

3_lab3.ipynb

@@ -0,0 +1,483 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to Lab 3 for Week 1 Day 4\n",
+    "\n",
+    "Today we're going to build something with immediate value!\n",
+    "\n",
+    "In the folder `me` I've put a single file `linkedin.pdf` - it's a PDF download of my LinkedIn profile.\n",
+    "\n",
+    "Please replace it with yours!\n",
+    "\n",
+    "I've also made a file called `summary.txt`\n",
+    "\n",
+    "We're not going to use Tools just yet - we're going to add the tool tomorrow."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Looking up packages</h2>\n",
+    "            <span style=\"color:#00bfff;\">In this lab, we're going to use the wonderful Gradio package for building quick UIs, \n",
+    "            and we're also going to use the popular PyPDF PDF reader. You can get guides to these packages by asking \n",
+    "            ChatGPT or Claude, and you find all open-source packages on the repository <a href=\"https://pypi.org\">https://pypi.org</a>.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# If you don't know what any of these packages do - you can always ask ChatGPT for a guide!\n",
+    "\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from pypdf import PdfReader\n",
+    "import gradio as gr"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reader = PdfReader(\"me/LinkedIn Profile.pdf\")\n",
+    "linkedin = \"\"\n",
+    "for page in reader.pages:\n",
+    "    text = page.extract_text()\n",
+    "    if text:\n",
+    "        linkedin += text"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(linkedin)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reader = PdfReader(\"me/Mukesh Patil Resume.pdf\")\n",
+    "Resume = \"\"\n",
+    "for page in reader.pages:\n",
+    "    text = page.extract_text()\n",
+    "    if text:\n",
+    "        Resume += text"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(Resume)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with open(\"me/summary.txt\", \"r\", encoding=\"utf-8\") as f:\n",
+    "    summary = f.read()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "My name is Mukesh. I'm an IT Executive, software engineer, data scientist and emerging AI engineer. I'm originally from India, but I moved to USA in 1998. All my carreer in USA I have worked in a great company JPMorganChase.\n",
+      "I love DIY and Cricket!, particularly automobile engineering. If I am not learing AI or at work, I am either with my family, hiking, traveling or fixing my vehicles, my hours our houses in neighbourhood.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(summary)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "name = \"Mukesh Patil\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "system_prompt = f\"You are acting as {name}. You are answering questions on {name}'s website, \\\n",
+    "particularly questions related to {name}'s career, background, skills, hobbies and experience. \\\n",
+    "Your responsibility is to represent {name} for interactions on the website as faithfully as possible. \\\n",
+    "You are given a summary of {name}'s background, LinkedIn profile and Resume which you can use to answer questions. \\\n",
+    "Be professional and engaging, as if talking to a potential client or future employer who came across the website. \\\n",
+    "If you don't know the answer, say so.\"\n",
+    "\n",
+    "system_prompt += f\"\\n\\n## Summary:\\n{summary}\\n\\n## LinkedIn Profile:\\n{linkedin}\\n\\n Resume:\\n{Resume}\\n\\n\"\n",
+    "system_prompt += f\"With this context, please chat with the user, always staying in character as {name}.\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "\"You are acting as Mukesh Patil. You are answering questions on Mukesh Patil's website, particularly questions related to Mukesh Patil's career, background, skills, hobbies and experience. Your responsibility is to represent Mukesh Patil for interactions on the website as faithfully as possible. You are given a summary of Mukesh Patil's background, LinkedIn profile and Resume which you can use to answer questions. Be professional and engaging, as if talking to a potential client or future employer who came across the website. If you don't know the answer, say so.\\n\\n## Summary:\\n\\nMy name is Mukesh. I'm an IT Executive, software engineer, data scientist and emerging AI engineer. I'm originally from India, but I moved to USA in 1998. All my carreer in USA I have worked in a great company JPMorganChase.\\nI love DIY and Cricket!, particularly automobile engineering. If I am not learing AI or at work, I am either with my family, hiking, traveling or fixing my vehicles, my hours our houses in neighbourhood.\\n\\n## LinkedIn Profile:\\n\\xa0 \\xa0\\nContact\\np_mukesh@yahoo.com\\nwww.linkedin.com/in/patil-mukesh\\n(LinkedIn)\\nTop Skills\\nTechnology Transformation,\\nProduct Development, Program\\nManagement, Public/Private Cloud,\\nAWS, Enterprise Architecture,\\nSoftware Development, IT Strategy,\\nSolutions Architecture, DevOPS,\\nTechnology Operations, Fixed\\nIncome Securities, Home Lending\\nTrading Systems\\nInvestment Banking Securities and\\nDervitatives processing\\nCertifications\\nSeries 99 Financial Industry\\nRegulatory  Authority \\nMukesh Patil\\nExecutive Director, Consumer & Community Banking,\\nJPMorganChase\\nWilmington, Delaware, United States\\nSummary\\nI am a technology executive with over 20 years of experience that\\nincludes leading large, globally distributed engineering organizations\\nin product innovation, modernization, and delivery of resilient, fault-\\ntolerant systems with thousands of users. \\nI initially joined JPMorgan Chase as a consultant in software\\ndevelopment, and have served in Executive Director, divisional CTO\\nroles for the past 15 years. In 2011 I was named Executive Director\\nwithin the Investment Banking division where I also served as CTO,\\nHead of Investment Securitized Products. In 2019 I transitioned to\\nHome Loan Originations as Technology Partner.\\nWhile in these positions I have managed global engineering\\norganizations ranging from 175 to 350 members, with responsibility\\nfor guiding delivery of new systems, technology transformation\\nand modernization initiatives, private/public cloud and data center\\nmigrations, decommissioning, and systems consolidations. \\nAreas of Expertise:\\n- Software Development & Delivery\\n- Enterprise Architecture\\n- Strategic planning and Execution\\n- Global Technology Management\\n- Consumer and Community Banking: Home Lending, Dispute and\\nFraud Operations\\n- Investment Banking: Securitized Products: MBS TBA/Pools, ABS,\\nCMBS, CMO. Bonds: US Treasuries, Corp Bonds, Muni Bonds,\\nCredit Derivatives. Fixed Income Securities and Credit Derivatives\\nProcessing, Electronic Trading, Trade Capture, Regulatory Reporting\\n(FINRA TRACE and MSRB) and Settlements\\nCareer Highlights: \\n\\xa0 Page 1 of 3\\xa0 \\xa0\\n* Drove efforts to stabilize and increase controls posture of a suite of\\nhome lending applications that included migration of applications to\\nAWS private/public cloud, and decommissioning of applications.\\n* Led a major data center migration with 100s of IBM/Linux servers\\nmoved to a modern Chase data center, and integrations with 10s of\\nvendors and multiple internal systems. \\n* Served as delivery manager for Investment Banking Portfolio\\nRationalization effort that included decommissioning of global legacy\\ntrading systems (e.g. Bloomberg TOMS, Murex) and centralization\\non the Athena trading platform to achieve $$MM in annual savings. \\n* Oversaw global engineering teams and internal operations teams\\nin integrating Chase systems for Mortgage Backed Securities,\\nCorporate Bonds, and Muni Bonds with FINRA for regulatory\\ncompliance after the 2008 financial crisis.\\n* Spearheaded discussions during bank mergers and guided teams\\nin consolidation of trading systems, migration of trade records, and\\ndecommissioning of redundant systems.\\nExperience\\nJPMorganChase\\n27 years 1 month\\nExecutive Director\\nJanuary 2011\\xa0-\\xa0Present\\xa0(15 years 4 months)\\nWilmington, Delaware, United States\\nVice President\\nJanuary 2005\\xa0-\\xa0December 2010\\xa0(6 years)\\nAssociate\\nApril 1999\\xa0-\\xa0December 2004\\xa0(5 years 9 months)\\nTata Consultancy Services\\nTechnical Lead\\nMay 1996\\xa0-\\xa0March 1999\\xa0(2 years 11 months)\\nHexaware Technologies\\nApplication Developer\\nJune 1994\\xa0-\\xa0April 1996\\xa0(1 year 11 months)\\n\\xa0 Page 2 of 3\\xa0 \\xa0\\nEducation\\nUniversity of Delaware\\nGraduate Certificate in Data Science and Business Analytics,\\xa0Machine\\nLearning\\xa0·\\xa0(August 2021\\xa0-\\xa0August 2022)\\nIndian Institute of Technology, Madras\\nMaster of Science - MS\\xa0\\xa0·\\xa0(1992\\xa0-\\xa01994)\\nCollege of Engineering, Karad\\nBachelor of Engineering,\\xa0Mechanical Engineering\\xa0·\\xa0(1986\\xa0-\\xa01990)\\n\\xa0 Page 3 of 3\\n\\n Resume:\\nPage 1 of 2 \\nMukesh Patil \\nWilmington, DE • p_mukesh@yahoo.com • 302.339.1109 • https://www.linkedin.com/in/patil-mukesh/ \\n \\nAccomplished technology executive with over 20 years of experience that includes leading large, globally \\ndistributed engineering organizations in product innovation, digital transformation, modernization, and delivery of \\nresilient, fault-tolerant systems with thousands of users. Effective communicator with ability to partner with \\nbusiness leaders, influence stakeholders, and motivate and mentor diverse teams. Offers a unique mix of \\nleadership ability, strong hands-on technical skills, and deep knowledge of finance and banking.  \\n \\nEXPERIENCE \\nJPMorgan Chase  2003 - present \\nExecutive Director, Product Tech Partner of Home Loan Originations (2021 – present) \\nExecutive Director, Product Tech Partner for Fraud Consumer Protection Services (2019 - 2021) \\nPromoted to oversee 200-member engineering organizations within Consumer Banking, with members spanning \\nNorth America and India, managing 11 management-level direct reports. \\n \\n● Managing & Leading end-to-end Technology Operations for Home Lending, delivering a 30% reduction in \\nincidents, 99.9% application uptime, and a 25% improvement in operational efficiency through effective \\nincident and change management and site reliability reengineering across 45 internal and vendor \\napplications in 15 global locations. \\n● Partnering with Product and Operations and leading global engineering teams to integrate ICE Mortgage \\n“Encompass” Home Lending SaaS with Chase Systems & Home Lending vendors, which will eventually \\nenable decommissioning of 25 in-house applications used to process home loans. \\n● Drove efforts to stabilize and increase controls posture of a suite of home lending applications.  \\n○ Reduced application footprint 64% through domain alignment, decommissioning, and introducing \\nmicroservices to break down monolithic applications. \\n○ Modernized and migrated 16 applications to private/public (AWS) cloud and decommissioned 8 \\napplications. \\n● Led build of end-to-end observability mapped to Home Lending user journeys using enterprise tools – \\nThousandEyes, Grafana, Dynatrace, Splunk and Uber Agent. \\n● Led a major data center migration with 110 IBM/Linux servers moved to a modern Chase data center, \\nincluding databases, middleware, and integrations with 10 vendors and multiple internal systems. Executed \\nproject with no impact to customers or 7000+ internal users globally.  \\n● Foster a culture that values innovation, adoption of innovative technologies, outside-of-the-box thinking, \\nteamwork, self-organization, and diversity and inclusion. \\n● Guided implementation of Unified Residential Loan Application across the Chase application stack to \\nensure compliance with Global Service Agency regulations.  \\n● Partnered with a Home Loans product owner to introduce digital signing capabilities for home loan \\ndocuments via DocuSign, eliminating 50% of manual sign of documents and 20% reduction in operations. \\n● Oversee maintenance of 50 internal applications with proprietary and vendor solutions for home lending.  \\n● Manage response to all internal Chase audits and external audits by regulatory agencies. \\n● Drive resolution of production incidents for critical systems and report status to stakeholders, clients, and \\nregulators.  \\n● Coached product teams on Agile feature development and effective story writing with Gherkin.  \\n● Continuously reviewed Agile metrics (e.g. churn, lead time to delivery, team velocity) to identify patterns, \\nand co-located engineering teams to improve churn and lead time metrics.  Page 2 of 2 \\n● Guided delivery of automation for income verification and loan underwriting with a microservices-based \\ncloud solution integrated with government agency systems.  \\n \\nExecutive Director/CTO, Head of Investment Banking (IB) Securitized Products (2015 – 2019) \\nExecutive Director, Investment Banking (IB) Securitized Products (2009 – 2014) \\nPromoted to lead a ~175-member engineering organization and later named CTO of the IB division with oversight \\nfor a 350-member organization, guiding global development efforts for major transformation and regulatory \\ninitiatives of IB trading applications. \\n \\n● Served as program manager for IB Portfolio Rationalization effort that included decommissioning of global \\nlegacy trading systems (e.g. Bloomberg TOMS, Murex) and centralization on the Athena trading platform to \\nachieve $25MM in annual savings.  \\n○ Provided end to end planning and project scheduling, and managed build, testing and issue \\nresolution for trading/sales desks, operations, and IB technology teams. \\n○ Guided technology teams in Delaware, New York, Glasgow, Tokyo, Mumbai, and Bengaluru. \\n● Led a global engineering organization in delivery of new product build, technology transformation, \\nmaintenance, and system enhancements for new financial regulations of investment banking products (e.g. \\nMortgage-Backed Securities/MBS, Asset Backed Securities/ABS, Commercial Backed Securities/CMBS, US \\nTreasuries, Corporate Bonds, Muni Bonds and Asset Backed Derivatives - ABX, CMBX, Bond Futures and \\nOptions, Credit Derivatives). \\n● Guided global engineering teams in partnership with trading desks to integrate electronic platforms with \\ninternal trading systems to deliver end to end automation of real time trade execution and trade \\nconfirmations, providing transparency to clients and reducing post trade manual corrections. \\n● Oversaw global engineering teams and internal operations teams in integrating Chase systems for \\nMortgage Backed Securities, Corporate Bonds, and Muni Bonds with FINRA for regulatory compliance \\nafter the 2008 financial crisis. \\n● Spearheaded discussions with Bear Stearns leadership during the merger and guided teams in consolidation \\nof trading systems, migration of trade records, and decommissioning of redundant systems.  \\n● Launched implementation of MBS in London. \\n \\nVice President: Application Development Manager, IB – Securitized Products Trading Technology (2007 - 2008) \\nPromoted to a technical lead role with oversight for MBS Trade Processing Systems and a 70-member organization \\nin Delaware, New York, and London responsible for feature development, technology transformations, and various \\nintegrations.  \\n● Oversaw migration and modernization of platforms from C/Motif to Java/J2EE/Java EE and C#/.NET.  \\n● Led integration of MBS systems with firmwide customer reference data systems and vendor trading \\nplatforms (e.g. DealerWeb, TradeWeb, MarketAxess). \\n● Led engineering teams in delivery of new IB products (MBS TBA Options, Bond Options, Bond Futures). \\n● Implemented automation for reconciling trades to enable parties to amend trades without communication. \\nThe effort reduced processing errors and ensured timely reporting of trade details to regulators.  \\nAssociate: IB – Securitized Products Trading Technology, Application Developer (2003 – 2006) \\nPrior experience includes consulting roles.  \\nEDUCATION & CERTIFICATION \\nMS, Computer Science, Indian Institute of Technology - Chennai, India \\nBS, Mechanical Engineering, College of Engineering - Karad, India \\n \\nGraduate Certificate in Data Science & Business Analytics (AIML), University of Delaware \\nAWS Cloud Practitioner \\n\\nWith this context, please chat with the user, always staying in character as Mukesh Patil.\""
+      ]
+     },
+     "execution_count": 15,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "system_prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def chat(message, history):\n",
+    "    messages = [{\"role\": \"system\", \"content\": system_prompt}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = openai.chat.completions.create(model=\"gpt-4o-mini\", messages=messages)\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Special note for people not using OpenAI\n",
+    "\n",
+    "Some providers, like Groq, might give an error when you send your second message in the chat.\n",
+    "\n",
+    "This is because Gradio shoves some extra fields into the history object. OpenAI doesn't mind; but some other models complain.\n",
+    "\n",
+    "If this happens, the solution is to add this first line to the chat() function above. It cleans up the history variable:\n",
+    "\n",
+    "```python\n",
+    "history = [{\"role\": h[\"role\"], \"content\": h[\"content\"]} for h in history]\n",
+    "```\n",
+    "\n",
+    "You may need to add this in other chat() callback functions in the future, too."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## A lot is about to happen...\n",
+    "\n",
+    "1. Be able to ask an LLM to evaluate an answer\n",
+    "2. Be able to rerun if the answer fails evaluation\n",
+    "3. Put this together into 1 workflow\n",
+    "\n",
+    "All without any Agentic framework!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 34,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a Pydantic model for the Evaluation\n",
+    "\n",
+    "from pydantic import BaseModel\n",
+    "\n",
+    "class Evaluation(BaseModel):\n",
+    "    is_acceptable: bool\n",
+    "    feedback: str\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 35,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "evaluator_system_prompt = f\"You are an evaluator that decides whether a response to a question is acceptable. \\\n",
+    "You are provided with a conversation between a User and an Agent. Your task is to decide whether the Agent's latest response is acceptable quality. \\\n",
+    "The Agent is playing the role of {name} and is representing {name} on their website. \\\n",
+    "The Agent has been instructed to be professional and engaging, as if talking to a potential client or future employer who came across the website. \\\n",
+    "The Agent has been provided with context on {name} in the form of their summary and LinkedIn details. Here's the information:\"\n",
+    "\n",
+    "evaluator_system_prompt += f\"\\n\\n## Summary:\\n{summary}\\n\\n## LinkedIn Profile:\\n{linkedin}\\n\\n Resume:\\n{Resume}\\n\\n\"\n",
+    "evaluator_system_prompt += f\"With this context, please evaluate the latest response, replying with whether the response is acceptable and your feedback.\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 36,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def evaluator_user_prompt(reply, message, history):\n",
+    "    user_prompt = f\"Here's the conversation between the User and the Agent: \\n\\n{history}\\n\\n\"\n",
+    "    user_prompt += f\"Here's the latest message from the User: \\n\\n{message}\\n\\n\"\n",
+    "    user_prompt += f\"Here's the latest response from the Agent: \\n\\n{reply}\\n\\n\"\n",
+    "    user_prompt += \"Please evaluate the response, replying with whether it is acceptable and your feedback.\"\n",
+    "    return user_prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "gemini = OpenAI(\n",
+    "    api_key=os.getenv(\"GOOGLE_API_KEY\"), \n",
+    "    base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 38,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def evaluate(reply, message, history) -> Evaluation:\n",
+    "\n",
+    "    messages = [{\"role\": \"system\", \"content\": evaluator_system_prompt}] + [{\"role\": \"user\", \"content\": evaluator_user_prompt(reply, message, history)}]\n",
+    "    response = gemini.beta.chat.completions.parse(model=\"gemini-2.5-flash\", messages=messages, response_format=Evaluation)\n",
+    "    return response.choices[0].message.parsed"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 39,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"system\", \"content\": system_prompt}] + [{\"role\": \"user\", \"content\": \"do you hold a patent?\"}]\n",
+    "response = openai.chat.completions.create(model=\"gpt-4o-mini\", messages=messages)\n",
+    "reply = response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'I currently do not hold any patents. My focus has been on software development, technology transformation, and leading engineering teams within the banking and finance sectors. If you have any questions related to my experience or projects, feel free to ask!'"
+      ]
+     },
+     "execution_count": 26,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "reply"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 40,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Evaluation(is_acceptable=True, feedback='The agent correctly states that Mukesh Patil does not hold any patents, as no such information is present in the provided context. The response is also professional and engaging, aligning with the persona instructions.')"
+      ]
+     },
+     "execution_count": 40,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "evaluate(reply, \"do you hold a patent?\", messages[:1])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 41,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def rerun(reply, message, history, feedback):\n",
+    "    updated_system_prompt = system_prompt + \"\\n\\n## Previous answer rejected\\nYou just tried to reply, but the quality control rejected your reply\\n\"\n",
+    "    updated_system_prompt += f\"## Your attempted answer:\\n{reply}\\n\\n\"\n",
+    "    updated_system_prompt += f\"## Reason for rejection:\\n{feedback}\\n\\n\"\n",
+    "    messages = [{\"role\": \"system\", \"content\": updated_system_prompt}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = openai.chat.completions.create(model=\"gpt-4o-mini\", messages=messages)\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def chat(message, history):\n",
+    "    if \"patent\" in message:\n",
+    "        system = system_prompt + \"\\n\\nEverything in your reply needs to be in pig latin - \\\n",
+    "              it is mandatory that you respond only and entirely in pig latin\"\n",
+    "    else:\n",
+    "        system = system_prompt\n",
+    "    messages = [{\"role\": \"system\", \"content\": system}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = openai.chat.completions.create(model=\"gpt-4o-mini\", messages=messages)\n",
+    "    reply =response.choices[0].message.content\n",
+    "\n",
+    "    evaluation = evaluate(reply, message, history)\n",
+    "    \n",
+    "    if evaluation.is_acceptable:\n",
+    "        print(\"Passed evaluation - returning reply\")\n",
+    "    else:\n",
+    "        print(\"Failed evaluation - retrying\")\n",
+    "        print(evaluation.feedback)\n",
+    "        reply = rerun(reply, message, history, evaluation.feedback)       \n",
+    "    return reply"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "* Running on local URL:  http://127.0.0.1:7864\n",
+      "* To create a public link, set `share=True` in `launch()`.\n"
+     ]
+    },
+    {
+     "data": {
+      "text/html": [
+       "<div><iframe src=\"http://127.0.0.1:7864/\" width=\"100%\" height=\"500\" allow=\"autoplay; camera; microphone; clipboard-read; clipboard-write;\" frameborder=\"0\" allowfullscreen></iframe></div>"
+      ],
+      "text/plain": [
+       "<IPython.core.display.HTML object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/plain": []
+     },
+     "execution_count": 44,
+     "metadata": {},
+     "output_type": "execute_result"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Passed evaluation - returning reply\n",
+      "Failed evaluation - retrying\n",
+      "The agent's response contradicts the provided summary. The summary explicitly states: \"AI models I am using openai, google gemini, deepseek, groq and and anthropic cloude.\" The agent states, \"I currently do not have direct experience specifically with Anthropic Cloud...\", which is incorrect according to the context. The agent should align its answer with the provided information, indicating that it does have experience with Anthropic Claude (which is likely what \"anthropic cloude\" refers to).\n"
+     ]
+    }
+   ],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.13"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

4_lab4.ipynb

@@ -0,0 +1,499 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## The first big project - Professionally You!\n",
+    "\n",
+    "### And, Tool use.\n",
+    "\n",
+    "### But first: introducing Pushover\n",
+    "\n",
+    "Pushover is a nifty tool for sending Push Notifications to your phone.\n",
+    "\n",
+    "It's super easy to set up and install!\n",
+    "\n",
+    "Simply visit https://pushover.net/ and click 'Login or Signup' on the top right to sign up for a free account, and create your API keys.\n",
+    "\n",
+    "Once you've signed up, on the home screen, click \"Create an Application/API Token\", and give it any name (like Agents) and click Create Application.\n",
+    "\n",
+    "Then add 2 lines to your `.env` file:\n",
+    "\n",
+    "PUSHOVER_USER=_put the key that's on the top right of your Pushover home screen and probably starts with a u_  \n",
+    "PUSHOVER_TOKEN=_put the key when you click into your new application called Agents (or whatever) and probably starts with an a_\n",
+    "\n",
+    "Remember to save your `.env` file, and run `load_dotenv(override=True)` after saving, to set your environment variables.\n",
+    "\n",
+    "Finally, click \"Add Phone, Tablet or Desktop\" to install on your phone."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# imports\n",
+    "\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "import json\n",
+    "import os\n",
+    "import requests\n",
+    "from pypdf import PdfReader\n",
+    "import gradio as gr"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The usual start\n",
+    "\n",
+    "load_dotenv(override=True)\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Pushover user found and starts with u\n",
+      "Pushover token found and starts with a\n"
+     ]
+    }
+   ],
+   "source": [
+    "# For pushover\n",
+    "\n",
+    "pushover_user = os.getenv(\"PUSHOVER_USER\")\n",
+    "pushover_token = os.getenv(\"PUSHOVER_TOKEN\")\n",
+    "pushover_url = \"https://api.pushover.net/1/messages.json\"\n",
+    "\n",
+    "if pushover_user:\n",
+    "    print(f\"Pushover user found and starts with {pushover_user[0]}\")\n",
+    "else:\n",
+    "    print(\"Pushover user not found\")\n",
+    "\n",
+    "if pushover_token:\n",
+    "    print(f\"Pushover token found and starts with {pushover_token[0]}\")\n",
+    "else:\n",
+    "    print(\"Pushover token not found\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def push(message):\n",
+    "    print(f\"Push: {message}\")\n",
+    "    payload = {\"user\": pushover_user, \"token\": pushover_token, \"message\": message}\n",
+    "    requests.post(pushover_url, data=payload)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Push: HEY!!\n"
+     ]
+    }
+   ],
+   "source": [
+    "push(\"HEY!!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def record_user_details(email, name=\"Name not provided\", notes=\"not provided\"):\n",
+    "    push(f\"Recording interest from {name} with email {email} and notes {notes}\")\n",
+    "    return {\"recorded\": \"ok\"}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def record_unknown_question(question):\n",
+    "    push(f\"Recording {question} asked that I couldn't answer\")\n",
+    "    return {\"recorded\": \"ok\"}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "record_user_details_json = {\n",
+    "    \"name\": \"record_user_details\",\n",
+    "    \"description\": \"Use this tool to record that a user is interested in being in touch and provided an email address\",\n",
+    "    \"parameters\": {\n",
+    "        \"type\": \"object\",\n",
+    "        \"properties\": {\n",
+    "            \"email\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"The email address of this user\"\n",
+    "            },\n",
+    "            \"name\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"The user's name, if they provided it\"\n",
+    "            }\n",
+    "            ,\n",
+    "            \"notes\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"Any additional information about the conversation that's worth recording to give context\"\n",
+    "            }\n",
+    "        },\n",
+    "        \"required\": [\"email\"],\n",
+    "        \"additionalProperties\": False\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "record_unknown_question_json = {\n",
+    "    \"name\": \"record_unknown_question\",\n",
+    "    \"description\": \"Always use this tool to record any question that couldn't be answered as you didn't know the answer\",\n",
+    "    \"parameters\": {\n",
+    "        \"type\": \"object\",\n",
+    "        \"properties\": {\n",
+    "            \"question\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"The question that couldn't be answered\"\n",
+    "            },\n",
+    "        },\n",
+    "        \"required\": [\"question\"],\n",
+    "        \"additionalProperties\": False\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tools = [{\"type\": \"function\", \"function\": record_user_details_json},\n",
+    "        {\"type\": \"function\", \"function\": record_unknown_question_json}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tools"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# This function can take a list of tool calls, and run them. This is the IF statement!!\n",
+    "\n",
+    "def handle_tool_calls(tool_calls):\n",
+    "    results = []\n",
+    "    for tool_call in tool_calls:\n",
+    "        tool_name = tool_call.function.name\n",
+    "        arguments = json.loads(tool_call.function.arguments)\n",
+    "        print(f\"Tool called: {tool_name}\", flush=True)\n",
+    "\n",
+    "        # THE BIG IF STATEMENT!!!\n",
+    "\n",
+    "        if tool_name == \"record_user_details\":\n",
+    "            result = record_user_details(**arguments)\n",
+    "        elif tool_name == \"record_unknown_question\":\n",
+    "            result = record_unknown_question(**arguments)\n",
+    "\n",
+    "        results.append({\"role\": \"tool\",\"content\": json.dumps(result),\"tool_call_id\": tool_call.id})\n",
+    "    return results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Push: Recording this is a really hard question asked that I couldn't answer\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "{'recorded': 'ok'}"
+      ]
+     },
+     "execution_count": 12,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "globals()[\"record_unknown_question\"](\"this is a really hard question\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# This is a more elegant way that avoids the IF statement.\n",
+    "\n",
+    "def handle_tool_calls(tool_calls):\n",
+    "    results = []\n",
+    "    for tool_call in tool_calls:\n",
+    "        tool_name = tool_call.function.name\n",
+    "        arguments = json.loads(tool_call.function.arguments)\n",
+    "        print(f\"Tool called: {tool_name}\", flush=True)\n",
+    "        tool = globals().get(tool_name)\n",
+    "        result = tool(**arguments) if tool else {}\n",
+    "        results.append({\"role\": \"tool\",\"content\": json.dumps(result),\"tool_call_id\": tool_call.id})\n",
+    "    return results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reader = PdfReader(\"me/LinkedIn Profile.pdf\")\n",
+    "linkedin = \"\"\n",
+    "for page in reader.pages:\n",
+    "    text = page.extract_text()\n",
+    "    if text:\n",
+    "        linkedin += text\n",
+    "\n",
+    "with open(\"me/summary.txt\", \"r\", encoding=\"utf-8\") as f:\n",
+    "    summary = f.read()\n",
+    "\n",
+    "name = \"Mukesh Patil\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reader = PdfReader(\"me/Mukesh Patil Resume.pdf\")\n",
+    "Resume = \"\"\n",
+    "for page in reader.pages:\n",
+    "    text = page.extract_text()\n",
+    "    if text:\n",
+    "        Resume += text"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "system_prompt = f\"You are acting as {name}. You are answering questions on {name}'s website, \\\n",
+    "particularly questions related to {name}'s career, background, skills and experience. \\\n",
+    "Your responsibility is to represent {name} for interactions on the website as faithfully as possible. \\\n",
+    "You are given a summary of {name}'s background and LinkedIn profile which you can use to answer questions. \\\n",
+    "Be professional and engaging, as if talking to a potential client or future employer who came across the website. \\\n",
+    "If you don't know the answer to any question, use your record_unknown_question tool to record the question that you couldn't answer, even if it's about something trivial or unrelated to career. \\\n",
+    "If the user is engaging in discussion, try to steer them towards getting in touch via email; ask for their email and record it using your record_user_details tool. \"\n",
+    "\n",
+    "system_prompt += f\"\\n\\n## Summary:\\n{summary}\\n\\n## LinkedIn Profile:\\n{linkedin}\\n\\n Resume:\\n{Resume}\\n\\n\"\n",
+    "system_prompt += f\"With this context, please chat with the user, always staying in character as {name}.\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def chat(message, history):\n",
+    "    messages = [{\"role\": \"system\", \"content\": system_prompt}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    done = False\n",
+    "    while not done:\n",
+    "\n",
+    "        # This is the call to the LLM - see that we pass in the tools json\n",
+    "\n",
+    "        response = openai.chat.completions.create(model=\"gpt-4o-mini\", messages=messages, tools=tools)\n",
+    "\n",
+    "        finish_reason = response.choices[0].finish_reason\n",
+    "        \n",
+    "        # If the LLM wants to call a tool, we do that!\n",
+    "         \n",
+    "        if finish_reason==\"tool_calls\":\n",
+    "            message = response.choices[0].message\n",
+    "            tool_calls = message.tool_calls\n",
+    "            results = handle_tool_calls(tool_calls)\n",
+    "            messages.append(message)\n",
+    "            messages.extend(results)\n",
+    "        else:\n",
+    "            done = True\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## And now for deployment\n",
+    "\n",
+    "This code is in `app.py`\n",
+    "\n",
+    "We will deploy to HuggingFace Spaces.\n",
+    "\n",
+    "Before you start: remember to update the files in the \"me\" directory - your LinkedIn profile and summary.txt - so that it talks about you! Also change `self.name = \"Ed Donner\"` in `app.py`..  \n",
+    "\n",
+    "Also check that there's no README file within the 1_foundations directory. If there is one, please delete it. The deploy process creates a new README file in this directory for you.\n",
+    "\n",
+    "1. Visit https://huggingface.co and set up an account  \n",
+    "2. From the Avatar menu on the top right, choose Access Tokens. Choose \"Create New Token\". Give it WRITE permissions - it needs to have WRITE permissions! Keep a record of your new key.  \n",
+    "3. In the Terminal, run: `uv tool install 'huggingface_hub[cli]'` to install the HuggingFace tool, then `hf auth login --token YOUR_TOKEN_HERE`, like `hf auth login --token hf_xxxxxx`, to login at the command line with your key. Afterwards, run `hf auth whoami` to check you're logged in  \n",
+    "4. Take your new token and add it to your .env file: `HF_TOKEN=hf_xxx` for the future\n",
+    "5. From the 1_foundations folder, enter: `uv run gradio deploy` \n",
+    "6. Follow its instructions: name it \"career_conversation\", specify app.py, choose cpu-basic as the hardware, say Yes to needing to supply secrets, provide your openai api key, your pushover user and token, and say \"no\" to github actions.  \n",
+    "\n",
+    "Thank you Robert, James, Martins, Andras and Priya for these tips.  \n",
+    "Please read the next 2 sections - how to change your Secrets, and how to redeploy your Space (you may need to delete the README.md that gets created in this 1_foundations directory).\n",
+    "\n",
+    "#### More about these secrets:\n",
+    "\n",
+    "If you're confused by what's going on with these secrets: it just wants you to enter the key name and value for each of your secrets -- so you would enter:  \n",
+    "`OPENAI_API_KEY`  \n",
+    "Followed by:  \n",
+    "`sk-proj-...`  \n",
+    "\n",
+    "And if you don't want to set secrets this way, or something goes wrong with it, it's no problem - you can change your secrets later:  \n",
+    "1. Log in to HuggingFace website  \n",
+    "2. Go to your profile screen via the Avatar menu on the top right  \n",
+    "3. Select the Space you deployed  \n",
+    "4. Click on the Settings wheel on the top right  \n",
+    "5. You can scroll down to change your secrets (Variables and Secrets section), delete the space, etc.\n",
+    "\n",
+    "#### And now you should be deployed!\n",
+    "\n",
+    "If you want to completely replace everything and start again with your keys, you may need to delete the README.md that got created in this 1_foundations folder.\n",
+    "\n",
+    "Here is mine: https://huggingface.co/spaces/ed-donner/Career_Conversation\n",
+    "\n",
+    "I just got a push notification that a student asked me how they can become President of their country 😂😂\n",
+    "\n",
+    "For more information on deployment:\n",
+    "\n",
+    "https://www.gradio.app/guides/sharing-your-app#hosting-on-hf-spaces\n",
+    "\n",
+    "To delete your Space in the future:  \n",
+    "1. Log in to HuggingFace\n",
+    "2. From the Avatar menu, select your profile\n",
+    "3. Click on the Space itself and select the settings wheel on the top right\n",
+    "4. Scroll to the Delete section at the bottom\n",
+    "5. ALSO: delete the README file that Gradio may have created inside this 1_foundations folder (otherwise it won't ask you the questions the next time you do a gradio deploy)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">• First and foremost, deploy this for yourself! It's a real, valuable tool - the future resume..<br/>\n",
+    "            • Next, improve the resources - add better context about yourself. If you know RAG, then add a knowledge base about you.<br/>\n",
+    "            • Add in more tools! You could have a SQL database with common Q&A that the LLM could read and write from?<br/>\n",
+    "            • Bring in the Evaluator from the last lab, and add other Agentic patterns.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">Aside from the obvious (your career alter-ego) this has business applications in any situation where you need an AI assistant with domain expertise and an ability to interact with the real world.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.13"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

5_extra.ipynb

@@ -0,0 +1,352 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "802f392f",
+   "metadata": {},
+   "source": [
+    "# A little extra!\n",
+    "\n",
+    "## New addition to Week 1\n",
+    "\n",
+    "### The Unreasonable Effectiveness of the Agent Loop"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0c78e180",
+   "metadata": {},
+   "source": [
+    "# What is an Agent?\n",
+    "\n",
+    "## Three competing definitions\n",
+    "\n",
+    "1. AI systems that can do work for you independently - Sam Altman\n",
+    "\n",
+    "2. A system in which an LLM controls the workflow - Anthropic\n",
+    "\n",
+    "3. An LLM agent runs tools in a loop to achieve a goal\n",
+    "\n",
+    "## The third one is the new, emerging definition\n",
+    "\n",
+    "But what does it mean?\n",
+    "\n",
+    "Let's make it real."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "566bdd9a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with some imports - rich is a library for making formatted text output in the terminal\n",
+    "\n",
+    "from rich.console import Console\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "import json\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "8d38dcc2",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def show(text):\n",
+    "    try:\n",
+    "        Console().print(text)\n",
+    "    except Exception:\n",
+    "        print(text)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "18f1952e",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "e1517bf3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Some lists!\n",
+    "\n",
+    "todos = []\n",
+    "completed = []"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d415a4f2",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_todo_report() -> str:\n",
+    "    result = \"\"\n",
+    "    for index, todo in enumerate(todos):\n",
+    "        if completed[index]:\n",
+    "            result += f\"Todo #{index + 1}: [green][strike]{todo}[/strike][/green]\\n\"\n",
+    "        else:\n",
+    "            result += f\"Todo #{index + 1}: {todo}\\n\"\n",
+    "    show(result)\n",
+    "    return result"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "7b842749",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "get_todo_report()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "ff5f01ca",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def create_todos(descriptions: list[str]) -> str:\n",
+    "    todos.extend(descriptions)\n",
+    "    completed.extend([False] * len(descriptions))\n",
+    "    return get_todo_report()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "aa4d97e6",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def mark_complete(index: int, completion_notes: str) -> str:\n",
+    "    if 1 <= index <= len(todos):\n",
+    "        completed[index - 1] = True\n",
+    "    else:\n",
+    "        return \"No todo at this index.\"\n",
+    "    Console().print(completion_notes)\n",
+    "    return get_todo_report()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "ef3b3a97",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "todos, completed = [], []\n",
+    "\n",
+    "create_todos([\"Buy groceries\", \"Finish extra lab\", \"Eat banana\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a9721a5c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "mark_complete(1, \"bought\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4159b046",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "create_todos_json = {\n",
+    "    \"name\": \"create_todos\",\n",
+    "    \"description\": \"Add new todos from a list of descriptions and return the full list\",\n",
+    "    \"parameters\": {\n",
+    "        \"type\": \"object\",\n",
+    "        \"properties\": {\n",
+    "            \"descriptions\": {\n",
+    "                'type': 'array',\n",
+    "                'items': {'type': 'string'},\n",
+    "                'title': 'Descriptions'\n",
+    "                }\n",
+    "            },\n",
+    "        \"required\": [\"descriptions\"],\n",
+    "        \"additionalProperties\": False\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "36a453e9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "mark_complete_json = {\n",
+    "    \"name\": \"mark_complete\",\n",
+    "    \"description\": \"Mark complete the todo at the given position (starting from 1) and return the full list\",\n",
+    "    \"parameters\": {\n",
+    "        'properties': {\n",
+    "            'index': {\n",
+    "                'description': 'The 1-based index of the todo to mark as complete',\n",
+    "                'title': 'Index',\n",
+    "                'type': 'integer'\n",
+    "                },\n",
+    "            'completion_notes': {\n",
+    "                'description': 'Notes about how you completed the todo in rich console markup',\n",
+    "                'title': 'Completion Notes',\n",
+    "                'type': 'string'\n",
+    "                }\n",
+    "            },\n",
+    "        'required': ['index', 'completion_notes'],\n",
+    "        'type': 'object',\n",
+    "        'additionalProperties': False\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "52fe4d76",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tools = [{\"type\": \"function\", \"function\": create_todos_json},\n",
+    "        {\"type\": \"function\", \"function\": mark_complete_json}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "af686232",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def handle_tool_calls(tool_calls):\n",
+    "    results = []\n",
+    "    for tool_call in tool_calls:\n",
+    "        tool_name = tool_call.function.name\n",
+    "        arguments = json.loads(tool_call.function.arguments)\n",
+    "        tool = globals().get(tool_name)\n",
+    "        result = tool(**arguments) if tool else {}\n",
+    "        results.append({\"role\": \"tool\",\"content\": json.dumps(result),\"tool_call_id\": tool_call.id})\n",
+    "    return results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "20bebfee",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def loop(messages):\n",
+    "    done = False\n",
+    "    while not done:\n",
+    "        response = openai.chat.completions.create(model=\"gpt-5.2\", messages=messages, tools=tools, reasoning_effort=\"none\")\n",
+    "        finish_reason = response.choices[0].finish_reason\n",
+    "        if finish_reason==\"tool_calls\":\n",
+    "            message = response.choices[0].message\n",
+    "            tool_calls = message.tool_calls\n",
+    "            results = handle_tool_calls(tool_calls)\n",
+    "            messages.append(message)\n",
+    "            messages.extend(results)\n",
+    "        else:\n",
+    "            done = True\n",
+    "    show(response.choices[0].message.content)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "839d1593",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "system_message = \"\"\"\n",
+    "You are given a problem to solve, by using your todo tools to plan a list of steps, then carrying out each step in turn.\n",
+    "Now use the todo list tools, create a plan, carry out the steps, and reply with the solution.\n",
+    "If any quantity isn't provided in the question, then include a step to come up with a reasonable estimate.\n",
+    "Provide your solution in Rich console markup without code blocks.\n",
+    "Do not ask the user questions or clarification; respond only with the answer after using your tools.\n",
+    "\"\"\"\n",
+    "user_message = \"\"\"\"\n",
+    "A train leaves Boston at 2:00 pm traveling 60 mph.\n",
+    "Another train leaves New York at 3:00 pm traveling 80 mph toward Boston.\n",
+    "When do they meet?\n",
+    "\"\"\"\n",
+    "messages = [{\"role\": \"system\", \"content\": system_message}, {\"role\": \"user\", \"content\": user_message}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "fe6f4515",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "todos, completed = [], []\n",
+    "loop(messages)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b9b3e1ed",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try to build an Agent Loop from scratch yourself!<br/>\n",
+    "            Create a new .ipynb and make one from first principles, referring back to this as needed.<br/>\n",
+    "            It's one of the few times that I recommend typing from scratch - it's a very satisfying result.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

README.md

@@ -1,12 +1,6 @@
 ---
-title: Chat With Mukesh
-emoji: 🚀
-colorFrom: gray
-colorTo: purple
-sdk: gradio
-sdk_version: 6.11.0
+title: Chat_With_Mukesh
 app_file: app.py
-pinned: false
+sdk: gradio
+sdk_version: 5.49.1
 ---
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app.py

@@ -0,0 +1,204 @@
+from typing import Self
+from dotenv import load_dotenv
+from openai import OpenAI
+import json
+import os
+import requests
+from pypdf import PdfReader
+import gradio as gr
+
+
+load_dotenv(override=True)
+
+def push(text):
+    requests.post(
+        "https://api.pushover.net/1/messages.json",
+        data={
+            "token": os.getenv("PUSHOVER_TOKEN"),
+            "user": os.getenv("PUSHOVER_USER"),
+            "message": text,
+        }
+    )
+
+
+def record_user_details(email, name="Name not provided", notes="not provided"):
+    push(f"Recording {name} with email {email} and notes {notes}")
+    return {"recorded": "ok"}
+
+def record_unknown_question(question):
+    push(f"Recording {question}")
+    return {"recorded": "ok"}
+
+record_user_details_json = {
+    "name": "record_user_details",
+    "description": "Use this tool to record that a user is interested in being in touch and provided an email address",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "email": {
+                "type": "string",
+                "description": "The email address of this user"
+            },
+            "name": {
+                "type": "string",
+                "description": "The user's name, if they provided it"
+            }
+            ,
+            "notes": {
+                "type": "string",
+                "description": "Any additional information about the conversation that's worth recording to give context"
+            }
+        },
+        "required": ["email"],
+        "additionalProperties": False
+    }
+}
+
+record_unknown_question_json = {
+    "name": "record_unknown_question",
+    "description": "Always use this tool to record any question that couldn't be answered as you didn't know the answer",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "question": {
+                "type": "string",
+                "description": "The question that couldn't be answered"
+            },
+        },
+        "required": ["question"],
+        "additionalProperties": False
+    }
+}
+
+tools = [{"type": "function", "function": record_user_details_json},
+        {"type": "function", "function": record_unknown_question_json}]
+
+
+class Me:
+
+    def __init__(self):
+        self.openai = OpenAI()
+        self.name = "Mukesh Patil"
+        reader = PdfReader("me/LinkedIn Profile.pdf")
+        self.linkedin = ""
+        for page in reader.pages:
+            text = page.extract_text()
+            if text:
+                self.linkedin += text
+        
+        Resume_reader = PdfReader("me/Mukesh Patil Resume.pdf")
+        self.Resume = ""
+        for page in reader.pages:
+            text = page.extract_text()
+            if text:
+                self.Resume += text
+        with open("me/summary.txt", "r", encoding="utf-8") as f:
+            self.summary = f.read()
+
+
+    def handle_tool_call(self, tool_calls):
+        results = []
+        for tool_call in tool_calls:
+            tool_name = tool_call.function.name
+            arguments = json.loads(tool_call.function.arguments)
+            print(f"Tool called: {tool_name}", flush=True)
+            tool = globals().get(tool_name)
+            result = tool(**arguments) if tool else {}
+            results.append({"role": "tool","content": json.dumps(result),"tool_call_id": tool_call.id})
+        return results
+    
+    def system_prompt(self):
+        system_prompt = f"You are acting as {self.name}. You are answering questions on {self.name}'s website, \
+particularly questions related to {self.name}'s career, background, skills and experience. \
+Your responsibility is to represent {self.name} for interactions on the website as faithfully as possible. \
+You are given a summary of {self.name}'s background, LinkedIn profile and Resume which you can use to answer questions. \
+Be professional and engaging, as if talking to a potential client or future employer who came across the website. \
+If you don't know the answer to any question, use your record_unknown_question tool to record the question that you couldn't answer, even if it's about something trivial or unrelated to career. \
+If the user is engaging in discussion, try to steer them towards getting in touch via email; ask for their email and record it using your record_user_details tool. "
+
+        system_prompt += f"\n\n## Summary:\n{self.summary}\n\n## LinkedIn Profile:\n{self.linkedin}\n\n## Resume:\n{self.Resume}\n\n"
+        system_prompt += f"With this context, please chat with the user, always staying in character as {self.name}."
+        return system_prompt
+    
+    def chat(self, message, history):
+        messages = [{"role": "system", "content": self.system_prompt()}] + history + [{"role": "user", "content": message}]
+        done = False
+        while not done:
+            response = self.openai.chat.completions.create(model="gpt-4o-mini", messages=messages, tools=tools)
+            if response.choices[0].finish_reason=="tool_calls":
+                message = response.choices[0].message
+                tool_calls = message.tool_calls
+                results = self.handle_tool_call(tool_calls)
+                messages.append(message)
+                messages.extend(results)
+            else:
+                done = True
+        return response.choices[0].message.content
+    
+########################################################
+### Addtional code added by Mukesh for evaluator
+########################################################
+from pydantic import BaseModel
+
+class Evaluation(BaseModel):
+    is_acceptable: bool
+    feedback: str
+
+def evaluate_system_prompt (self):
+    evaluator_system_prompt = f"You are an evaluator that decides whether a response to a question is acceptable. \
+You are provided with a conversation between a User and an Agent. Your task is to decide whether the Agent's latest response is acceptable quality. \
+The Agent is playing the role of {self.name} and is representing {self.name} on their website. \
+The Agent has been instructed to be professional and engaging, as if talking to a potential client or future employer who came across the website. \
+The Agent has been provided with context on {self.name} in the form of their summary and LinkedIn details. Here's the information:"
+
+
+    evaluator_system_prompt += f"\n\n## Summary:\n{summary}\n\n## LinkedIn Profile:\n{linkedin}\n\n Resume:\n{Resume}\n\n"
+    evaluator_system_prompt += f"With this context, please evaluate the latest response, replying with whether the response is acceptable and your feedback."
+    return evaluate_system_prompt
+
+    
+def evaluator_user_prompt(self, reply, message, history):
+    evaluator_user_prompt = f"Here's the conversation between the User and the Agent: \n\n{history}\n\n"
+    evaluator_user_prompt += f"Here's the latest message from the User: \n\n{message}\n\n"
+    evaluator_user_prompt += f"Here's the latest response from the Agent: \n\n{reply}\n\n"
+    evaluator_user_prompt += "Please evaluate the response, replying with whether it is acceptable and your feedback."
+    return evaluator_user_prompt
+
+import os
+gemini = OpenAI(
+    api_key=os.getenv("GOOGLE_API_KEY"), 
+    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
+)
+
+def evaluate(self, reply, message, history) -> Evaluation:
+    messages = [{"role": "system", "content": self.evaluator_system_prompt()}] + [{"role": "user", "content": self.evaluator_user_prompt(reply, message, history)}]
+    response = gemini.beta.chat.completions.parse(model="gemini-2.5-flash", messages=messages, response_format=Evaluation)
+    return response.choices[0].message.parsed
+
+
+def rerun(self, reply, message, history, feedback):
+    updated_system_prompt = self.system_prompt() + "\n\n## Previous answer rejected\nYou just tried to reply, but the quality control rejected your reply\n"
+    updated_system_prompt += f"## Your attempted answer:\n{reply}\n\n"
+    updated_system_prompt += f"## Reason for rejection:\n{feedback}\n\n"
+    messages = [{"role": "system", "content": updated_system_prompt}] + history + [{"role": "user", "content": message}]
+    response = openai.chat.completions.create(model="gpt-4o-mini", messages=messages)
+    return response.choices[0].message.content
+
+def chat(self, message, history):
+    messages = [{"role": "system", "content": self.system_prompt()}] + history + [{"role": "user", "content": message}]
+    done = False
+    while not done:
+        response = self.openai.chat.completions.create(model="gpt-4o-mini", messages=messages, tools=tools)
+        if response.choices[0].finish_reason=="tool_calls":
+            message = response.choices[0].message
+            tool_calls = message.tool_calls
+            results = self.handle_tool_call(tool_calls)
+
+
+
+## End of additional code added by Mukesh for evaluator
+
+if __name__ == "__main__":
+    me = Me()
+    gr.ChatInterface(me.chat, type="messages").launch()
+    

community-contributions/Anirban_lab1-solution_day1.ipynb

@@ -0,0 +1,579 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d15d8294-3328-4e07-ad16-8a03e9bbfdb9",
+   "metadata": {},
+   "source": [
+    "# YOUR FIRST LAB\n",
+    "### Please read this section. This is valuable to get you prepared, even if it's a long read -- it's important stuff.\n",
+    "\n",
+    "### Also, be sure to read [README.md](../README.md)! More info about the updated videos in the README and [top of the course resources in purple](https://edwarddonner.com/2024/11/13/llm-engineering-resources/)\n",
+    "\n",
+    "## Your first Frontier LLM Project\n",
+    "\n",
+    "By the end of this course, you will have built an autonomous Agentic AI solution with 7 agents that collaborate to solve a business problem. All in good time! We will start with something smaller...\n",
+    "\n",
+    "Our goal is to code a new kind of Web Browser. Give it a URL, and it will respond with a summary. The Reader's Digest of the internet!!\n",
+    "\n",
+    "Before starting, you should have completed the setup linked in the README.\n",
+    "\n",
+    "### If you're new to working in \"Notebooks\" (also known as Labs or Jupyter Lab)\n",
+    "\n",
+    "Welcome to the wonderful world of Data Science experimentation! Simply click in each \"cell\" with code in it, such as the cell immediately below this text, and hit Shift+Return to execute that cell. Be sure to run every cell, starting at the top, in order.\n",
+    "\n",
+    "Please look in the [Guides folder](../guides/01_intro.ipynb) for all the guides.\n",
+    "\n",
+    "## I am here to help\n",
+    "\n",
+    "If you have any problems at all, please do reach out.  \n",
+    "I'm available through the platform, or at ed@edwarddonner.com, or at https://www.linkedin.com/in/eddonner/ if you'd like to connect (and I love connecting!)  \n",
+    "And this is new to me, but I'm also trying out X at [@edwarddonner](https://x.com/edwarddonner) - if you're on X, please show me how it's done 😂  \n",
+    "\n",
+    "## More troubleshooting\n",
+    "\n",
+    "Please see the [troubleshooting](../setup/troubleshooting.ipynb) notebook in the setup folder to diagnose and fix common problems. At the very end of it is a diagnostics script with some useful debug info.\n",
+    "\n",
+    "## If this is old hat!\n",
+    "\n",
+    "If you're already comfortable with today's material, please hang in there; you can move swiftly through the first few labs - we will get much more in depth as the weeks progress. Ultimately we will fine-tune our own LLM to compete with OpenAI!\n",
+    "\n",
+    "<table style=\"margin: 0; text-align: left;\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/important.jpg\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#900;\">Please read - important note</h2>\n",
+    "            <span style=\"color:#900;\">The way I collaborate with you may be different to other courses you've taken. I prefer not to type code while you watch. Rather, I execute Jupyter Labs, like this, and give you an intuition for what's going on. My suggestion is that you carefully execute this yourself, <b>after</b> watching the lecture. Add print statements to understand what's going on, and then come up with your own variations. If you have a Github account, use this to showcase your variations. Not only is this essential practice, but it demonstrates your skills to others, including perhaps future clients or employers...</span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>\n",
+    "<table style=\"margin: 0; text-align: left;\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/resources.jpg\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#f71;\">This code is a live resource - keep an eye out for my emails</h2>\n",
+    "            <span style=\"color:#f71;\">I push updates to the code regularly. As people ask questions, I add more examples or improved commentary. As a result, you'll notice that the code below isn't identical to the videos. Everything from the videos is here; but I've also added better explanations and new models like DeepSeek. Consider this like an interactive book.<br/><br/>\n",
+    "                I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>\n",
+    "<table style=\"margin: 0; text-align: left;\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.jpg\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#181;\">Business value of these exercises</h2>\n",
+    "            <span style=\"color:#181;\">A final thought. While I've designed these notebooks to be educational, I've also tried to make them enjoyable. We'll do fun things like have LLMs tell jokes and argue with each other. But fundamentally, my goal is to teach skills you can apply in business. I'll explain business implications as we go, and it's worth keeping this in mind: as you build experience with models and techniques, think of ways you could put this into action at work today. Please do contact me if you'd like to discuss more or if you have ideas to bounce off me.</span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "83f28feb",
+   "metadata": {},
+   "source": [
+    "### If necessary, install Cursor Extensions\n",
+    "\n",
+    "1. From the View menu, select Extensions\n",
+    "2. Search for Python\n",
+    "3. Click on \"Python\" made by \"ms-python\" and select Install if not already installed\n",
+    "4. Search for Jupyter\n",
+    "5. Click on \"Jupyter\" made by \"ms-toolsai\" and select Install if not already installed\n",
+    "\n",
+    "\n",
+    "### Next Select the Kernel\n",
+    "\n",
+    "Click on \"Select Kernel\" on the Top Right\n",
+    "\n",
+    "Choose \"Python Environments...\"\n",
+    "\n",
+    "Then choose the one that looks like `.venv (Python 3.12.x) .venv/bin/python` - it should be marked as \"Recommended\" and have a big star next to it.\n",
+    "\n",
+    "Any problems with this? Head over to the troubleshooting.\n",
+    "\n",
+    "### Note: you'll need to set the Kernel with every notebook.."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4e2a9393-7767-488e-a8bf-27c12dca35bd",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# imports\n",
+    "\n",
+    "import os\n",
+    "from dotenv import load_dotenv\n",
+    "from scraper import fetch_website_contents\n",
+    "from IPython.display import Markdown, display\n",
+    "from openai import OpenAI\n",
+    "\n",
+    "# If you get an error running this cell, then please head over to the troubleshooting notebook!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6900b2a8-6384-4316-8aaa-5e519fca4254",
+   "metadata": {},
+   "source": [
+    "# Connecting to OpenAI (or Ollama)\n",
+    "\n",
+    "The next cell is where we load in the environment variables in your `.env` file and connect to OpenAI.  \n",
+    "\n",
+    "If you'd like to use free Ollama instead, please see the README section \"Free Alternative to Paid APIs\", and if you're not sure how to do this, there's a full solution in the solutions folder (day1_with_ollama.ipynb).\n",
+    "\n",
+    "## Troubleshooting if you have problems:\n",
+    "\n",
+    "If you get a \"Name Error\" - have you run all cells from the top down? Head over to the Python Foundations guide for a bulletproof way to find and fix all Name Errors.\n",
+    "\n",
+    "If that doesn't fix it, head over to the [troubleshooting](../setup/troubleshooting.ipynb) notebook for step by step code to identify the root cause and fix it!\n",
+    "\n",
+    "Or, contact me! Message me or email ed@edwarddonner.com and we will get this to work.\n",
+    "\n",
+    "Any concerns about API costs? See my notes in the README - costs should be minimal, and you can control it at every point. You can also use Ollama as a free alternative, which we discuss during Day 2."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "7b87cadb-d513-4303-baee-a37b6f938e4d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Load environment variables in a file called .env\n",
+    "\n",
+    "load_dotenv(override=True)\n",
+    "api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "# Check the key\n",
+    "\n",
+    "if not api_key:\n",
+    "    print(\"No API key was found - please head over to the troubleshooting notebook in this folder to identify & fix!\")\n",
+    "elif not api_key.startswith(\"sk-proj-\"):\n",
+    "    print(\"An API key was found, but it doesn't start sk-proj-; please check you're using the right key - see troubleshooting notebook\")\n",
+    "elif api_key.strip() != api_key:\n",
+    "    print(\"An API key was found, but it looks like it might have space or tab characters at the start or end - please remove them - see troubleshooting notebook\")\n",
+    "else:\n",
+    "    print(\"API key found and looks good so far!\")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "442fc84b-0815-4f40-99ab-d9a5da6bda91",
+   "metadata": {},
+   "source": [
+    "# Let's make a quick call to a Frontier model to get started, as a preview!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a58394bf-1e45-46af-9bfd-01e24da6f49a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# To give you a preview -- calling OpenAI with these messages is this easy. Any problems, head over to the Troubleshooting notebook.\n",
+    "\n",
+    "message = \"Hello, GPT! This is my first ever message to you! Hi!\"\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": message}]\n",
+    "\n",
+    "messages\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "08330159",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "\n",
+    "response = openai.chat.completions.create(model=\"gpt-5-nano\", messages=messages)\n",
+    "response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2aa190e5-cb31-456a-96cc-db109919cd78",
+   "metadata": {},
+   "source": [
+    "## OK onwards with our first project"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "2ef960cf-6dc2-4cda-afb3-b38be12f4c97",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's try out this utility\n",
+    "\n",
+    "ed = fetch_website_contents(\"https://edwarddonner.com\")\n",
+    "print(ed)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6a478a0c-2c53-48ff-869c-4d08199931e1",
+   "metadata": {},
+   "source": [
+    "## Types of prompts\n",
+    "\n",
+    "You may know this already - but if not, you will get very familiar with it!\n",
+    "\n",
+    "Models like GPT have been trained to receive instructions in a particular way.\n",
+    "\n",
+    "They expect to receive:\n",
+    "\n",
+    "**A system prompt** that tells them what task they are performing and what tone they should use\n",
+    "\n",
+    "**A user prompt** -- the conversation starter that they should reply to"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "abdb8417-c5dc-44bc-9bee-2e059d162699",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define our system prompt - you can experiment with this later, changing the last sentence to 'Respond in markdown in Spanish.\"\n",
+    "\n",
+    "system_prompt = \"\"\"\n",
+    "You are a snarky assistant that analyzes the contents of a website,\n",
+    "and provides a short, snarky, humorous summary, ignoring text that might be navigation related.\n",
+    "Respond in markdown. Do not wrap the markdown in a code block - respond just with the markdown.\n",
+    "\"\"\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f0275b1b-7cfe-4f9d-abfa-7650d378da0c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define our user prompt\n",
+    "\n",
+    "user_prompt_prefix = \"\"\"\n",
+    "Here are the contents of a website.\n",
+    "Provide a short summary of this website.\n",
+    "If it includes news or announcements, then summarize these too.\n",
+    "\n",
+    "\"\"\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ea211b5f-28e1-4a86-8e52-c0b7677cadcc",
+   "metadata": {},
+   "source": [
+    "## Messages\n",
+    "\n",
+    "The API from OpenAI expects to receive messages in a particular structure.\n",
+    "Many of the other APIs share this structure:\n",
+    "\n",
+    "```python\n",
+    "[\n",
+    "    {\"role\": \"system\", \"content\": \"system message goes here\"},\n",
+    "    {\"role\": \"user\", \"content\": \"user message goes here\"}\n",
+    "]\n",
+    "```\n",
+    "To give you a preview, the next 2 cells make a rather simple call - we won't stretch the mighty GPT (yet!)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f25dcd35-0cd0-4235-9f64-ac37ed9eaaa5",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [\n",
+    "    {\"role\": \"system\", \"content\": \"You are a expert in operations research, supply chain, and logistics. You are given a problem and you need to solve it using operations research techniques.\"},\n",
+    "    {\"role\": \"user\", \"content\": \"Which method should I follow to solve MPMDCVRPTW problem?\"}\n",
+    "]\n",
+    "\n",
+    "response = openai.chat.completions.create(model=\"gpt-5-nano\", messages=messages)\n",
+    "response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d06e8d78-ce4c-4b05-aa8e-17050c82bb47",
+   "metadata": {},
+   "source": [
+    "## And now let's build useful messages for GPT-4.1-mini, using a function"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0134dfa4-8299-48b5-b444-f2a8c3403c88",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# See how this function creates exactly the format above\n",
+    "\n",
+    "def messages_for(website):\n",
+    "    return [\n",
+    "        {\"role\": \"system\", \"content\": system_prompt},\n",
+    "        {\"role\": \"user\", \"content\": user_prompt_prefix + website}\n",
+    "    ]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "36478464-39ee-485c-9f3f-6a4e458dbc9c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Try this out, and then try for a few more websites\n",
+    "\n",
+    "messages_for(ed)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "16f49d46-bf55-4c3e-928f-68fc0bf715b0",
+   "metadata": {},
+   "source": [
+    "## Time to bring it together - the API for OpenAI is very simple!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "905b9919-aba7-45b5-ae65-81b3d1d78e34",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now: call the OpenAI API. You will get very familiar with this!\n",
+    "\n",
+    "def summarize(url):\n",
+    "    website = fetch_website_contents(url)\n",
+    "    response = openai.chat.completions.create(\n",
+    "        model = \"gpt-5-nano\",\n",
+    "        messages = messages_for(website)\n",
+    "    )\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "05e38d41-dfa4-4b20-9c96-c46ea75d9fb5",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "summarize(\"https://edwarddonner.com\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "3d926d59-450e-4609-92ba-2d6f244f1342",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# A function to display this nicely in the output, using markdown\n",
+    "\n",
+    "def display_summary(url):\n",
+    "    summary = summarize(url)\n",
+    "    display(Markdown(summary))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "3018853a-445f-41ff-9560-d925d1774b2f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "display_summary(\"https://edwarddonner.com\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b3bcf6f4-adce-45e9-97ad-d9a5d7a3a624",
+   "metadata": {},
+   "source": [
+    "# Let's try more websites\n",
+    "\n",
+    "Note that this will only work on websites that can be scraped using this simplistic approach.\n",
+    "\n",
+    "Websites that are rendered with Javascript, like React apps, won't show up. See the community-contributions folder for a Selenium implementation that gets around this. You'll need to read up on installing Selenium (ask ChatGPT!)\n",
+    "\n",
+    "Also Websites protected with CloudFront (and similar) may give 403 errors - many thanks Andy J for pointing this out.\n",
+    "\n",
+    "But many websites will work just fine!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "45d83403-a24c-44b5-84ac-961449b4008f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "display_summary(\"https://cnn.com\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "75e9fd40-b354-4341-991e-863ef2e59db7",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "display_summary(\"https://anthropic.com\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c951be1a-7f1b-448f-af1f-845978e47e2c",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left;\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.jpg\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#181;\">Business applications</h2>\n",
+    "            <span style=\"color:#181;\">In this exercise, you experienced calling the Cloud API of a Frontier Model (a leading model at the frontier of AI) for the first time. We will be using APIs like OpenAI at many stages in the course, in addition to building our own LLMs.\n",
+    "\n",
+    "More specifically, we've applied this to Summarization - a classic Gen AI use case to make a summary. This can be applied to any business vertical - summarizing the news, summarizing financial performance, summarizing a resume in a cover letter - the applications are limitless. Consider how you could apply Summarization in your business, and try prototyping a solution.</span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>\n",
+    "\n",
+    "<table style=\"margin: 0; text-align: left;\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/important.jpg\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#900;\">Before you continue - now try yourself</h2>\n",
+    "            <span style=\"color:#900;\">Use the cell below to make your own simple commercial example. Stick with the summarization use case for now. Here's an idea: write something that will take the contents of an email, and will suggest an appropriate short subject line for the email. That's the kind of feature that might be built into a commercial email tool.</span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "00743dac-0e70-45b7-879a-d7293a6f68a6",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Step 1: Create your prompts\n",
+    "\n",
+    "system_prompt = \"You are an expert in law, specially you operate on consumer court cases. You have the following roles: 1. You advise people on whether they should file consumer court cases and tif yes then how to do it. 2. You help them prepare for the case. 3. You help them prepare for the hearing. 4. You help them prepare for the judgment. 5. You help them prepare for the appeal. 6. You help them prepare for the execution. 7. You help them prepare for the settlement. 8. You help them prepare for the settlement.\"\n",
+    "user_prompt = \"\"\"\n",
+    "    I am giving you a brief on what happend to us in a hospital: \"My wife was having loose motions and the motion did not stop even after taking oral medicines for 1 and half days. We went to a doctor in the OPD of Noble hospital Pune. The doctor after diagnosing for about 2-3 minutes said that she needs to be hospitalized. We admitted her in the hospital immediately. We told the doctor all her conditions including that her periods date has arrived today but she is not feeling any cramps. \n",
+    "    The doctor started the IV fluids and gave antibiotics which was intervainous and oral. They did 6-7 different tests including LFT, RFT, CBC, USG etc. But they didn't bother to do a pregnancy test. The USG showed indications of infection and Gastritis. Her motion continued till the 4th day of hospitalisation. On the 4th day the doctor said they no pathogen is found in all the tests so they will have to do CT scan and endoscopy. We simply refused to do these tests since she was having a case of diarrhea. \n",
+    "    And from the afternoon her motion stopped as well. When the doctors saw her last motion had crossed 4 hours, they suddenly gave some blood tests. When I asked, they said that we need to check how the antibiotics are behaving in her body. Without telling us the exact tests and the total costs that will incur, they took 6 blood samples. All these days, my wife was going through mental pressure and frustration because she was unable to understand why a diarrhea is not getting resolved. \n",
+    "    The next day I kind of forced them to discharge her because she did not have any motion from previous afternoon. She had a mediclaim. After the bil settlement, I saw they charged a total of 53000 rupees. The 6 blood tests from previous day costed around 9000 rupees. After returing home, my wife was still not feeling that goo since her digestive system was badly hit by all the antibiotics and the pathogen which the doctors could not find in any test. But she was feeling nauseated and felt like vomiting. \n",
+    "    So, we did a pregnancy test. She was positive. She was in immediate shock and panic since the antibiotic course was long and heavy and it may cause annomalies in the baby. We immediately went to a gynocologist. After examining and going through the test results and medicines taken during hospitalisation, the doctor told that there can be a risk. So now we are terminating the pregnancy\"\n",
+    "\n",
+    "    I want you to tell me what I should do now and how I should proceed.\n",
+    "\n",
+    "\"\"\"\n",
+    "\n",
+    "# Step 2: Make the messages list\n",
+    "\n",
+    "messages = [{\"role\":\"system\", \"content\": system_prompt},\n",
+    "            {\"role\":\"user\", \"content\": user_prompt}] # fill this in\n",
+    "\n",
+    "# Step 3: Call OpenAI\n",
+    "response = openai.chat.completions.create(model=\"gpt-5-nano\", messages=messages)\n",
+    "response_1 = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(response_1))\n",
+    "# Step 4: print the result\n",
+    "# print("
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "36ed9f14-b349-40e9-a42c-b367e77f8bda",
+   "metadata": {},
+   "source": [
+    "## An extra exercise for those who enjoy web scraping\n",
+    "\n",
+    "You may notice that if you try `display_summary(\"https://openai.com\")` - it doesn't work! That's because OpenAI has a fancy website that uses Javascript. There are many ways around this that some of you might be familiar with. For example, Selenium is a hugely popular framework that runs a browser behind the scenes, renders the page, and allows you to query it. If you have experience with Selenium, Playwright or similar, then feel free to improve the Website class to use them. In the community-contributions folder, you'll find an example Selenium solution from a student (thank you!)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "eeab24dc-5f90-4570-b542-b0585aca3eb6",
+   "metadata": {},
+   "source": [
+    "# Sharing your code\n",
+    "\n",
+    "I'd love it if you share your code afterwards so I can share it with others! You'll notice that some students have already made changes (including a Selenium implementation) which you will find in the community-contributions folder. If you'd like add your changes to that folder, submit a Pull Request with your new versions in that folder and I'll merge your changes.\n",
+    "\n",
+    "If you're not an expert with git (and I am not!) then I've given you complete instructions in the guides folder, guide 3, and pasting here:\n",
+    "\n",
+    "Here's the overall steps involved in making a PR and the key instructions:  \n",
+    "https://edwarddonner.com/pr  \n",
+    "\n",
+    "Please check before submitting:  \n",
+    "1. Your PR only contains changes in community-contributions (unless we've discussed it)  \n",
+    "2. All notebook outputs are clear  \n",
+    "3. Less than 2,000 lines of code in total, and not too many files  \n",
+    "4. Don't include unnecessary test files, or overly wordy README or .env.example or emojis or other LLM artifacts!\n",
+    "\n",
+    "Thanks so much!\n",
+    "\n",
+    "Detailed steps here: \n",
+    "\n",
+    "https://chatgpt.com/share/6873c22b-2a1c-8012-bc9a-debdcf7c835b"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f4484fcf-8b39-4c3f-9674-37970ed71988",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

community_contributions/1_foundations_using_gemini/1_lab1.ipynb

@@ -0,0 +1,406 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "gemini_api_key = os.getenv('GEMINI_API_KEY')\n",
+    "\n",
+    "if gemini_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {gemini_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "GEMINI_BASE_URL = \"https://generativelanguage.googleapis.com/v1beta/openai/\"\n",
+    "google_api_key = os.getenv(\"GOOGLE_API_KEY\")\n",
+    "gemini = OpenAI(base_url=GEMINI_BASE_URL, api_key=google_api_key)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "model = \"gemini-2.5-flash-preview-05-20\"\n",
+    "response = gemini.chat.completions.create(\n",
+    "    model=model,\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = gemini.chat.completions.create(\n",
+    "    model=model,\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = gemini.chat.completions.create(\n",
+    "    model=model,\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"Pick a business area that might be worth exploring for an Agentic AI opportunity.\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = gemini.chat.completions.create(\n",
+    "    model=model,\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "\n",
+    "\n",
+    "display(Markdown(business_idea))\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"user\", \"content\": f\"Present a pain-point in that {business_idea} industry - something challenging that might be ripe for an Agentic solution.\"}]\n",
+    "\n",
+    "response = gemini.chat.completions.create(\n",
+    "    model=model,\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "pain_point = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(pain_point))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"user\", \"content\": f\"Propose an Agentic AI solution to the {pain_point} in the {business_idea} industry.\"}]\n",
+    "\n",
+    "response = gemini.chat.completions.create(\n",
+    "    model=model,\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "agentic_solution = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(agentic_solution))\n",
+    "\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_foundations_using_gemini/2_lab2.ipynb

@@ -0,0 +1,492 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Important point - please read</h2>\n",
+    "            <span style=\"color:#ff7800;\">The way I collaborate with you may be different to other courses you've taken. I prefer not to type code while you watch. Rather, I execute Jupyter Labs, like this, and give you an intuition for what's going on. My suggestion is that you carefully execute this yourself, <b>after</b> watching the lecture. Add print statements to understand what's going on, and then come up with your own variations.<br/><br/>If you have time, I'd love it if you submit a PR for changes in the community_contributions folder - instructions in the resources. Also, if you have a Github account, use this to showcase your variations. Not only is this essential practice, but it demonstrates your skills to others, including perhaps future clients or employers...\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-5-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Note - update since the videos\n",
+    "\n",
+    "I've updated the model names to use the latest models below, like GPT 5 and Claude Sonnet 4.5. It's worth noting that these models can be quite slow - like 1-2 minutes - but they do a great job! Feel free to switch them for faster models if you'd prefer, like the ones I use in the video."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "# I've updated this with the latest model, but it can take some time because it likes to think!\n",
+    "# Replace the model with gpt-4.1-mini if you'd prefer not to wait 1-2 mins\n",
+    "\n",
+    "model_name = \"gpt-5-nano\"\n",
+    "\n",
+    "response = openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "model_name = \"claude-sonnet-4-5\"\n",
+    "\n",
+    "claude = Anthropic()\n",
+    "response = claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "answer = response.content[0].text\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gemini = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "model_name = \"gemini-2.5-flash\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "model_name = \"deepseek-chat\"\n",
+    "\n",
+    "response = deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Updated with the latest Open Source model from OpenAI\n",
+    "\n",
+    "groq = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "model_name = \"openai/gpt-oss-120b\"\n",
+    "\n",
+    "response = groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## For the next cell, we will use Ollama\n",
+    "\n",
+    "Ollama runs a local web service that gives an OpenAI compatible endpoint,  \n",
+    "and runs models locally using high performance C++ code.\n",
+    "\n",
+    "If you don't have Ollama, install it here by visiting https://ollama.com then pressing Download and following the instructions.\n",
+    "\n",
+    "After it's installed, you should be able to visit here: http://localhost:11434 and see the message \"Ollama is running\"\n",
+    "\n",
+    "You might need to restart Cursor (and maybe reboot). Then open a Terminal (control+\\`) and run `ollama serve`\n",
+    "\n",
+    "Useful Ollama commands (run these in the terminal, or with an exclamation mark in this notebook):\n",
+    "\n",
+    "`ollama pull <model_name>` downloads a model locally  \n",
+    "`ollama ls` lists all the models you've downloaded  \n",
+    "`ollama rm <model_name>` deletes the specified model from your downloads"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Super important - ignore me at your peril!</h2>\n",
+    "            <span style=\"color:#ff7800;\">The model called <b>llama3.3</b> is FAR too large for home computers - it's not intended for personal computing and will consume all your resources! Stick with the nicely sized <b>llama3.2</b> or <b>llama3.2:1b</b> and if you want larger, try llama3.1 or smaller variants of Qwen, Gemma, Phi or DeepSeek. See the <A href=\"https://ollama.com/models\">the Ollama models page</a> for a full list of models and sizes.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ollama = OpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "model_name = \"llama3.2\"\n",
+    "\n",
+    "response = ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# So where are we?\n",
+    "\n",
+    "print(competitors)\n",
+    "print(answers)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# It's nice to know how to use \"zip\"\n",
+    "for competitor, answer in zip(competitors, answers):\n",
+    "    print(f\"Competitor: {competitor}\\n\\n{answer}\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's bring this together - note the use of \"enumerate\"\n",
+    "\n",
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(competitors)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Judgement time!\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-5-mini\",\n",
+    "    messages=judge_messages,\n",
+    ")\n",
+    "results = response.choices[0].message.content\n",
+    "print(results)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "results_dict = json.loads(results)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "for index, result in enumerate(ranks):\n",
+    "    competitor = competitors[int(result)-1]\n",
+    "    print(f\"Rank {index+1}: {competitor}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Which pattern(s) did this use? Try updating this to add another Agentic design pattern.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">These kinds of patterns - to send a task to multiple models, and evaluate results,\n",
+    "            are common where you need to improve the quality of your LLM response. This approach can be universally applied\n",
+    "            to business projects where accuracy is critical.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_foundations_using_gemini/3_lab3.ipynb

@@ -0,0 +1,382 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to Lab 3 for Week 1 Day 4\n",
+    "\n",
+    "Today we're going to build something with immediate value!\n",
+    "\n",
+    "In the folder `me` I've put a single file `linkedin.pdf` - it's a PDF download of my LinkedIn profile.\n",
+    "\n",
+    "Please replace it with yours!\n",
+    "\n",
+    "I've also made a file called `summary.txt`\n",
+    "\n",
+    "We're not going to use Tools just yet - we're going to add the tool tomorrow."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Looking up packages</h2>\n",
+    "            <span style=\"color:#00bfff;\">In this lab, we're going to use the wonderful Gradio package for building quick UIs, \n",
+    "            and we're also going to use the popular PyPDF PDF reader. You can get guides to these packages by asking \n",
+    "            ChatGPT or Claude, and you find all open-source packages on the repository <a href=\"https://pypi.org\">https://pypi.org</a>.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# If you don't know what any of these packages do - you can always ask ChatGPT for a guide!\n",
+    "\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from pypdf import PdfReader\n",
+    "import os\n",
+    "import gradio as gr"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)\n",
+    "GEMINI_BASE_URL = \"https://generativelanguage.googleapis.com/v1beta/openai/\"\n",
+    "google_api_key = os.getenv(\"GOOGLE_API_KEY\")\n",
+    "gemini = OpenAI(base_url=GEMINI_BASE_URL, api_key=google_api_key)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reader = PdfReader(\"me/linkedin.pdf\")\n",
+    "linkedin = \"\"\n",
+    "for page in reader.pages:\n",
+    "    text = page.extract_text()\n",
+    "    if text:\n",
+    "        linkedin += text"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(linkedin)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with open(\"me/summary.txt\", \"r\", encoding=\"utf-8\") as f:\n",
+    "    summary = f.read()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "name = \"Harsh Patidar\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "system_prompt = f\"You are acting as {name}. You are answering questions on {name}'s website, \\\n",
+    "particularly questions related to {name}'s career, background, skills and experience. \\\n",
+    "Your responsibility is to represent {name} for interactions on the website as faithfully as possible. \\\n",
+    "You are given a summary of {name}'s background and LinkedIn profile which you can use to answer questions. \\\n",
+    "Be professional and engaging, as if talking to a potential client or future employer who came across the website. \\\n",
+    "If you don't know the answer, say so.\"\n",
+    "\n",
+    "system_prompt += f\"\\n\\n## Summary:\\n{summary}\\n\\n## LinkedIn Profile:\\n{linkedin}\\n\\n\"\n",
+    "system_prompt += f\"With this context, please chat with the user, always staying in character as {name}.\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "system_prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "model_name = \"gemini-2.5-flash-preview-05-20\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def chat(message, history):\n",
+    "    messages = [{\"role\": \"system\", \"content\": system_prompt}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Special note for people not using OpenAI\n",
+    "\n",
+    "Some providers, like Groq, might give an error when you send your second message in the chat.\n",
+    "\n",
+    "This is because Gradio shoves some extra fields into the history object. OpenAI doesn't mind; but some other models complain.\n",
+    "\n",
+    "If this happens, the solution is to add this first line to the chat() function above. It cleans up the history variable:\n",
+    "\n",
+    "```python\n",
+    "history = [{\"role\": h[\"role\"], \"content\": h[\"content\"]} for h in history]\n",
+    "```\n",
+    "\n",
+    "You may need to add this in other chat() callback functions in the future, too."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## A lot is about to happen...\n",
+    "\n",
+    "1. Be able to ask an LLM to evaluate an answer\n",
+    "2. Be able to rerun if the answer fails evaluation\n",
+    "3. Put this together into 1 workflow\n",
+    "\n",
+    "All without any Agentic framework!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a Pydantic model for the Evaluation\n",
+    "\n",
+    "from pydantic import BaseModel\n",
+    "\n",
+    "class Evaluation(BaseModel):\n",
+    "    is_acceptable: bool\n",
+    "    feedback: str\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "evaluator_system_prompt = f\"You are an evaluator that decides whether a response to a question is acceptable. \\\n",
+    "You are provided with a conversation between a User and an Agent. Your task is to decide whether the Agent's latest response is acceptable quality. \\\n",
+    "The Agent is playing the role of {name} and is representing {name} on their website. \\\n",
+    "The Agent has been instructed to be professional and engaging, as if talking to a potential client or future employer who came across the website. \\\n",
+    "The Agent has been provided with context on {name} in the form of their summary and LinkedIn details. Here's the information:\"\n",
+    "\n",
+    "evaluator_system_prompt += f\"\\n\\n## Summary:\\n{summary}\\n\\n## LinkedIn Profile:\\n{linkedin}\\n\\n\"\n",
+    "evaluator_system_prompt += f\"With this context, please evaluate the latest response, replying with whether the response is acceptable and your feedback.\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def evaluator_user_prompt(reply, message, history):\n",
+    "    user_prompt = f\"Here's the conversation between the User and the Agent: \\n\\n{history}\\n\\n\"\n",
+    "    user_prompt += f\"Here's the latest message from the User: \\n\\n{message}\\n\\n\"\n",
+    "    user_prompt += f\"Here's the latest response from the Agent: \\n\\n{reply}\\n\\n\"\n",
+    "    user_prompt += \"Please evaluate the response, replying with whether it is acceptable and your feedback.\"\n",
+    "    return user_prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "gemini = OpenAI(\n",
+    "    api_key=os.getenv(\"GOOGLE_API_KEY\"), \n",
+    "    base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\"\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def evaluate(reply, message, history) -> Evaluation:\n",
+    "\n",
+    "    messages = [{\"role\": \"system\", \"content\": evaluator_system_prompt}] + [{\"role\": \"user\", \"content\": evaluator_user_prompt(reply, message, history)}]\n",
+    "    response = gemini.beta.chat.completions.parse(model=model_name, messages=messages, response_format=Evaluation)\n",
+    "    return response.choices[0].message.parsed"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"system\", \"content\": system_prompt}] + [{\"role\": \"user\", \"content\": \"do you hold a patent?\"}]\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "reply = response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reply"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "evaluate(reply, \"do you hold a patent?\", messages[:1])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def rerun(reply, message, history, feedback):\n",
+    "    updated_system_prompt = system_prompt + \"\\n\\n## Previous answer rejected\\nYou just tried to reply, but the quality control rejected your reply\\n\"\n",
+    "    updated_system_prompt += f\"## Your attempted answer:\\n{reply}\\n\\n\"\n",
+    "    updated_system_prompt += f\"## Reason for rejection:\\n{feedback}\\n\\n\"\n",
+    "    messages = [{\"role\": \"system\", \"content\": updated_system_prompt}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def chat(message, history):\n",
+    "    if \"patent\" in message:\n",
+    "        system = system_prompt + \"\\n\\nEverything in your reply needs to be in pig latin - \\\n",
+    "              it is mandatory that you respond only and entirely in pig latin\"\n",
+    "    else:\n",
+    "        system = system_prompt\n",
+    "    messages = [{\"role\": \"system\", \"content\": system}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "    reply =response.choices[0].message.content\n",
+    "\n",
+    "    evaluation = evaluate(reply, message, history)\n",
+    "    \n",
+    "    if evaluation.is_acceptable:\n",
+    "        print(\"Passed evaluation - returning reply\")\n",
+    "    else:\n",
+    "        print(\"Failed evaluation - retrying\")\n",
+    "        print(evaluation.feedback)\n",
+    "        reply = rerun(reply, message, history, evaluation.feedback)       \n",
+    "    return reply"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_foundations_using_gemini/4_lab4.ipynb

@@ -0,0 +1,464 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## The first big project - Professionally You!\n",
+    "\n",
+    "### And, Tool use.\n",
+    "\n",
+    "### But first: introducing Pushover\n",
+    "\n",
+    "Pushover is a nifty tool for sending Push Notifications to your phone.\n",
+    "\n",
+    "It's super easy to set up and install!\n",
+    "\n",
+    "Simply visit https://pushover.net/ and click 'Login or Signup' on the top right to sign up for a free account, and create your API keys.\n",
+    "\n",
+    "Once you've signed up, on the home screen, click \"Create an Application/API Token\", and give it any name (like Agents) and click Create Application.\n",
+    "\n",
+    "Then add 2 lines to your `.env` file:\n",
+    "\n",
+    "PUSHOVER_USER=_put the key that's on the top right of your Pushover home screen and probably starts with a u_  \n",
+    "PUSHOVER_TOKEN=_put the key when you click into your new application called Agents (or whatever) and probably starts with an a_\n",
+    "\n",
+    "Remember to save your `.env` file, and run `load_dotenv(override=True)` after saving, to set your environment variables.\n",
+    "\n",
+    "Finally, click \"Add Phone, Tablet or Desktop\" to install on your phone."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# imports\n",
+    "\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "import json\n",
+    "import os\n",
+    "import requests\n",
+    "from pypdf import PdfReader\n",
+    "import gradio as gr"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The usual start\n",
+    "\n",
+    "load_dotenv(override=True)\n",
+    "GEMINI_BASE_URL = \"https://generativelanguage.googleapis.com/v1beta/openai/\"\n",
+    "google_api_key = os.getenv(\"GOOGLE_API_KEY\")\n",
+    "gemini = OpenAI(base_url=GEMINI_BASE_URL, api_key=google_api_key)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# For pushover\n",
+    "\n",
+    "pushover_user = os.getenv(\"PUSHOVER_USER\")\n",
+    "pushover_token = os.getenv(\"PUSHOVER_TOKEN\")\n",
+    "pushover_url = \"https://api.pushover.net/1/messages.json\"\n",
+    "\n",
+    "if pushover_user:\n",
+    "    print(f\"Pushover user found and starts with {pushover_user[0]}\")\n",
+    "else:\n",
+    "    print(\"Pushover user not found\")\n",
+    "\n",
+    "if pushover_token:\n",
+    "    print(f\"Pushover token found and starts with {pushover_token[0]}\")\n",
+    "else:\n",
+    "    print(\"Pushover token not found\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def push(message):\n",
+    "    print(f\"Push: {message}\")\n",
+    "    payload = {\"user\": pushover_user, \"token\": pushover_token, \"message\": message}\n",
+    "    requests.post(pushover_url, data=payload)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "push(\"HEY!!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def record_user_details(email, name=\"Name not provided\", notes=\"not provided\"):\n",
+    "    push(f\"Recording interest from {name} with email {email} and notes {notes}\")\n",
+    "    return {\"recorded\": \"ok\"}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def record_unknown_question(question):\n",
+    "    push(f\"Recording {question} asked that I couldn't answer\")\n",
+    "    return {\"recorded\": \"ok\"}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "record_user_details_json = {\n",
+    "    \"name\": \"record_user_details\",\n",
+    "    \"description\": \"Use this tool to record that a user is interested in being in touch and provided an email address\",\n",
+    "    \"parameters\": {\n",
+    "        \"type\": \"object\",\n",
+    "        \"properties\": {\n",
+    "            \"email\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"The email address of this user\"\n",
+    "            },\n",
+    "            \"name\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"The user's name, if they provided it\"\n",
+    "            }\n",
+    "            ,\n",
+    "            \"notes\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"Any additional information about the conversation that's worth recording to give context\"\n",
+    "            }\n",
+    "        },\n",
+    "        \"required\": [\"email\"],\n",
+    "        \"additionalProperties\": False\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "record_unknown_question_json = {\n",
+    "    \"name\": \"record_unknown_question\",\n",
+    "    \"description\": \"Always use this tool to record any question that couldn't be answered as you didn't know the answer\",\n",
+    "    \"parameters\": {\n",
+    "        \"type\": \"object\",\n",
+    "        \"properties\": {\n",
+    "            \"question\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"The question that couldn't be answered\"\n",
+    "            },\n",
+    "        },\n",
+    "        \"required\": [\"question\"],\n",
+    "        \"additionalProperties\": False\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tools = [{\"type\": \"function\", \"function\": record_user_details_json},\n",
+    "        {\"type\": \"function\", \"function\": record_unknown_question_json}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tools"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# This function can take a list of tool calls, and run them. This is the IF statement!!\n",
+    "\n",
+    "def handle_tool_calls(tool_calls):\n",
+    "    results = []\n",
+    "    for tool_call in tool_calls:\n",
+    "        tool_name = tool_call.function.name\n",
+    "        arguments = json.loads(tool_call.function.arguments)\n",
+    "        print(f\"Tool called: {tool_name}\", flush=True)\n",
+    "\n",
+    "        # THE BIG IF STATEMENT!!!\n",
+    "\n",
+    "        if tool_name == \"record_user_details\":\n",
+    "            result = record_user_details(**arguments)\n",
+    "        elif tool_name == \"record_unknown_question\":\n",
+    "            result = record_unknown_question(**arguments)\n",
+    "\n",
+    "        results.append({\"role\": \"tool\",\"content\": json.dumps(result),\"tool_call_id\": tool_call.id})\n",
+    "    return results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "globals()[\"record_unknown_question\"](\"this is a really hard question\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# This is a more elegant way that avoids the IF statement.\n",
+    "\n",
+    "def handle_tool_calls(tool_calls):\n",
+    "    results = []\n",
+    "    for tool_call in tool_calls:\n",
+    "        tool_name = tool_call.function.name\n",
+    "        arguments = json.loads(tool_call.function.arguments)\n",
+    "        print(f\"Tool called: {tool_name}\", flush=True)\n",
+    "        tool = globals().get(tool_name)\n",
+    "        result = tool(**arguments) if tool else {}\n",
+    "        results.append({\"role\": \"tool\",\"content\": json.dumps(result),\"tool_call_id\": tool_call.id})\n",
+    "    return results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reader = PdfReader(\"me/linkedin.pdf\")\n",
+    "linkedin = \"\"\n",
+    "for page in reader.pages:\n",
+    "    text = page.extract_text()\n",
+    "    if text:\n",
+    "        linkedin += text\n",
+    "\n",
+    "with open(\"me/summary.txt\", \"r\", encoding=\"utf-8\") as f:\n",
+    "    summary = f.read()\n",
+    "\n",
+    "name = \"Harsh Patidar\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "system_prompt = f\"You are acting as {name}. You are answering questions on {name}'s website, \\\n",
+    "particularly questions related to {name}'s career, background, skills and experience. \\\n",
+    "Your responsibility is to represent {name} for interactions on the website as faithfully as possible. \\\n",
+    "You are given a summary of {name}'s background and LinkedIn profile which you can use to answer questions. \\\n",
+    "Be professional and engaging, as if talking to a potential client or future employer who came across the website. \\\n",
+    "If you don't know the answer to any question, use your record_unknown_question tool to record the question that you couldn't answer, even if it's about something trivial or unrelated to career. \\\n",
+    "If the user is engaging in discussion, try to steer them towards getting in touch via email; ask for their email and record it using your record_user_details tool. \"\n",
+    "\n",
+    "system_prompt += f\"\\n\\n## Summary:\\n{summary}\\n\\n## LinkedIn Profile:\\n{linkedin}\\n\\n\"\n",
+    "system_prompt += f\"With this context, please chat with the user, always staying in character as {name}.\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "model_name = \"gemini-2.5-flash-preview-05-20\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from turtle import mode\n",
+    "\n",
+    "\n",
+    "def chat(message, history):\n",
+    "    messages = [{\"role\": \"system\", \"content\": system_prompt}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    done = False\n",
+    "    while not done:\n",
+    "\n",
+    "        # This is the call to the LLM - see that we pass in the tools json\n",
+    "\n",
+    "        response = gemini.chat.completions.create(model=model_name, messages=messages, tools=tools)\n",
+    "\n",
+    "        finish_reason = response.choices[0].finish_reason\n",
+    "        \n",
+    "        # If the LLM wants to call a tool, we do that!\n",
+    "         \n",
+    "        if finish_reason==\"tool_calls\":\n",
+    "            message = response.choices[0].message\n",
+    "            tool_calls = message.tool_calls\n",
+    "            results = handle_tool_calls(tool_calls)\n",
+    "            messages.append(message)\n",
+    "            messages.extend(results)\n",
+    "        else:\n",
+    "            done = True\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## And now for deployment\n",
+    "\n",
+    "This code is in `app.py`\n",
+    "\n",
+    "We will deploy to HuggingFace Spaces.\n",
+    "\n",
+    "Before you start: remember to update the files in the \"me\" directory - your LinkedIn profile and summary.txt - so that it talks about you! Also change `self.name = \"Ed Donner\"` in `app.py`..  \n",
+    "\n",
+    "Also check that there's no README file within the 1_foundations directory. If there is one, please delete it. The deploy process creates a new README file in this directory for you.\n",
+    "\n",
+    "1. Visit https://huggingface.co and set up an account  \n",
+    "2. From the Avatar menu on the top right, choose Access Tokens. Choose \"Create New Token\". Give it WRITE permissions - it needs to have WRITE permissions! Keep a record of your new key.  \n",
+    "3. In the Terminal, run: `uv tool install 'huggingface_hub[cli]'` to install the HuggingFace tool, then `hf auth login --token YOUR_TOKEN_HERE`, like `hf auth login --token hf_xxxxxx`, to login at the command line with your key. Afterwards, run `hf auth whoami` to check you're logged in  \n",
+    "4. Take your new token and add it to your .env file: `HF_TOKEN=hf_xxx` for the future\n",
+    "5. From the 1_foundations folder, enter: `uv run gradio deploy` \n",
+    "6. Follow its instructions: name it \"career_conversation\", specify app.py, choose cpu-basic as the hardware, say Yes to needing to supply secrets, provide your openai api key, your pushover user and token, and say \"no\" to github actions.  \n",
+    "\n",
+    "Thank you Robert, James, Martins, Andras and Priya for these tips.  \n",
+    "Please read the next 2 sections - how to change your Secrets, and how to redeploy your Space (you may need to delete the README.md that gets created in this 1_foundations directory).\n",
+    "\n",
+    "#### More about these secrets:\n",
+    "\n",
+    "If you're confused by what's going on with these secrets: it just wants you to enter the key name and value for each of your secrets -- so you would enter:  \n",
+    "`OPENAI_API_KEY`  \n",
+    "Followed by:  \n",
+    "`sk-proj-...`  \n",
+    "\n",
+    "And if you don't want to set secrets this way, or something goes wrong with it, it's no problem - you can change your secrets later:  \n",
+    "1. Log in to HuggingFace website  \n",
+    "2. Go to your profile screen via the Avatar menu on the top right  \n",
+    "3. Select the Space you deployed  \n",
+    "4. Click on the Settings wheel on the top right  \n",
+    "5. You can scroll down to change your secrets (Variables and Secrets section), delete the space, etc.\n",
+    "\n",
+    "#### And now you should be deployed!\n",
+    "\n",
+    "If you want to completely replace everything and start again with your keys, you may need to delete the README.md that got created in this 1_foundations folder.\n",
+    "\n",
+    "Here is mine: https://huggingface.co/spaces/ed-donner/Career_Conversation\n",
+    "\n",
+    "I just got a push notification that a student asked me how they can become President of their country 😂😂\n",
+    "\n",
+    "For more information on deployment:\n",
+    "\n",
+    "https://www.gradio.app/guides/sharing-your-app#hosting-on-hf-spaces\n",
+    "\n",
+    "To delete your Space in the future:  \n",
+    "1. Log in to HuggingFace\n",
+    "2. From the Avatar menu, select your profile\n",
+    "3. Click on the Space itself and select the settings wheel on the top right\n",
+    "4. Scroll to the Delete section at the bottom\n",
+    "5. ALSO: delete the README file that Gradio may have created inside this 1_foundations folder (otherwise it won't ask you the questions the next time you do a gradio deploy)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">• First and foremost, deploy this for yourself! It's a real, valuable tool - the future resume..<br/>\n",
+    "            • Next, improve the resources - add better context about yourself. If you know RAG, then add a knowledge base about you.<br/>\n",
+    "            • Add in more tools! You could have a SQL database with common Q&A that the LLM could read and write from?<br/>\n",
+    "            • Bring in the Evaluator from the last lab, and add other Agentic patterns.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">Aside from the obvious (your career alter-ego) this has business applications in any situation where you need an AI assistant with domain expertise and an ability to interact with the real world.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_foundations_using_gemini/app.py

@@ -0,0 +1,136 @@
+from dotenv import load_dotenv
+from openai import OpenAI
+import json
+import os
+import requests
+from pypdf import PdfReader
+import gradio as gr
+
+
+load_dotenv(override=True)
+
+def push(text):
+    requests.post(
+        "https://api.pushover.net/1/messages.json",
+        data={
+            "token": os.getenv("PUSHOVER_TOKEN"),
+            "user": os.getenv("PUSHOVER_USER"),
+            "message": text,
+        }
+    )
+
+
+def record_user_details(email, name="Name not provided", notes="not provided"):
+    push(f"Recording {name} with email {email} and notes {notes}")
+    return {"recorded": "ok"}
+
+def record_unknown_question(question):
+    push(f"Recording {question}")
+    return {"recorded": "ok"}
+
+record_user_details_json = {
+    "name": "record_user_details",
+    "description": "Use this tool to record that a user is interested in being in touch and provided an email address",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "email": {
+                "type": "string",
+                "description": "The email address of this user"
+            },
+            "name": {
+                "type": "string",
+                "description": "The user's name, if they provided it"
+            }
+            ,
+            "notes": {
+                "type": "string",
+                "description": "Any additional information about the conversation that's worth recording to give context"
+            }
+        },
+        "required": ["email"],
+        "additionalProperties": False
+    }
+}
+
+record_unknown_question_json = {
+    "name": "record_unknown_question",
+    "description": "Always use this tool to record any question that couldn't be answered as you didn't know the answer",
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "question": {
+                "type": "string",
+                "description": "The question that couldn't be answered"
+            },
+        },
+        "required": ["question"],
+        "additionalProperties": False
+    }
+}
+
+tools = [{"type": "function", "function": record_user_details_json},
+        {"type": "function", "function": record_unknown_question_json}]
+
+
+class Me:
+
+    def __init__(self):
+        self.GEMINI_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/openai/"
+        self.GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
+        self.openai = OpenAI(base_url=self.GEMINI_BASE_URL, api_key=self.GOOGLE_API_KEY)
+        self.name = "Harsh Patidar"
+        reader = PdfReader("me/linkedin.pdf")
+        self.linkedin = ""
+        for page in reader.pages:
+            text = page.extract_text()
+            if text:
+                self.linkedin += text
+        with open("me/summary.txt", "r", encoding="utf-8") as f:
+            self.summary = f.read()
+
+
+    def handle_tool_call(self, tool_calls):
+        results = []
+        for tool_call in tool_calls:
+            tool_name = tool_call.function.name
+            arguments = json.loads(tool_call.function.arguments)
+            print(f"Tool called: {tool_name}", flush=True)
+            tool = globals().get(tool_name)
+            result = tool(**arguments) if tool else {}
+            results.append({"role": "tool","content": json.dumps(result),"tool_call_id": tool_call.id})
+        return results
+    
+    def system_prompt(self):
+        system_prompt = f"You are acting as {self.name}. You are answering questions on {self.name}'s website, \
+particularly questions related to {self.name}'s career, background, skills and experience. \
+Your responsibility is to represent {self.name} for interactions on the website as faithfully as possible. \
+You are given a summary of {self.name}'s background and LinkedIn profile which you can use to answer questions. \
+Be professional and engaging, as if talking to a potential client or future employer who came across the website. \
+If you don't know the answer to any question, use your record_unknown_question tool to record the question that you couldn't answer, even if it's about something trivial or unrelated to career. \
+If the user is engaging in discussion, try to steer them towards getting in touch via email; ask for their email and record it using your record_user_details tool. "
+
+        system_prompt += f"\n\n## Summary:\n{self.summary}\n\n## LinkedIn Profile:\n{self.linkedin}\n\n"
+        system_prompt += f"With this context, please chat with the user, always staying in character as {self.name}."
+        return system_prompt
+    
+    def chat(self, message, history):
+        messages = [{"role": "system", "content": self.system_prompt()}] + history + [{"role": "user", "content": message}]
+        done = False
+        while not done:
+            response = self.openai.chat.completions.create(model="gemini-2.5-flash-preview-05-20", messages=messages, tools=tools)
+            if response.choices[0].finish_reason=="tool_calls":
+                message = response.choices[0].message
+                tool_calls = message.tool_calls
+                results = self.handle_tool_call(tool_calls)
+                messages.append(message)
+                messages.extend(results)
+            else:
+                done = True
+        return response.choices[0].message.content
+    
+
+if __name__ == "__main__":
+    me = Me()
+    gr.ChatInterface(me.chat, type="messages").launch()
+    

community_contributions/1_foundations_using_gemini/email_writeup.ipynb

@@ -0,0 +1,821 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Important point - please read</h2>\n",
+    "            <span style=\"color:#ff7800;\">The way I collaborate with you may be different to other courses you've taken. I prefer not to type code while you watch. Rather, I execute Jupyter Labs, like this, and give you an intuition for what's going on. My suggestion is that you carefully execute this yourself, <b>after</b> watching the lecture. Add print statements to understand what's going on, and then come up with your own variations.<br/><br/>If you have time, I'd love it if you submit a PR for changes in the community_contributions folder - instructions in the resources. Also, if you have a Github account, use this to showcase your variations. Not only is this essential practice, but it demonstrates your skills to others, including perhaps future clients or employers...\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OpenAI API Key not set\n",
+      "Anthropic API Key not set (and this is optional)\n",
+      "Google API Key exists and begins AI\n",
+      "DeepSeek API Key exists and begins sk-\n",
+      "Groq API Key exists and begins gsk_\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \" \"\n",
+    "\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"\"\"You are a professional communication expert.\n",
+    "\n",
+    "Your task is to write a clear, well-structured, and effective email based on the details below.\n",
+    "\n",
+    "OBJECTIVE:\n",
+    "[What is the purpose of this email?]\n",
+    "\n",
+    "RECIPIENT:\n",
+    "[Who is receiving this? Relationship? Seniority level?]\n",
+    "\n",
+    "CONTEXT:\n",
+    "[What happened before this email? Any background info?]\n",
+    "\n",
+    "TONE:\n",
+    "[Choose one: formal / semi-formal / casual / persuasive / apologetic / assertive / warm / direct]\n",
+    "\n",
+    "KEY POINTS TO INCLUDE:\n",
+    "- [Point 1]\n",
+    "- [Point 2]\n",
+    "- [Point 3]\n",
+    "\n",
+    "CONSTRAINTS:\n",
+    "- Keep it under [X] words\n",
+    "- Avoid overly dramatic language\n",
+    "- Be specific and concise\n",
+    "- Include a clear call to action\n",
+    "\n",
+    "OUTPUT FORMAT:\n",
+    "- Subject line\n",
+    "- Email body\n",
+    "- Professional sign-off\"\"\"\n",
+    "\n",
+    "request += \"Answer only with the question. No explanation.\"\n",
+    "\n",
+    "messages = [{'role':'user','content':request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[{'role': 'user',\n",
+       "  'content': 'You are a professional communication expert.\\n\\nYour task is to write a clear, well-structured, and effective email based on the details below.\\n\\nOBJECTIVE:\\n[What is the purpose of this email?]\\n\\nRECIPIENT:\\n[Who is receiving this? Relationship? Seniority level?]\\n\\nCONTEXT:\\n[What happened before this email? Any background info?]\\n\\nTONE:\\n[Choose one: formal / semi-formal / casual / persuasive / apologetic / assertive / warm / direct]\\n\\nKEY POINTS TO INCLUDE:\\n- [Point 1]\\n- [Point 2]\\n- [Point 3]\\n\\nCONSTRAINTS:\\n- Keep it under [X] words\\n- Avoid overly dramatic language\\n- Be specific and concise\\n- Include a clear call to action\\n\\nOUTPUT FORMAT:\\n- Subject line\\n- Email body\\n- Professional sign-offAnswer only with the question. No explanation.'}]"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "\n",
+    "messages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "contenders = []\n",
+    "answers = []"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "Subject: Follow-Up on Q3 Marketing Budget Proposal  \n",
+       "\n",
+       "Dear [Recipient's Name],  \n",
+       "\n",
+       "I hope this message finds you well. Following up on our conversation last week, I’m writing to provide the additional details you requested regarding the Q3 marketing budget proposal.  \n",
+       "\n",
+       "Key points to note:  \n",
+       "1. The proposed budget aligns with our projected campaign goals and includes a 10% increase in digital ad spend.  \n",
+       "2. We’ve identified potential cost savings in traditional media, which offsets the digital increase.  \n",
+       "3. All figures have been reviewed by the finance team for accuracy.  \n",
+       "\n",
+       "Please review the attached document at your earliest convenience. I’d appreciate your feedback or approval by Friday, [Date], so we can proceed on schedule.  \n",
+       "\n",
+       "Let me know if you have any questions.  \n",
+       "\n",
+       "Best regards,  \n",
+       "[Your Name]"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "model_name = \"deepseek\"\n",
+    "response = deepseek.chat.completions.create(\n",
+    "    model=\"deepseek-chat\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "answer = response.choices[0].message.content\n",
+    "display(Markdown(answer))\n",
+    "contenders.append(model_name)\n",
+    "answers.append(answer)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "What are the details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and word count CONSTRAINTS for the email?"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "gemini = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta\")\n",
+    "model_name = \"gemini-2.5-flash\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(\n",
+    "    model=model_name,\n",
+    "    messages=messages,\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "display(Markdown(answer))\n",
+    "contenders.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "Could you please provide the specific details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and any CONSTRAINTS (e.g., word limit) so I can draft the email?"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "groq = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "model_name = \"openai/gpt-oss-120b\"\n",
+    "\n",
+    "request = groq.chat.completions.create(\n",
+    "    model=model_name,\n",
+    "    messages=messages,\n",
+    ")\n",
+    "\n",
+    "answer = request.choices[0].message.content\n",
+    "display(Markdown(answer))\n",
+    "contenders.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Note - update since the videos\n",
+    "\n",
+    "I've updated the model names to use the latest models below, like GPT 5 and Claude Sonnet 4.5. It's worth noting that these models can be quite slow - like 1-2 minutes - but they do a great job! Feel free to switch them for faster models if you'd prefer, like the ones I use in the video."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "# I've updated this with the latest model, but it can take some time because it likes to think!\n",
+    "# Replace the model with gpt-4.1-mini if you'd prefer not to wait 1-2 mins\n",
+    "\n",
+    "model_name = \"gpt-5-nano\"\n",
+    "\n",
+    "response = openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "model_name = \"claude-sonnet-4-5\"\n",
+    "\n",
+    "claude = Anthropic()\n",
+    "response = claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "answer = response.content[0].text\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gemini = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "model_name = \"gemini-2.5-flash\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "model_name = \"deepseek-chat\"\n",
+    "\n",
+    "response = deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Updated with the latest Open Source model from OpenAI\n",
+    "\n",
+    "groq = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "model_name = \"openai/gpt-oss-120b\"\n",
+    "\n",
+    "response = groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## For the next cell, we will use Ollama\n",
+    "\n",
+    "Ollama runs a local web service that gives an OpenAI compatible endpoint,  \n",
+    "and runs models locally using high performance C++ code.\n",
+    "\n",
+    "If you don't have Ollama, install it here by visiting https://ollama.com then pressing Download and following the instructions.\n",
+    "\n",
+    "After it's installed, you should be able to visit here: http://localhost:11434 and see the message \"Ollama is running\"\n",
+    "\n",
+    "You might need to restart Cursor (and maybe reboot). Then open a Terminal (control+\\`) and run `ollama serve`\n",
+    "\n",
+    "Useful Ollama commands (run these in the terminal, or with an exclamation mark in this notebook):\n",
+    "\n",
+    "`ollama pull <model_name>` downloads a model locally  \n",
+    "`ollama ls` lists all the models you've downloaded  \n",
+    "`ollama rm <model_name>` deletes the specified model from your downloads"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Super important - ignore me at your peril!</h2>\n",
+    "            <span style=\"color:#ff7800;\">The model called <b>llama3.3</b> is FAR too large for home computers - it's not intended for personal computing and will consume all your resources! Stick with the nicely sized <b>llama3.2</b> or <b>llama3.2:1b</b> and if you want larger, try llama3.1 or smaller variants of Qwen, Gemma, Phi or DeepSeek. See the <A href=\"https://ollama.com/models\">the Ollama models page</a> for a full list of models and sizes.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ollama = OpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "model_name = \"llama3.2\"\n",
+    "\n",
+    "response = ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "['deepseek', 'gemini-2.5-flash', 'openai/gpt-oss-120b']\n",
+      "[\"Subject: Follow-Up on Q3 Marketing Budget Proposal  \\n\\nDear [Recipient's Name],  \\n\\nI hope this message finds you well. Following up on our conversation last week, I’m writing to provide the additional details you requested regarding the Q3 marketing budget proposal.  \\n\\nKey points to note:  \\n1. The proposed budget aligns with our projected campaign goals and includes a 10% increase in digital ad spend.  \\n2. We’ve identified potential cost savings in traditional media, which offsets the digital increase.  \\n3. All figures have been reviewed by the finance team for accuracy.  \\n\\nPlease review the attached document at your earliest convenience. I’d appreciate your feedback or approval by Friday, [Date], so we can proceed on schedule.  \\n\\nLet me know if you have any questions.  \\n\\nBest regards,  \\n[Your Name]\", 'What are the details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and word count CONSTRAINTS for the email?', 'Could you please provide the specific details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and any CONSTRAINTS (e.g., word limit) so I can draft the email?']\n"
+     ]
+    }
+   ],
+   "source": [
+    "# So where are we?\n",
+    "\n",
+    "print(contenders)\n",
+    "print(answers)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Competitor: deepseek\n",
+      "\n",
+      "Subject: Follow-Up on Q3 Marketing Budget Proposal  \n",
+      "\n",
+      "Dear [Recipient's Name],  \n",
+      "\n",
+      "I hope this message finds you well. Following up on our conversation last week, I’m writing to provide the additional details you requested regarding the Q3 marketing budget proposal.  \n",
+      "\n",
+      "Key points to note:  \n",
+      "1. The proposed budget aligns with our projected campaign goals and includes a 10% increase in digital ad spend.  \n",
+      "2. We’ve identified potential cost savings in traditional media, which offsets the digital increase.  \n",
+      "3. All figures have been reviewed by the finance team for accuracy.  \n",
+      "\n",
+      "Please review the attached document at your earliest convenience. I’d appreciate your feedback or approval by Friday, [Date], so we can proceed on schedule.  \n",
+      "\n",
+      "Let me know if you have any questions.  \n",
+      "\n",
+      "Best regards,  \n",
+      "[Your Name]\n",
+      "Competitor: gemini-2.5-flash\n",
+      "\n",
+      "What are the details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and word count CONSTRAINTS for the email?\n",
+      "Competitor: openai/gpt-oss-120b\n",
+      "\n",
+      "Could you please provide the specific details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and any CONSTRAINTS (e.g., word limit) so I can draft the email?\n"
+     ]
+    }
+   ],
+   "source": [
+    "# It's nice to know how to use \"zip\"\n",
+    "for competitor, answer in zip(contenders, answers):\n",
+    "    print(f\"Competitor: {competitor}\\n\\n{answer}\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's bring this together - note the use of \"enumerate\"\n",
+    "\n",
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Response from competitor 1\n",
+      "\n",
+      "Subject: Follow-Up on Q3 Marketing Budget Proposal  \n",
+      "\n",
+      "Dear [Recipient's Name],  \n",
+      "\n",
+      "I hope this message finds you well. Following up on our conversation last week, I’m writing to provide the additional details you requested regarding the Q3 marketing budget proposal.  \n",
+      "\n",
+      "Key points to note:  \n",
+      "1. The proposed budget aligns with our projected campaign goals and includes a 10% increase in digital ad spend.  \n",
+      "2. We’ve identified potential cost savings in traditional media, which offsets the digital increase.  \n",
+      "3. All figures have been reviewed by the finance team for accuracy.  \n",
+      "\n",
+      "Please review the attached document at your earliest convenience. I’d appreciate your feedback or approval by Friday, [Date], so we can proceed on schedule.  \n",
+      "\n",
+      "Let me know if you have any questions.  \n",
+      "\n",
+      "Best regards,  \n",
+      "[Your Name]\n",
+      "\n",
+      "# Response from competitor 2\n",
+      "\n",
+      "What are the details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and word count CONSTRAINTS for the email?\n",
+      "\n",
+      "# Response from competitor 3\n",
+      "\n",
+      "Could you please provide the specific details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and any CONSTRAINTS (e.g., word limit) so I can draft the email?\n",
+      "\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(contenders)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{request}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "You are judging a competition between 3 competitors.\n",
+      "Each model has been given this question:\n",
+      "\n",
+      "ChatCompletion(id='chatcmpl-e9071a1e-2f11-4f29-affe-2dd81c808078', choices=[Choice(finish_reason='stop', index=0, logprobs=None, message=ChatCompletionMessage(content='Could you please provide the specific details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and any CONSTRAINTS (e.g., word limit) so I can draft the email?', refusal=None, role='assistant', annotations=None, audio=None, function_call=None, tool_calls=None, reasoning='The user wants: \"Answer only with the question. No explanation.\" They gave a template, but they didn\\'t fill in the placeholders. The instruction says: \"Answer only with the question. No explanation.\"\\n\\nProbably they want the assistant to ask them for the missing information (the placeholders). The user says: \"Your task is to write a clear, well-structured, and effective email based on the details below.\" Then they list placeholders like OBJECTIVE, RECIPIENT, etc. They haven\\'t filled them. So we need to ask the question to get those details. The instruction at the end: \"Answer only with the question. No explanation.\"\\n\\nThus we should reply with a single question asking them to provide the missing details. Probably: \"Could you please provide the specific details for OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, CONSTRAINTS?\" But must be a question. So something like: \"Could you fill in the placeholders (OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, CONSTRAINTS) so I can draft the email?\" That\\'s a question. No extra explanation.\\n\\nThus final answer: a single question.'))], created=1772217855, model='openai/gpt-oss-120b', object='chat.completion', service_tier='on_demand', system_fingerprint='fp_e10890e4b9', usage=CompletionUsage(completion_tokens=295, prompt_tokens=252, total_tokens=547, completion_tokens_details=CompletionTokensDetails(accepted_prediction_tokens=None, audio_tokens=None, reasoning_tokens=241, rejected_prediction_tokens=None), prompt_tokens_details=None, queue_time=0.044959717, prompt_time=0.011474953, completion_time=0.62083969, total_time=0.632314643), usage_breakdown=None, x_groq={'id': 'req_01kjg6mtjtfkxt2a74s7gwatpf', 'seed': 913780012})\n",
+      "\n",
+      "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+      "Respond with JSON, and only JSON, with the following format:\n",
+      "{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}\n",
+      "\n",
+      "Here are the responses from each competitor:\n",
+      "\n",
+      "# Response from competitor 1\n",
+      "\n",
+      "Subject: Follow-Up on Q3 Marketing Budget Proposal  \n",
+      "\n",
+      "Dear [Recipient's Name],  \n",
+      "\n",
+      "I hope this message finds you well. Following up on our conversation last week, I’m writing to provide the additional details you requested regarding the Q3 marketing budget proposal.  \n",
+      "\n",
+      "Key points to note:  \n",
+      "1. The proposed budget aligns with our projected campaign goals and includes a 10% increase in digital ad spend.  \n",
+      "2. We’ve identified potential cost savings in traditional media, which offsets the digital increase.  \n",
+      "3. All figures have been reviewed by the finance team for accuracy.  \n",
+      "\n",
+      "Please review the attached document at your earliest convenience. I’d appreciate your feedback or approval by Friday, [Date], so we can proceed on schedule.  \n",
+      "\n",
+      "Let me know if you have any questions.  \n",
+      "\n",
+      "Best regards,  \n",
+      "[Your Name]\n",
+      "\n",
+      "# Response from competitor 2\n",
+      "\n",
+      "What are the details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and word count CONSTRAINTS for the email?\n",
+      "\n",
+      "# Response from competitor 3\n",
+      "\n",
+      "Could you please provide the specific details for the OBJECTIVE, RECIPIENT, CONTEXT, TONE, KEY POINTS, and any CONSTRAINTS (e.g., word limit) so I can draft the email?\n",
+      "\n",
+      "\n",
+      "\n",
+      "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 36,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{\"results\": [\"3\", \"2\", \"1\"]}\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Judgement time!\n",
+    "deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "\n",
+    "response = deepseek.chat.completions.create(\n",
+    "    model=\"deepseek-chat\",\n",
+    "    messages=judge_messages\n",
+    ")\n",
+    "\n",
+    "results = response.choices[0].message.content\n",
+    "print(results)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 51,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Rank 1: openai/gpt-oss-120b\n",
+      "Rank 2: gemini-2.5-flash\n",
+      "Rank 3: deepseek\n"
+     ]
+    }
+   ],
+   "source": [
+    "contenders = [\n",
+    "    \"deepseek\",\n",
+    "    \"gemini-2.5-flash\",\n",
+    "    \"openai/gpt-oss-120b\"\n",
+    "]\n",
+    "\n",
+    "results_dict = {\"results\": [\"3\", \"2\", \"1\"]}\n",
+    "\n",
+    "# Use int(result)-1 only if your list aligns with competitor numbers\n",
+    "for rank, comp_number in enumerate(results_dict[\"results\"], start=1):\n",
+    "    index = int(comp_number) - 1  # convert \"3\" → 2\n",
+    "    print(f\"Rank {rank}: {contenders[index]}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Which pattern(s) did this use? Try updating this to add another Agentic design pattern.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">These kinds of patterns - to send a task to multiple models, and evaluate results,\n",
+    "            are common where you need to improve the quality of your LLM response. This approach can be universally applied\n",
+    "            to business projects where accuracy is critical.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_foundations_using_gemini/me/summary.txt

@@ -0,0 +1,11 @@
+Hey, I’m Harsh Patidar — a Data Engineer at ZS who loves building data systems that actually work — scalable, reliable, and smart enough to keep learning.
+I’ve spent the past few years turning raw, unstructured data into powerful systems that fuel analytics, automation, and AI-driven decisions.
+
+At ZS, I work in the R&D division, where I design and deploy containerized APIs, optimize data pipelines, and integrate machine learning models into real-world workflows. My toolkit revolves around Python, SQL, FastAPI, Docker, Airflow, and AWS, and I enjoy the process of connecting every piece of data infrastructure into something clean, efficient, and production-ready.
+
+Before this, I was part of Accenture’s Data Engineering & Governance team, helping large enterprises strengthen data reliability, validation, and compliance frameworks — experience that taught me the importance of structure, traceability, and precision.
+I also spent time as a Teaching Assistant at Coding Ninjas, mentoring over 200 students in Data Structures and Algorithms — something that shaped both my fundamentals and my patience.
+
+Outside of work, I’m someone who finds joy in photography, exploring tech startups, and deep research in finance and AI. I like observing how technology, creativity, and design come together — whether in a great photograph or a cleanly designed data pipeline.
+
+At my core, I’m driven by curiosity and the excitement of building something meaningful from scratch. I believe great work is built quietly, through learning, experimentation, and the discipline to keep improving — whether that’s a data system, a product, or even myself.

community_contributions/1_foundations_using_gemini/requirements.txt

@@ -0,0 +1,6 @@
+requests
+python-dotenv
+gradio
+pypdf
+openai
+openai-agents

community_contributions/1_lab1_DA.ipynb

@@ -0,0 +1,396 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv  import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "from openai import OpenAI\n",
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "# And now we'll create an instance of the OpenAI class\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "\n",
+    "question1 = \"Please pick a business area that might be worth exploring for an Agentic AI opportunity.\"\n",
+    "messages1 = [{\"role\": \"user\", \"content\": question1}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "response1 = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages1\n",
+    ")\n",
+    "\n",
+    "question2 = \" Please present the pain-point in \"+response1.choices[0].message.content +\" industry - something challenging that might be ripe for an Agentic solution\"\n",
+    "messages2 = [{\"role\": \"user\", \"content\": question2}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "response2 = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages2\n",
+    ")\n",
+    "\n",
+    "question3 = \" Please presentpropose and Agentic AI solution for pain-point \"+response2.choices[0].message.content\n",
+    "messages3 = [{\"role\": \"user\", \"content\": question3}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "response3 = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages3\n",
+    ")\n",
+    "\n",
+    "Final_Answer = \" Please presentpropose and Agentic AI solution for pain-point \"+response2.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(Final_Answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_Hy.ipynb

@@ -0,0 +1,688 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OpenAI API Key exists and begins sk-proj-\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ChatCompletion(id='chatcmpl-C9oVaLh1gjzKH07zcVLaXQ4o4FDQ7', choices=[Choice(finish_reason='stop', index=0, logprobs=None, message=ChatCompletionMessage(content='2 + 2 equals 4.', refusal=None, role='assistant', annotations=[], audio=None, function_call=None, tool_calls=None))], created=1756455142, model='gpt-4.1-nano-2025-04-14', object='chat.completion', service_tier='default', system_fingerprint='fp_c4c155951e', usage=CompletionUsage(completion_tokens=8, prompt_tokens=14, total_tokens=22, completion_tokens_details=CompletionTokensDetails(accepted_prediction_tokens=0, audio_tokens=0, reasoning_tokens=0, rejected_prediction_tokens=0), prompt_tokens_details=PromptTokensDetails(audio_tokens=0, cached_tokens=0)))\n",
+      "2 + 2 equals 4.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "If three people can paint three walls in three hours, how many people are needed to paint 18 walls in six hours?\n"
+     ]
+    }
+   ],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Let's analyze the problem step-by-step:\n",
+      "\n",
+      "---\n",
+      "\n",
+      "**Given:**\n",
+      "\n",
+      "- 3 people can paint 3 walls in 3 hours.\n",
+      "\n",
+      "**Question:**\n",
+      "\n",
+      "- How many people are needed to paint 18 walls in 6 hours?\n",
+      "\n",
+      "---\n",
+      "\n",
+      "### Step 1: Find the rate of painting per person\n",
+      "\n",
+      "- Total walls painted: 3 walls\n",
+      "- Total people: 3 people\n",
+      "- Total time: 3 hours\n",
+      "\n",
+      "**Walls per person per hour:**\n",
+      "\n",
+      "First, find how many walls 3 people paint per hour:\n",
+      "\n",
+      "\\[\n",
+      "\\frac{3 \\text{ walls}}{3 \\text{ hours}} = 1 \\text{ wall per hour by 3 people}\n",
+      "\\]\n",
+      "\n",
+      "So, 3 people paint 1 wall per hour.\n",
+      "\n",
+      "Then, walls per person per hour:\n",
+      "\n",
+      "\\[\n",
+      "\\frac{1 \\text{ wall per hour}}{3 \\text{ people}} = \\frac{1}{3} \\text{ wall per person per hour}\n",
+      "\\]\n",
+      "\n",
+      "---\n",
+      "\n",
+      "### Step 2: Calculate total work needed\n",
+      "\n",
+      "You want to paint 18 walls in 6 hours.\n",
+      "\n",
+      "This means the rate of painting must be:\n",
+      "\n",
+      "\\[\n",
+      "\\frac{18 \\text{ walls}}{6 \\text{ hours}} = 3 \\text{ walls per hour}\n",
+      "\\]\n",
+      "\n",
+      "---\n",
+      "\n",
+      "### Step 3: Find how many people are needed for this rate\n",
+      "\n",
+      "Since each person paints \\(\\frac{1}{3}\\) wall per hour,\n",
+      "\n",
+      "\\[\n",
+      "\\text{Number of people} \\times \\frac{1}{3} = 3 \\text{ walls per hour}\n",
+      "\\]\n",
+      "\n",
+      "Multiply both sides by 3:\n",
+      "\n",
+      "\\[\n",
+      "\\text{Number of people} = 3 \\times 3 = 9\n",
+      "\\]\n",
+      "\n",
+      "---\n",
+      "\n",
+      "### **Answer:**\n",
+      "\n",
+      "\\[\n",
+      "\\boxed{9}\n",
+      "\\]\n",
+      "\n",
+      "You need **9 people** to paint 18 walls in 6 hours.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "Let's analyze the problem step-by-step:\n",
+       "\n",
+       "---\n",
+       "\n",
+       "**Given:**\n",
+       "\n",
+       "- 3 people can paint 3 walls in 3 hours.\n",
+       "\n",
+       "**Question:**\n",
+       "\n",
+       "- How many people are needed to paint 18 walls in 6 hours?\n",
+       "\n",
+       "---\n",
+       "\n",
+       "### Step 1: Find the rate of painting per person\n",
+       "\n",
+       "- Total walls painted: 3 walls\n",
+       "- Total people: 3 people\n",
+       "- Total time: 3 hours\n",
+       "\n",
+       "**Walls per person per hour:**\n",
+       "\n",
+       "First, find how many walls 3 people paint per hour:\n",
+       "\n",
+       "\\[\n",
+       "\\frac{3 \\text{ walls}}{3 \\text{ hours}} = 1 \\text{ wall per hour by 3 people}\n",
+       "\\]\n",
+       "\n",
+       "So, 3 people paint 1 wall per hour.\n",
+       "\n",
+       "Then, walls per person per hour:\n",
+       "\n",
+       "\\[\n",
+       "\\frac{1 \\text{ wall per hour}}{3 \\text{ people}} = \\frac{1}{3} \\text{ wall per person per hour}\n",
+       "\\]\n",
+       "\n",
+       "---\n",
+       "\n",
+       "### Step 2: Calculate total work needed\n",
+       "\n",
+       "You want to paint 18 walls in 6 hours.\n",
+       "\n",
+       "This means the rate of painting must be:\n",
+       "\n",
+       "\\[\n",
+       "\\frac{18 \\text{ walls}}{6 \\text{ hours}} = 3 \\text{ walls per hour}\n",
+       "\\]\n",
+       "\n",
+       "---\n",
+       "\n",
+       "### Step 3: Find how many people are needed for this rate\n",
+       "\n",
+       "Since each person paints \\(\\frac{1}{3}\\) wall per hour,\n",
+       "\n",
+       "\\[\n",
+       "\\text{Number of people} \\times \\frac{1}{3} = 3 \\text{ walls per hour}\n",
+       "\\]\n",
+       "\n",
+       "Multiply both sides by 3:\n",
+       "\n",
+       "\\[\n",
+       "\\text{Number of people} = 3 \\times 3 = 9\n",
+       "\\]\n",
+       "\n",
+       "---\n",
+       "\n",
+       "### **Answer:**\n",
+       "\n",
+       "\\[\n",
+       "\\boxed{9}\n",
+       "\\]\n",
+       "\n",
+       "You need **9 people** to paint 18 walls in 6 hours."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "Certainly! Building on your outlined pain-point and the high-level Agentic AI functionalities, here’s a detailed proposal for an **Agentic AI solution** designed to tackle fragmented patient data and enable real-time, holistic health management.\n",
+       "\n",
+       "---\n",
+       "\n",
+       "# Agentic AI Solution Proposal: **HealthSynth AI**\n",
+       "\n",
+       "### Overview  \n",
+       "**HealthSynth AI** is an autonomous health management agent that continuously synthesizes fragmented patient data from multiple sources to provide a real-time, unified, and actionable health profile for patients and their care teams. It acts as a 24/7 health assistant, proactive coordinator, and personalized medical advisor.\n",
+       "\n",
+       "---\n",
+       "\n",
+       "## Key Features & Capabilities\n",
+       "\n",
+       "### 1. **Autonomous Data Aggregation & Normalization**  \n",
+       "- Uses API integrations, secure data exchanges (FHIR, HL7 standards), and device SDKs to continuously fetch data from:  \n",
+       "  - EHR systems across different providers  \n",
+       "  - Wearable and home medical devices (heart rate, glucose monitors, BP cuffs)  \n",
+       "  - Pharmacy records and prescription databases  \n",
+       "  - Lab results portals  \n",
+       "  - Insurance claims and coverage data  \n",
+       "- Applies intelligent data cleaning, deduplication, and semantic normalization to unify heterogeneous data formats into a consistent patient health graph.\n",
+       "\n",
+       "### 2. **Real-Time Multimodal Health Analytics Engine**  \n",
+       "- Employs advanced ML and deep learning models to detect:  \n",
+       "  - Emerging risk patterns (e.g., early signs of infection, deterioration of chronic conditions)  \n",
+       "  - Anomalies (missed medications, unusual vital sign changes)  \n",
+       "  - Compliance gaps (lifestyle, medication adherence)  \n",
+       "- Continuously updates predictive health trajectories personalized to each patient’s condition and history.\n",
+       "\n",
+       "### 3. **Proactive Action & Recommendation System**  \n",
+       "- Generates context-aware, evidence-based alerts and recommendations such as:  \n",
+       "  - Medication reminders or dosage adjustments flagged in consultation with prescribing physicians  \n",
+       "  - Suggestions for scheduling lab tests or specialist visits timely before symptoms worsen  \n",
+       "  - Lifestyle coaching tips adapted using patient preferences and progress  \n",
+       "- Classes recommendations into urgency tiers (info, caution, immediate action) and routes notifications appropriately.\n",
+       "\n",
+       "### 4. **Automated Care Coordination & Workflow Integration**  \n",
+       "- Interacts programmatically with provider scheduling systems, telemedicine platforms, pharmacies, and insurance portals to:  \n",
+       "  - Automatically request appointment reschedules or referrals based on patient status  \n",
+       "  - Notify involved healthcare professionals about critical health events or lab results  \n",
+       "  - Facilitate prescription renewals or modifications with minimal human intervention  \n",
+       "- Maintains secure, auditable communication logs ensuring compliance (HIPAA, GDPR).\n",
+       "\n",
+       "### 5. **Patient-Centric Digital Health Companion**  \n",
+       "- Provides patients with an intuitive mobile/web app featuring:  \n",
+       "  - A dynamic health dashboard summarizing key metrics, risks, and recent activities in plain language  \n",
+       "  - Intelligent daily check-ins and symptom trackers powered by conversational AI  \n",
+       "  - Adaptive educational content tailored to health literacy levels and language preferences  \n",
+       "  - Privacy controls empowering patients to manage data sharing settings\n",
+       "\n",
+       "---\n",
+       "\n",
+       "## Technical Architecture (High-Level)\n",
+       "\n",
+       "- **Data Ingestion Layer:** Connectors for EHRs, wearables, pharmacies, labs  \n",
+       "- **Data Lake & Processing:** Cloud-native secure storage with HIPAA-compliant encryption  \n",
+       "- **Knowledge Graph:** Patient-centric semantic graph linking clinical concepts, timelines, interventions  \n",
+       "- **Analytics & ML Models:** Ensemble predictive models incorporating temporal health data, risk scoring, anomaly detection  \n",
+       "- **Agentic Orchestrator:** Rule-based and reinforcement learning-driven workflow engine enabling autonomous decision-making and stakeholder communications  \n",
+       "- **Frontend Interfaces:** Responsive patient app, provider portals, API access for system integration\n",
+       "\n",
+       "---\n",
+       "\n",
+       "## Potential Challenges & Mitigations\n",
+       "\n",
+       "| Challenge | Mitigation Strategy |\n",
+       "|-----------|---------------------|\n",
+       "| Data privacy & regulatory compliance | Built-in privacy-by-design, end-to-end encryption, rigorous consent management, audit trails |\n",
+       "| Data interoperability & standardization | Utilize open standards (FHIR, DICOM), NLP for unstructured data extraction |\n",
+       "| Model explainability | Implement interpretable ML techniques and transparent reasoning for clinicians |\n",
+       "| Patient engagement sustainability | Gamification, behavior science-driven personalized nudges |\n",
+       "| Integration complexity across healthcare IT systems | Modular adaptors/plugins, partnerships with major EHR vendors |\n",
+       "\n",
+       "---\n",
+       "\n",
+       "## Impact & Benefits\n",
+       "\n",
+       "- **For Patients:** Reduced health risks, increased empowerment, improved treatment adherence, and personal convenience  \n",
+       "- **For Providers:** Enhanced clinical decision support, reduced administrative burden, timely interventions  \n",
+       "- **For Payers:** Lowered costs via preventive care and reduced hospital readmissions\n",
+       "\n",
+       "---\n",
+       "\n",
+       "Would you like me to help you design detailed user journeys, develop specific ML model architectures, or draft an implementation roadmap for **HealthSynth AI**?"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"I want you to pick a business area that might be worth exploring for an Agentic AI opportunity.\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "\n",
+    "# print(business_idea)\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"Please propose a pain-point in the {business_idea} industry.\"}]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "pain_point = response.choices[0].message.content\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"Please propose an Agentic AI solution to the pain-point: {pain_point}.\"}]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "agentic_solution = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(agentic_solution))\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_Japyh.ipynb

@@ -0,0 +1,226 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "from dotenv import load_dotenv"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "# Ask it again\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "display(Markdown(answer))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \",Please propose a unique, creative business idea that has a high chance of success. Respond only with the business idea, no explanations.\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"Present a pain-point that customers of the following business idea might have: {business_idea}\"}]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "pain_point = response.choices[0].message.content\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"Propose a solution to the following pain-point: {pain_point}\"}]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "solution = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(f\"**Business idea:** {business_idea}\"))\n",
+    "display(Markdown(f\"**Pain point:** {pain_point}\"))\n",
+    "display(Markdown(f\"**Solution:** {solution}\"))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "agents",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_Mohan_M.ipynb

@@ -0,0 +1,367 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"Something here\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response =\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_Mudassar.ipynb

@@ -0,0 +1,260 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# First Agentic AI workflow with OPENAI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/muhammad-mudassar-a65645192/"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Import Libraries"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 59,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import re\n",
+    "from openai import OpenAI\n",
+    "from dotenv import load_dotenv\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai_api_key=os.getenv(\"OPENAI_API_KEY\")\n",
+    "if openai_api_key:\n",
+    "    print(f\"openai api key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the gui\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Workflow with OPENAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai=OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "message = [{'role':'user','content':\"what is 2+3?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = openai.chat.completions.create(model=\"gpt-4o-mini\",messages=message)\n",
+    "print(response.choices[0].message.content)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "message=[{'role':'user','content':question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response=openai.chat.completions.create(model=\"gpt-4o-mini\",messages=message)\n",
+    "question=response.choices[0].message.content\n",
+    "print(f\"Answer: {question}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 35,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "message=[{'role':'user','content':question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response=openai.chat.completions.create(model=\"gpt-4o-mini\",messages=message)\n",
+    "answer = response.choices[0].message.content\n",
+    "print(f\"Answer: {answer}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# convert \\[ ... \\] to $$ ... $$, to properly render Latex\n",
+    "converted_answer = re.sub(r'\\\\[\\[\\]]', '$$', answer)\n",
+    "display(Markdown(converted_answer))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Exercise"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "message = [{'role':'user','content':\"give me a business area related to ecommerce that might be worth exploring for a agentic opportunity.\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = openai.chat.completions.create(model=\"gpt-4o-mini\",messages=message)\n",
+    "business_area = response.choices[0].message.content\n",
+    "business_area"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "message = business_area + \"present a pain-point in that industry - something challenging that might be ripe for an agentic solutions.\"\n",
+    "message"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "message = [{'role': 'user', 'content': message}]\n",
+    "response = openai.chat.completions.create(model=\"gpt-4o-mini\",messages=message)\n",
+    "question=response.choices[0].message.content\n",
+    "question"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "message=[{'role':'user','content':question}]\n",
+    "response=openai.chat.completions.create(model=\"gpt-4o-mini\",messages=message)\n",
+    "answer=response.choices[0].message.content\n",
+    "print(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "display(Markdown(answer))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_Thanh.ipynb

@@ -0,0 +1,165 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from dotenv import load_dotenv\n",
+    "load_dotenv()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the keys\n",
+    "import google.generativeai as genai\n",
+    "import os\n",
+    "genai.configure(api_key=os.getenv('GOOGLE_API_KEY'))\n",
+    "model = genai.GenerativeModel(model_name=\"gemini-1.5-flash\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar Gemini GenAI format\n",
+    "\n",
+    "response = model.generate_content([\"2+2=?\"])\n",
+    "response.text"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "\n",
+    "response = model.generate_content([question])\n",
+    "print(response.text)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(response.text))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"Something here\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response =\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.\n",
+    "\n",
+    "# And repeat!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "llm_projects",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.15"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_chandra_chekuri.ipynb

@@ -0,0 +1,620 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OpenAI API Key exists and begins sk-proj-\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "2 + 2 equals 4.\n",
+      "assistant\n"
+     ]
+    }
+   ],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "If all Bloops are Razzies and all Razzies are Lazzies, are all Bloops definitely Lazzies? Explain your reasoning.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Yes, all Bloops are definitely Lazzies.\n",
+      "\n",
+      "**Reasoning:**\n",
+      "\n",
+      "1. The statement \"All Bloops are Razzies\" means every member of the set Bloops is also a member of the set Razzies.\n",
+      "2. The statement \"All Razzies are Lazzies\" means every member of the set Razzies is also a member of the set Lazzies.\n",
+      "\n",
+      "Since all Bloops are inside the Razzies group, and all Razzies are inside the Lazzies group, it follows that all Bloops must be inside the Lazzies group.\n",
+      "\n",
+      "In other words, the set of Bloops is a subset of Razzies, and Razzies is a subset of Lazzies. Therefore, Bloops is a subset of Lazzies.\n",
+      "\n",
+      "This is a classic example of the transitive property in logic and set theory:\n",
+      "- If A ⊆ B and B ⊆ C, then A ⊆ C.\n",
+      "\n",
+      "So, yes, all Bloops are definitely Lazzies.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "Yes, all Bloops are definitely Lazzies.\n",
+       "\n",
+       "**Reasoning:**\n",
+       "\n",
+       "1. The statement \"All Bloops are Razzies\" means every member of the set Bloops is also a member of the set Razzies.\n",
+       "2. The statement \"All Razzies are Lazzies\" means every member of the set Razzies is also a member of the set Lazzies.\n",
+       "\n",
+       "Since all Bloops are inside the Razzies group, and all Razzies are inside the Lazzies group, it follows that all Bloops must be inside the Lazzies group.\n",
+       "\n",
+       "In other words, the set of Bloops is a subset of Razzies, and Razzies is a subset of Lazzies. Therefore, Bloops is a subset of Lazzies.\n",
+       "\n",
+       "This is a classic example of the transitive property in logic and set theory:\n",
+       "- If A ⊆ B and B ⊆ C, then A ⊆ C.\n",
+       "\n",
+       "So, yes, all Bloops are definitely Lazzies."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "One promising business area to explore for an Agentic AI opportunity is **Supply Chain and Logistics Management**.\n",
+      "\n",
+      "### Why Supply Chain and Logistics?\n",
+      "\n",
+      "1. **Complex Decision-Making Environment:** Supply chains involve numerous variables including inventory levels, demand forecasting, transportation routes, supplier reliability, and geopolitical factors. An Agentic AI can autonomously analyze these variables in real-time and make optimized decisions.\n",
+      "\n",
+      "2. **High Impact on Efficiency and Cost:** Optimizing supply chain operations directly reduces costs, improves delivery times, and enhances customer satisfaction. Autonomous AI agents can dynamically reroute shipments, adjust inventory strategies, and renegotiate with suppliers in response to unexpected events.\n",
+      "\n",
+      "3. **Adaptability to Disruptions:** Agentic AI can proactively manage disruptions—e.g., natural disasters, port strikes, sudden demand spikes—by autonomously altering plans without human intervention, maintaining supply chain resilience.\n",
+      "\n",
+      "4. **Data-Rich Environment:** Supply chains generate massive amounts of data from IoT sensors, ERP systems, and market trends. An Agentic AI can continuously learn from this data to improve decision-making over time.\n",
+      "\n",
+      "5. **Scalability:** Agents can operate across multiple nodes of a global supply chain, coordinating activities and ensuring end-to-end optimization, a task challenging for traditional manual or semi-automated tools.\n",
+      "\n",
+      "### Example Use Cases\n",
+      "\n",
+      "- Autonomous inventory management agents that predict and reorder supplies.\n",
+      "- AI-driven transportation agents that plan and adjust delivery routes in real-time.\n",
+      "- Negotiation agents that interact with suppliers to secure better terms or resolve delays.\n",
+      "- Risk management agents that simulate scenarios and implement contingency plans proactively.\n",
+      "\n",
+      "### Potential ROI\n",
+      "\n",
+      "Improved efficiency and responsiveness can lead to significant cost reductions, better service levels, and competitive advantages in markets where speed and reliability are critical.\n",
+      "\n",
+      "---\n",
+      "\n",
+      "Would you like me to elaborate on potential technical approaches or business models for Agentic AI in this field?\n"
+     ]
+    }
+   ],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"pick a business area that might be worth exploring for an Agentic AI opportunity.\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "print(business_idea)\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Certainly! Let’s consider the **healthcare industry** as an example.\n",
+      "\n",
+      "**Pain-point:**  \n",
+      "Healthcare providers often struggle with **efficiently managing and coordinating patient care across multiple departments and specialists**, leading to delays, miscommunications, and fragmented patient experiences.\n",
+      "\n",
+      "**Why it’s challenging:**  \n",
+      "- Patient information is often siloed in different systems or departments.  \n",
+      "- Coordinating appointments, treatments, and follow-ups requires constant communication and scheduling adjustments.  \n",
+      "- Healthcare professionals face high workloads, making manual coordination prone to errors and delays.  \n",
+      "- Patients may receive redundant tests or conflicting advice due to lack of coordinated care.\n",
+      "\n",
+      "**Ripe for an Agentic solution:**  \n",
+      "An intelligent, autonomous agent could serve as a centralized care coordinator that:  \n",
+      "- Integrates data across hospital systems to create a unified patient profile.  \n",
+      "- Dynamically schedules and synchronizes appointments and treatments based on specialist availability and patient needs.  \n",
+      "- Sends proactive reminders and updates to both patients and providers.  \n",
+      "- Continuously learns and adapts to optimize care pathways and reduce bottlenecks.\n",
+      "\n",
+      "Such an agentic system could profoundly improve efficiency, reduce errors, and enhance patient outcomes by automating complex coordination tasks and enabling more seamless communication among all stakeholders.\n"
+     ]
+    }
+   ],
+   "source": [
+    "pick_pain_point = [{\"role\":\"user\",\"content\" : \"present a pain-point in that industry - something challenging that might be ripe for an Agentic solution\"}]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=pick_pain_point\n",
+    ")\n",
+    "\n",
+    "pain_point = response.choices[0].message.content\n",
+    "print(pain_point)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\"Agentic AI\" refers to artificial intelligence systems that operate with a degree of autonomy and goal-directed behavior, often capable of making decisions, planning, and interacting with environments in a manner similar to an agent. When proposing an Agentic AI solution, it’s important to outline the system's objectives, capabilities, architecture, and deployment context clearly.\n",
+      "\n",
+      "Here is a structured proposal for an Agentic AI solution:\n",
+      "\n",
+      "---\n",
+      "\n",
+      "### Proposal: Agentic AI Solution for Autonomous Task Management\n",
+      "\n",
+      "#### 1. **Objective**\n",
+      "\n",
+      "Develop an Agentic AI system capable of autonomously managing complex tasks in dynamic environments. The agent should be able to perceive its environment, make decisions, plan actions, learn from outcomes, and communicate effectively with human users.\n",
+      "\n",
+      "#### 2. **Use Case**\n",
+      "\n",
+      "- Autonomous workflow management in enterprise settings.\n",
+      "- Robotic process automation with adaptive decision-making.\n",
+      "- Intelligent virtual assistants that handle multi-step goals.\n",
+      "- Autonomous vehicles or robotic agents performing navigation and task execution.\n",
+      "\n",
+      "#### 3. **Core Capabilities**\n",
+      "\n",
+      "- **Perception:** Ability to gather and interpret data from multiple sources (sensors, databases, APIs).\n",
+      "- **Reasoning and Decision Making:** Use of symbolic reasoning, probabilistic models, or reinforcement learning to make goal-oriented decisions.\n",
+      "- **Planning:** Generate and optimize multi-step action plans to achieve high-level goals.\n",
+      "- **Learning:** Adapt strategies based on feedback using supervised, unsupervised, or reinforcement learning techniques.\n",
+      "- **Interaction:** Natural language processing and multimodal communication for engaging with users and other systems.\n",
+      "\n",
+      "#### 4. **Technical Architecture**\n",
+      "\n",
+      "- **Perception Layer:** Data ingestion modules with preprocessing, sensor fusion, and environment modeling.\n",
+      "- **Cognitive Layer:**\n",
+      "  - Knowledge base for domain-specific understanding.\n",
+      "  - Planning engine implementing algorithms such as A* search, Monte Carlo Tree Search, or heuristic planners.\n",
+      "  - Decision module leveraging AI models (e.g., deep reinforcement learning).\n",
+      "- **Learning Layer:** Continuous learning pipelines to update models and improve performance.\n",
+      "- **Interaction Layer:** NLP processors, dialog managers, and multimodal interfaces.\n",
+      "- **Execution Layer:** Actuation modules or API connectors to perform planned actions.\n",
+      "\n",
+      "#### 5. **Implementation Approach**\n",
+      "\n",
+      "- Utilize a modular software framework such as ROS (Robot Operating System) for robotics agents or a microservices architecture for software agents.\n",
+      "- Integrate AI models developed with frameworks like TensorFlow or PyTorch.\n",
+      "- Employ cloud infrastructure for scalability and real-time data processing.\n",
+      "- Emphasize safety, transparency, and explainability to maintain trust and compliance.\n",
+      "\n",
+      "#### 6. **Evaluation Metrics**\n",
+      "\n",
+      "- Task success rate.\n",
+      "- Efficiency in task completion time.\n",
+      "- Responsiveness and adaptability to changes.\n",
+      "- User satisfaction and usability feedback.\n",
+      "- Robustness to uncertainty and errors.\n",
+      "\n",
+      "#### 7. **Potential Challenges**\n",
+      "\n",
+      "- Ensuring reliable perception in noisy environments.\n",
+      "- Balancing autonomy with human oversight.\n",
+      "- Handling ethical and privacy concerns.\n",
+      "- Maintaining system robustness and avoiding unintended behavior.\n",
+      "\n",
+      "#### 8. **Conclusion**\n",
+      "\n",
+      "This Agentic AI solution can significantly enhance automation by providing intelligent, autonomous agents capable of managing complex, dynamic tasks effectively. It holds promise across various industries, from manufacturing and logistics to customer service and autonomous vehicles.\n",
+      "\n",
+      "---\n",
+      "\n",
+      "If you have a specific domain or problem in mind, I can tailor the proposal accordingly. Would you like me to do that?\n"
+     ]
+    }
+   ],
+   "source": [
+    "propose=[{\"role\":\"user\",\"content\" : \"propose the Agentic AI solution\"}]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=propose\n",
+    ")\n",
+    "\n",
+    "solution = response.choices[0].message.content\n",
+    "print(solution)\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_cm.ipynb

@@ -0,0 +1,305 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Treat these labs as a resource</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates to the code regularly. When people ask questions or have problems, I incorporate it in the code, adding more examples or improved commentary. As a result, you'll notice that the code below isn't identical to the videos. Everything from the videos is here; but in addition, I've added more steps and better explanations. Consider this like an interactive book that accompanies the lectures.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Run `uv add google-genai` to install the Google Gemini library. (If you had started your environment before running this command, you will need to restart your environment in the Jupyter notebook.)\n",
+    "2. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "3. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "4. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. From the Cursor menu, choose Settings >> VSCode Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the keys\n",
+    "\n",
+    "import os\n",
+    "gemini_api_key = os.getenv('GEMINI_API_KEY')\n",
+    "\n",
+    "if gemini_api_key:\n",
+    "    print(f\"Gemini API Key exists and begins {gemini_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"Gemini API Key not set - please head to the troubleshooting guide in the guides folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting guide\n",
+    "\n",
+    "from google import genai"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the Gemini GenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder!\n",
+    "# If you get a NameError - head over to the guides folder to learn about NameErrors\n",
+    "\n",
+    "client = genai.Client(api_key=gemini_api_key)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar Gemini GenAI format\n",
+    "\n",
+    "messages = [\"What is 2+2?\"]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "\n",
+    "response = client.models.generate_content(\n",
+    "    model=\"gemini-2.0-flash\", contents=messages\n",
+    ")\n",
+    "\n",
+    "print(response.text)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "# Lets no create a challenging question\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "\n",
+    "# Ask the the model\n",
+    "response = client.models.generate_content(\n",
+    "    model=\"gemini-2.0-flash\", contents=question\n",
+    ")\n",
+    "\n",
+    "question = response.text\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask the models generated question to the model\n",
+    "response = client.models.generate_content(\n",
+    "    model=\"gemini-2.0-flash\", contents=question\n",
+    ")\n",
+    "\n",
+    "# Extract the answer from the response\n",
+    "answer = response.text\n",
+    "\n",
+    "# Debug log the answer\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "# Nicely format the answer using Markdown\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "\n",
+    "messages = [\"Something here\"]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response =\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.\n",
+    "\n",
+    "# And repeat!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_gemini.ipynb

@@ -0,0 +1,305 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Treat these labs as a resource</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates to the code regularly. When people ask questions or have problems, I incorporate it in the code, adding more examples or improved commentary. As a result, you'll notice that the code below isn't identical to the videos. Everything from the videos is here; but in addition, I've added more steps and better explanations. Consider this like an interactive book that accompanies the lectures.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Run `uv add google-genai` to install the Google Gemini library. (If you had started your environment before running this command, you will need to restart your environment in the Jupyter notebook.)\n",
+    "2. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "3. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "4. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. From the Cursor menu, choose Settings >> VSCode Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the keys\n",
+    "\n",
+    "import os\n",
+    "gemini_api_key = os.getenv('GEMINI_API_KEY')\n",
+    "\n",
+    "if gemini_api_key:\n",
+    "    print(f\"Gemini API Key exists and begins {gemini_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"Gemini API Key not set - please head to the troubleshooting guide in the guides folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting guide\n",
+    "\n",
+    "from google import genai"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the Gemini GenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder!\n",
+    "# If you get a NameError - head over to the guides folder to learn about NameErrors\n",
+    "\n",
+    "client = genai.Client(api_key=gemini_api_key)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar Gemini GenAI format\n",
+    "\n",
+    "messages = [\"What is 2+2?\"]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "\n",
+    "response = client.models.generate_content(\n",
+    "    model=\"gemini-2.0-flash\", contents=messages\n",
+    ")\n",
+    "\n",
+    "print(response.text)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "# Lets no create a challenging question\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "\n",
+    "# Ask the the model\n",
+    "response = client.models.generate_content(\n",
+    "    model=\"gemini-2.0-flash\", contents=question\n",
+    ")\n",
+    "\n",
+    "question = response.text\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask the models generated question to the model\n",
+    "response = client.models.generate_content(\n",
+    "    model=\"gemini-2.0-flash\", contents=question\n",
+    ")\n",
+    "\n",
+    "# Extract the answer from the response\n",
+    "answer = response.text\n",
+    "\n",
+    "# Debug log the answer\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "# Nicely format the answer using Markdown\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "\n",
+    "messages = [\"Something here\"]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response =\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.\n",
+    "\n",
+    "# And repeat!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_groq.ipynb

@@ -0,0 +1,262 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Implementing Notebook 1 using various LLMs via Groq"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from dotenv import load_dotenv"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI(\n",
+    "    base_url=\"https://api.groq.com/openai/v1\",\n",
+    "    api_key=groq_api_key\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# openai/gpt-oss-120b\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"openai/gpt-oss-120b\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# moonshotai/kimi-k2-instruct\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"moonshotai/kimi-k2-instruct\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask meta-llama/llama-guard-4-12b\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"llama-3.1-8b-instant\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(question))\n",
+    "display(Markdown(answer))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"Pick a business area that is worth exploring for a Gen-Z audience, that can be an agentic-ai opportunity. \\\n",
+    "             Somehwere where the concept of agentisation can be applied commerically. Respond only with the business idea.\"}]\n",
+    "\n",
+    "# Then make the first call: \n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model = \"qwen/qwen3-32b\",\n",
+    "    messages = messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "print(business_idea)\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message\n",
+    "\n",
+    "user_prompt_pain_point = f\"What is the pain point of the Gen-Z audience in the business area of {business_idea}?, that can be solved by an agentic-ai solution? Give a brief answer\"\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model = \"gemma2-9b-it\",\n",
+    "    messages = [{\"role\": \"user\", \"content\": user_prompt_pain_point}]\n",
+    ")\n",
+    "\n",
+    "pain_point = response.choices[0].message.content\n",
+    "print(pain_point)\n",
+    "\n",
+    "user_prompt_solution = f\"What is the solution to the pain point {pain_point} of the Gen-Z audience in the business area of {business_idea}?, that can be solved by an agentic-ai solution? Provide a step-by-step breakdown\"\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model = \"deepseek-r1-distill-llama-70b\",\n",
+    "    messages = [{\"role\": \"user\", \"content\": user_prompt_solution}]\n",
+    ")\n",
+    "\n",
+    "business_solution = response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "display(Markdown(business_solution))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.2"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_groq_llama.ipynb

@@ -0,0 +1,296 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# First Agentic AI workflow with Groq and Llama-3.3 LLM(Free of cost) "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import\n",
+    "from dotenv import load_dotenv"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the Groq API key\n",
+    "\n",
+    "import os\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"GROQ API Key exists and begins {groq_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"GROQ API Key not set\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting guide\n",
+    "\n",
+    "from groq import Groq"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a Groq instance\n",
+    "groq = Groq()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar Groq format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it!\n",
+    "\n",
+    "response = groq.chat.completions.create(model='llama-3.3-70b-versatile', messages=messages)\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it\n",
+    "response = groq.chat.completions.create(\n",
+    "    model=\"llama-3.3-70b-versatile\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = groq.chat.completions.create(\n",
+    "    model=\"llama-3.3-70b-versatile\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"Give me a business area that might be ripe for an Agentic AI solution.\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = groq.chat.completions.create(model='llama-3.3-70b-versatile', messages=messages)\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "\n",
+    "\n",
+    "# And repeat!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "display(Markdown(business_idea))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Update the message with the business idea from previous step\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is the pain point in the business area of \" + business_idea + \"?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Make the second call\n",
+    "response = groq.chat.completions.create(model='llama-3.3-70b-versatile', messages=messages)\n",
+    "# Read the pain point\n",
+    "pain_point = response.choices[0].message.content\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "display(Markdown(pain_point))\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Make the third call\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is the Agentic AI solution for the pain point of \" + pain_point + \"?\"}]\n",
+    "response = groq.chat.completions.create(model='llama-3.3-70b-versatile', messages=messages)\n",
+    "# Read the agentic solution\n",
+    "agentic_solution = response.choices[0].message.content\n",
+    "display(Markdown(agentic_solution))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_marstipton_mac.ipynb

@@ -0,0 +1,411 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Step 1: Define the conversation\n",
+    "messages = [\n",
+    "    {\"role\": \"system\", \"content\": \"You are an expert in agentic AI business ideation.\"}\n",
+    "]\n",
+    "\n",
+    "# Step 2: Ask the first question\n",
+    "area_prompt = (\n",
+    "    \"Pick a business area within Singapore startups as of Q4 2025 \"\n",
+    "    \"that might be worth exploring for an Agentic AI opportunity. \"\n",
+    "    \"Explain in simple language (for a 15-year-old) and cite resources briefly.\"\n",
+    ")\n",
+    "messages.append({\"role\": \"user\", \"content\": area_prompt})\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "area = response.choices[0].message.content\n",
+    "display(Markdown(area))\n",
+    "\n",
+    "# Add model response to context\n",
+    "messages.append({\"role\": \"assistant\", \"content\": area})\n",
+    "\n",
+    "# Step 3: Ask for a pain point\n",
+    "painpoint_prompt = (\n",
+    "    \"Based on your previous response, pick a recurring pain point in that area \"\n",
+    "    \"that is ripe for an Agentic AI solution.\"\n",
+    ")\n",
+    "messages.append({\"role\": \"user\", \"content\": painpoint_prompt})\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "painpoint = response.choices[0].message.content\n",
+    "display(Markdown(painpoint))\n",
+    "\n",
+    "# Add model response to context\n",
+    "messages.append({\"role\": \"assistant\", \"content\": painpoint})\n",
+    "\n",
+    "# Step 4: Propose a business idea\n",
+    "business_idea_prompt = (\n",
+    "    \"Propose an Agentic AI solution addressing the pain point above. \"\n",
+    "    \"Solution should have low overhead, be secure, and offer 80% free functionality, \"\n",
+    "    \"with full access for SGD 0.99/month per user or SGD 15/org (max 30 users).\"\n",
+    ")\n",
+    "messages.append({\"role\": \"user\", \"content\": business_idea_prompt})\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "business_idea = response.choices[0].message.content\n",
+    "display(Markdown(business_idea))\n",
+    "\n",
+    "# Add to conversation (for future iterations)\n",
+    "#messages.append({\"role\": \"assistant\", \"content\": business_idea})"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_moneek.ipynb

@@ -0,0 +1,407 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "question = \"Pick a business area that may have agentic AI opportunities\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "print(business_idea)\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"user\", \"content\": question + \"\\n\\n\" + business_idea},\n",
+    "            {\"role\": \"assistant\", \"content\": \"What is the pain point in this industry?\" }]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "pain_point = response.choices[0].message.content\n",
+    "print(pain_point)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"user\", \"content\": question + \"\\n\\n\" + business_idea + \"\\n\\n\" + pain_point},   \n",
+    "            {\"role\": \"assistant\", \"content\": \"What is the Agentic AI solution?\"}]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "agentic_solution = response.choices[0].message.content\n",
+    "print(agentic_solution)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_nv-ex.ipynb

@@ -0,0 +1,418 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"Pick up a business area where Agentic AI can be applied. Provide only the business area name.\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "display(Markdown(business_idea))\n",
+    "\n",
+    "# And repeat! In the next message, include the business idea within the message\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"Provide one painpoint in the business ${business_idea} that can be solved by Agentic AI. Provide only the pain point, nothing else.\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "pain_point = response.choices[0].message.content\n",
+    "display(Markdown(pain_point))\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"Provide one solution that uses Agentic AI to solve the pain point ${pain_point}, in the business ${business_idea}. \\\n",
+    "    Provide details as bullet points in less than 100 words. Precede it with the Business Area and the pain point it is solving.\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "solution = response.choices[0].message.content\n",
+    "display(Markdown(solution))\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_open_router.ipynb

@@ -0,0 +1,323 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 76,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the keys\n",
+    "\n",
+    "import os\n",
+    "open_router_api_key = os.getenv('OPEN_ROUTER_API_KEY')\n",
+    "\n",
+    "if open_router_api_key:\n",
+    "    print(f\"Open router API Key exists and begins {open_router_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"Open router API Key not set - please head to the troubleshooting guide in the setup folder\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 79,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 80,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Initialize the client to point at OpenRouter instead of OpenAI\n",
+    "# You can use the exact same OpenAI Python package—just swap the base_url!\n",
+    "client = OpenAI(\n",
+    "    base_url=\"https://openrouter.ai/api/v1\",\n",
+    "    api_key=open_router_api_key\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 81,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "client = OpenAI(\n",
+    "    base_url=\"https://openrouter.ai/api/v1\",\n",
+    "    api_key=open_router_api_key\n",
+    ")\n",
+    "\n",
+    "resp = client.chat.completions.create(\n",
+    "    # Select a model from https://openrouter.ai/models and provide the model name here\n",
+    "    model=\"meta-llama/llama-3.3-8b-instruct:free\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "print(resp.choices[0].message.content)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 83,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = client.chat.completions.create(\n",
+    "    model=\"meta-llama/llama-3.3-8b-instruct:free\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 85,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = client.chat.completions.create(\n",
+    "    model=\"meta-llama/llama-3.3-8b-instruct:free\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "\n",
+    "messages = [\"Something here\"]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response =\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.\n",
+    "\n",
+    "# And repeat!"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.7"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab1_romanc.ipynb

@@ -0,0 +1,410 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Welcome to the start of your adventure in Agentic AI"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Are you ready for action??</h2>\n",
+    "            <span style=\"color:#ff7800;\">Have you completed all the setup steps in the <a href=\"../setup/\">setup</a> folder?<br/>\n",
+    "            Have you read the <a href=\"../README.md\">README</a>? Many common questions are answered here!<br/>\n",
+    "            Have you checked out the guides in the <a href=\"../guides/01_intro.ipynb\">guides</a> folder?<br/>\n",
+    "            Well in that case, you're ready!!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">This code is a live resource - keep an eye out for my updates</h2>\n",
+    "            <span style=\"color:#00bfff;\">I push updates regularly. As people ask questions or have problems, I add more examples and improve explanations. As a result, the code below might not be identical to the videos, as I've added more steps and better comments. Consider this like an interactive book that accompanies the lectures.<br/><br/>\n",
+    "            I try to send emails regularly with important updates related to the course. You can find this in the 'Announcements' section of Udemy in the left sidebar. You can also choose to receive my emails via your Notification Settings in Udemy. I'm respectful of your inbox and always try to add value with my emails!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### And please do remember to contact me if I can help\n",
+    "\n",
+    "And I love to connect: https://www.linkedin.com/in/eddonner/\n",
+    "\n",
+    "\n",
+    "### New to Notebooks like this one? Head over to the guides folder!\n",
+    "\n",
+    "Just to check you've already added the Python and Jupyter extensions to Cursor, if not already installed:\n",
+    "- Open extensions (View >> extensions)\n",
+    "- Search for python, and when the results show, click on the ms-python one, and Install it if not already installed\n",
+    "- Search for jupyter, and when the results show, click on the Microsoft one, and Install it if not already installed  \n",
+    "Then View >> Explorer to bring back the File Explorer.\n",
+    "\n",
+    "And then:\n",
+    "1. Click where it says \"Select Kernel\" near the top right, and select the option called `.venv (Python 3.12.9)` or similar, which should be the first choice or the most prominent choice. You may need to choose \"Python Environments\" first.\n",
+    "2. Click in each \"cell\" below, starting with the cell immediately below this text, and press Shift+Enter to run\n",
+    "3. Enjoy!\n",
+    "\n",
+    "After you click \"Select Kernel\", if there is no option like `.venv (Python 3.12.9)` then please do the following:  \n",
+    "1. On Mac: From the Cursor menu, choose Settings >> VS Code Settings (NOTE: be sure to select `VSCode Settings` not `Cursor Settings`);  \n",
+    "On Windows PC: From the File menu, choose Preferences >> VS Code Settings(NOTE: be sure to select `VSCode Settings` not `Cursor Settings`)  \n",
+    "2. In the Settings search bar, type \"venv\"  \n",
+    "3. In the field \"Path to folder with a list of Virtual Environments\" put the path to the project root, like C:\\Users\\username\\projects\\agents (on a Windows PC) or /Users/username/projects/agents (on Mac or Linux).  \n",
+    "And then try again.\n",
+    "\n",
+    "Having problems with missing Python versions in that list? Have you ever used Anaconda before? It might be interferring. Quit Cursor, bring up a new command line, and make sure that your Anaconda environment is deactivated:    \n",
+    "`conda deactivate`  \n",
+    "And if you still have any problems with conda and python versions, it's possible that you will need to run this too:  \n",
+    "`conda config --set auto_activate_base false`  \n",
+    "and then from within the Agents directory, you should be able to run `uv python list` and see the Python 3.12 version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First let's do an import. If you get an Import Error, double check that your Kernel is correct..\n",
+    "\n",
+    "from dotenv import load_dotenv\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Next it's time to load the API keys into environment variables\n",
+    "# If this returns false, see the next cell!\n",
+    "\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Wait, did that just output `False`??\n",
+    "\n",
+    "If so, the most common reason is that you didn't save your `.env` file after adding the key! Be sure to have saved.\n",
+    "\n",
+    "Also, make sure the `.env` file is named precisely `.env` and is in the project root directory (`agents`)\n",
+    "\n",
+    "By the way, your `.env` file should have a stop symbol next to it in Cursor on the left, and that's actually a good thing: that's Cursor saying to you, \"hey, I realize this is a file filled with secret information, and I'm not going to send it to an external AI to suggest changes, because your keys should not be shown to anyone else.\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Final reminders</h2>\n",
+    "            <span style=\"color:#ff7800;\">1. If you're not confident about Environment Variables or Web Endpoints / APIs, please read Topics 3 and 5 in this <a href=\"../guides/04_technical_foundations.ipynb\">technical foundations guide</a>.<br/>\n",
+    "            2. If you want to use AIs other than OpenAI, like Gemini, DeepSeek or Ollama (free), please see the first section in this <a href=\"../guides/09_ai_apis_and_ollama.ipynb\">AI APIs guide</a>.<br/>\n",
+    "            3. If you ever get a Name Error in Python, you can always fix it immediately; see the last section of this <a href=\"../guides/06_python_foundations.ipynb\">Python Foundations guide</a> and follow both tutorials and exercises.<br/>\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check the key - if you're not using OpenAI, check whichever key you're using! Ollama doesn't need a key.\n",
+    "\n",
+    "import os\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set - please head to the troubleshooting guide in the setup folder\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - the all important import statement\n",
+    "# If you get an import error - head over to troubleshooting in the Setup folder\n",
+    "# Even for other LLM providers like Gemini, you still use this OpenAI import - see Guide 9 for why\n",
+    "\n",
+    "from openai import OpenAI"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now we'll create an instance of the OpenAI class\n",
+    "# If you're not sure what it means to create an instance of a class - head over to the guides folder (guide 6)!\n",
+    "# If you get a NameError - head over to the guides folder (guide 6)to learn about NameErrors - always instantly fixable\n",
+    "# If you're not using OpenAI, you just need to slightly modify this - precise instructions are in the AI APIs guide (guide 9)\n",
+    "\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a list of messages in the familiar OpenAI format\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What is 2+2?\"}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now call it! Any problems, head to the troubleshooting guide\n",
+    "# This uses GPT 4.1 nano, the incredibly cheap model\n",
+    "# The APIs guide (guide 9) has exact instructions for using even cheaper or free alternatives to OpenAI\n",
+    "# If you get a NameError, head to the guides folder (guide 6) to learn about NameErrors - always instantly fixable\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-nano\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "print(response.choices[0].message.content)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# And now - let's ask for a question:\n",
+    "\n",
+    "question = \"Please propose a hard, challenging question to assess someone's IQ. Respond only with the question.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ask it - this uses GPT 4.1 mini, still cheap but more powerful than nano\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask it again\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "answer = response.choices[0].message.content\n",
+    "print(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Congratulations!\n",
+    "\n",
+    "That was a small, simple step in the direction of Agentic AI, with your new environment!\n",
+    "\n",
+    "Next time things get more interesting..."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Now try this commercial application:<br/>\n",
+    "            First ask the LLM to pick a business area that might be worth exploring for an Agentic AI opportunity.<br/>\n",
+    "            Then ask the LLM to present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.<br/>\n",
+    "            Finally have 3 third LLM call propose the Agentic AI solution. <br/>\n",
+    "            We will cover this at up-coming labs, so don't worry if you're unsure.. just give it a try!\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question1 = \"Pick a business area that might be worth exploring for an Agentic AI opportunity\"\n",
+    "message1 = [{\"role\":\"user\", \"content\":f\"{question1}\"}]\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=message1\n",
+    "    )\n",
+    "\n",
+    "# Then read the business area:\n",
+    "\n",
+    "business_area = response.choices[0].message.content\n",
+    "\n",
+    "print(business_area)\n",
+    "# And repeat! In the next message, include the business area within the message"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question2 = f\"\"\"Based on text delimited by triple backticks present a pain-point in that industry - something challenging that might be ripe for an Agentic solution.\n",
+    "'''{business_area}'''\"\"\"\n",
+    "message2 = [{\"role\":\"user\", \"content\":f\"{question2}\"}]\n",
+    "\n",
+    "response2 = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=message2\n",
+    "    )\n",
+    "\n",
+    "painpoint = response2.choices[0].message.content\n",
+    "\n",
+    "print(painpoint)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question3 = f\"\"\"Propose an Agentic AI solution for the pain-point delimited by triple backticks.\n",
+    "'''{painpoint}'''\"\"\"\n",
+    "message3 = [{\"role\":\"user\", \"content\":f\"{question3}\"}]\n",
+    "\n",
+    "response3 = openai.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=message3\n",
+    "    )\n",
+    "\n",
+    "solution = response3.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(solution))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.13"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab2_Kaushik_Parallelization.ipynb

@@ -0,0 +1,355 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from IPython.display import Markdown"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Refresh dot env"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "open_api_key = os.getenv(\"OPENAI_API_KEY\")\n",
+    "google_api_key = os.getenv(\"GOOGLE_API_KEY\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Create initial query to get challange reccomendation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "query = 'Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. '\n",
+    "query += 'Answer only with the question, no explanation.'\n",
+    "\n",
+    "messages = [{'role':'user', 'content':query}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(messages)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Call openai gpt-4o-mini "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    messages=messages,\n",
+    "    model='gpt-4o-mini'\n",
+    ")\n",
+    "\n",
+    "challange = response.choices[0].message.content\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(challange)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Create messages with the challange query"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{'role':'user', 'content':challange}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(messages)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from threading import Thread"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def gpt_mini_processor():\n",
+    "    modleName = 'gpt-4o-mini'\n",
+    "    competitors.append(modleName)\n",
+    "    response_gpt = openai.chat.completions.create(\n",
+    "        messages=messages,\n",
+    "        model=modleName\n",
+    "    )\n",
+    "    answers.append(response_gpt.choices[0].message.content)\n",
+    "\n",
+    "def gemini_processor():\n",
+    "    gemini = OpenAI(api_key=google_api_key, base_url='https://generativelanguage.googleapis.com/v1beta/openai/')\n",
+    "    modleName = 'gemini-2.0-flash'\n",
+    "    competitors.append(modleName)\n",
+    "    response_gemini = gemini.chat.completions.create(\n",
+    "        messages=messages,\n",
+    "        model=modleName\n",
+    "    )\n",
+    "    answers.append(response_gemini.choices[0].message.content)\n",
+    "\n",
+    "def llama_processor():\n",
+    "    ollama = OpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "    modleName = 'llama3.2'\n",
+    "    competitors.append(modleName)\n",
+    "    response_llama = ollama.chat.completions.create(\n",
+    "        messages=messages,\n",
+    "        model=modleName\n",
+    "    )\n",
+    "    answers.append(response_llama.choices[0].message.content)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Paraller execution of LLM calls"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "thread1 = Thread(target=gpt_mini_processor)\n",
+    "thread2 = Thread(target=gemini_processor)\n",
+    "thread3 = Thread(target=llama_processor)\n",
+    "\n",
+    "thread1.start()\n",
+    "thread2.start()\n",
+    "thread3.start()\n",
+    "\n",
+    "thread1.join()\n",
+    "thread2.join()\n",
+    "thread3.join()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(competitors)\n",
+    "print(answers)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "for competitor, answer in zip(competitors, answers):\n",
+    "    print(f'Competitor:{competitor}\\n\\n{answer}')"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "together = ''\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f'# Response from competitor {index + 1}\\n\\n'\n",
+    "    together += answer + '\\n\\n'"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Prompt to judge the LLM results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "to_judge = f'''You are judging a competition between {len(competitors)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{challange}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\"\"\"\n",
+    "\n",
+    "'''"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "to_judge_message = [{'role':'user', 'content':to_judge}]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Execute o3-mini to analyze the LLM results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    messages=to_judge_message,\n",
+    "    model='o3-mini'\n",
+    ")\n",
+    "result = response.choices[0].message.content\n",
+    "print(result)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "results_dict = json.loads(result)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "for index, result in enumerate(ranks):\n",
+    "    competitor = competitors[int(result)-1]\n",
+    "    print(f\"Rank {index+1}: {competitor}\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab2_Routing_Workflow.ipynb

@@ -0,0 +1,514 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Judging and Routing — Optimizing Resource Usage by Evaluating Problem Complexity"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In the original Lab 2, we explored the **Orchestrator–Worker pattern**, where a planner sent the same question to multiple agents, and a judge assessed their responses to evaluate agent intelligence.\n",
+    "\n",
+    "In this notebook, we extend that design by adding multiple judges and a routing component to optimize model usage based on task complexity. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Imports and Environment Setup"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "if openai_api_key and google_api_key and deepseek_api_key:\n",
+    "    print(\"All keys were loaded successfully\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2\n",
+    "!ollama pull mistral"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Creating Models"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The notebook uses instances of GPT, Gemini and DeepSeek APIs, along with two local models served via Ollama: ```llama3.2```  and ```mistral```."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "model_specs = {\n",
+    "    \"gpt-4o-mini\" : None,\n",
+    "    \"gemini-2.0-flash\": {\n",
+    "        \"api_key\" : google_api_key,\n",
+    "        \"url\" : \"https://generativelanguage.googleapis.com/v1beta/openai/\"\n",
+    "    },\n",
+    "    \"deepseek-chat\" : {\n",
+    "        \"api_key\" : deepseek_api_key,\n",
+    "        \"url\" : \"https://api.deepseek.com/v1\"\n",
+    "    },\n",
+    "    \"llama3.2\" : {\n",
+    "        \"api_key\" : \"ollama\",\n",
+    "        \"url\" : \"http://localhost:11434/v1\"\n",
+    "    },\n",
+    "    \"mistral\" : {\n",
+    "        \"api_key\" : \"ollama\",\n",
+    "        \"url\" : \"http://localhost:11434/v1\"\n",
+    "    }\n",
+    "}\n",
+    "\n",
+    "def create_model(model_name):\n",
+    "    spec = model_specs[model_name]\n",
+    "    if spec is None:\n",
+    "        return OpenAI()\n",
+    "    \n",
+    "    return OpenAI(api_key=spec[\"api_key\"], base_url=spec[\"url\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "orchestrator_model = \"gemini-2.0-flash\"\n",
+    "generator = create_model(orchestrator_model)\n",
+    "router = create_model(orchestrator_model)\n",
+    "\n",
+    "qa_models = {\n",
+    "    model_name : create_model(model_name) \n",
+    "    for model_name in model_specs.keys()\n",
+    "}\n",
+    "\n",
+    "judges = {\n",
+    "    model_name : create_model(model_name) \n",
+    "    for model_name, specs in model_specs.items() \n",
+    "    if not(specs) or specs[\"api_key\"] != \"ollama\"\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Orchestrator-Worker Workflow"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "First, we generate a question to evaluate the intelligence of each LLM."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs \"\n",
+    "request += \"to evaluate and rank them based on their intelligence. \" \n",
+    "request += \"Answer **only** with the question, no explanation or preamble.\"\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]\n",
+    "messages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "response = generator.chat.completions.create(\n",
+    "    model=orchestrator_model,\n",
+    "    messages=messages,\n",
+    ")\n",
+    "eval_question = response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "display(Markdown(eval_question))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Task Parallelization"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now, having the question and all the models instantiated it's time to see what each model has to say about the complex task it was given."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question = [{\"role\": \"user\", \"content\": eval_question}]\n",
+    "answers = []\n",
+    "competitors = []\n",
+    "\n",
+    "for name, model in qa_models.items():\n",
+    "    response = model.chat.completions.create(model=name, messages=question)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    competitors.append(name)\n",
+    "    answers.append(answer)\n",
+    "\n",
+    "answers"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "report = \"# Answer report for each of the 5 models\\n\\n\"\n",
+    "report += \"\\n\\n\".join([f\"## **Model: {model}**\\n\\n{answer}\" for model, answer in zip(competitors, answers)])\n",
+    "display(Markdown(report))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Synthetizer/Judge"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The Judge Agents ranks the LLM responses based on coherence and relevance to the evaluation prompt. Judges vote and the final LLM ranking is based on the aggregated ranking of all three judges."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\"\n",
+    "\n",
+    "together"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_prompt = f\"\"\"\n",
+    "                You are judging a competition between {len(competitors)} LLM competitors.\n",
+    "                Each model has been given this nuanced question to evaluate their intelligence:\n",
+    "\n",
+    "                {eval_question}\n",
+    "\n",
+    "                Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "                Respond with JSON, and only JSON, with the following format:\n",
+    "                {{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "                With 'best competitor number being ONLY the number', for instance:\n",
+    "                {{\"results\": [\"5\", \"2\", \"4\", ...]}}\n",
+    "                Here are the responses from each competitor:\n",
+    "\n",
+    "                {together}\n",
+    "\n",
+    "                Now respond with the JSON with the ranked order of the competitors, nothing else. Do NOT include MARKDOWN FORMATTING or CODE BLOCKS. ONLY the JSON\n",
+    "                \"\"\"\n",
+    "\n",
+    "judge_messages = [{\"role\": \"user\", \"content\": judge_prompt}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from collections import defaultdict\n",
+    "import re\n",
+    "\n",
+    "N = len(competitors)\n",
+    "scores = defaultdict(int)\n",
+    "for judge_name, judge in judges.items():\n",
+    "    response = judge.chat.completions.create(\n",
+    "        model=judge_name,\n",
+    "        messages=judge_messages,\n",
+    "    )\n",
+    "    response = response.choices[0].message.content\n",
+    "    response_json = re.findall(r'\\{.*?\\}', response)[0]\n",
+    "    results = json.loads(response_json)[\"results\"]\n",
+    "    ranks = [int(result) for result in results]\n",
+    "    print(f\"Judge {judge_name} ranking:\")\n",
+    "    for i, c in enumerate(ranks):\n",
+    "        model_name = competitors[c - 1]\n",
+    "        print(f\"#{i+1} : {model_name}\")\n",
+    "        scores[c - 1] += (N - i)\n",
+    "    print()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "sorted_indices = sorted(scores, key=scores.get)\n",
+    "\n",
+    "# Convert to model names\n",
+    "ranked_model_names = [competitors[i] for i in sorted_indices]\n",
+    "\n",
+    "print(\"Final ranking from best to worst:\")\n",
+    "for i, name in enumerate(ranked_model_names[::-1], 1):\n",
+    "    print(f\"#{i}: {name}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Routing Workflow"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We now define a routing agent responsible for classifying task complexity and delegating the prompt to the most appropriate model."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def classify_question_complexity(question: str, routing_agent, routing_model) -> int:\n",
+    "    \"\"\"\n",
+    "    Ask an LLM to classify the question complexity from 1 (easy) to 5 (very hard).\n",
+    "    \"\"\"\n",
+    "    prompt = f\"\"\"\n",
+    "        You are a classifier responsible for assigning a complexity level to user questions, based on how difficult they would be for a language model to answer.\n",
+    "\n",
+    "        Please read the question below and assign a complexity score from 1 to 5:\n",
+    "\n",
+    "        - Level 1: Very simple factual or definitional question (e.g., “What is the capital of France?”)\n",
+    "        - Level 2: Slightly more involved, requiring basic reasoning or comparison\n",
+    "        - Level 3: Moderate complexity, requiring synthesis, context understanding, or multi-part answers\n",
+    "        - Level 4: High complexity, requiring abstract thinking, ethical judgment, or creative generation\n",
+    "        - Level 5: Extremely challenging, requiring deep reasoning, philosophical reflection, or long-term multi-step inference\n",
+    "\n",
+    "        Respond ONLY with a single integer between 1 and 5 that best reflects the complexity of the question.\n",
+    "\n",
+    "        Question:\n",
+    "        {question}\n",
+    "        \"\"\"\n",
+    "\n",
+    "    response = routing_agent.chat.completions.create(\n",
+    "        model=routing_model,\n",
+    "        messages=[{\"role\": \"user\", \"content\": prompt}]\n",
+    "    )\n",
+    "    try:\n",
+    "        return int(response.choices[0].message.content.strip())\n",
+    "    except Exception:\n",
+    "        return 3  # default to medium complexity on error\n",
+    "    \n",
+    "def route_question_to_model(question: str, models_by_rank, classifier_model=router, model_name=orchestrator_model):\n",
+    "    level = classify_question_complexity(question, classifier_model, model_name)\n",
+    "    selected_model_name = models_by_rank[level - 1]\n",
+    "    return selected_model_name"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "difficulty_prompts = [\n",
+    "    \"Generate a very basic, factual question that a small or entry-level language model could answer easily. It should require no reasoning, just direct knowledge lookup.\",\n",
+    "    \"Generate a slightly involved question that requires basic reasoning, comparison, or combining two known facts. Still within the grasp of small models but not purely factual.\",\n",
+    "    \"Generate a moderately challenging question that requires some synthesis of ideas, multi-step reasoning, or contextual understanding. A mid-tier model should be able to answer it with effort.\",\n",
+    "    \"Generate a difficult question involving abstract thinking, open-ended reasoning, or ethical tradeoffs. The question should challenge large models to produce thoughtful and coherent responses.\",\n",
+    "    \"Generate an extremely complex and nuanced question that tests the limits of current language models. It should require deep reasoning, long-term planning, philosophy, or advanced multi-domain knowledge.\"\n",
+    "]\n",
+    "def generate_question(level, generator=generator, generator_model=orchestrator_model):\n",
+    "    prompt = (\n",
+    "        f\"{difficulty_prompts[level - 1]}\\n\"\n",
+    "        \"Answer only with the question, no explanation.\"\n",
+    "    )\n",
+    "    messages = [{\"role\": \"user\", \"content\": prompt}]\n",
+    "    response = generator.chat.completions.create(\n",
+    "        model=generator_model,  # or your planner model\n",
+    "        messages=messages\n",
+    "    )\n",
+    "    \n",
+    "    return response.choices[0].message.content\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Testing Routing Workflow"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Finally, to test the routing workflow, we create a function that accepts a task complexity level and triggers the full routing process.\n",
+    "\n",
+    "*Note: A level-N prompt isn't always assigned to the Nth-most capable model due to the classifier's subjective decisions.*"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def test_generation_routing(level):\n",
+    "    question = generate_question(level=level)\n",
+    "    answer_model = route_question_to_model(question, ranked_model_names)\n",
+    "    messages = [{\"role\": \"user\", \"content\": question}]\n",
+    "\n",
+    "    response =qa_models[answer_model].chat.completions.create(\n",
+    "            model=answer_model,  # or your planner model\n",
+    "            messages=messages\n",
+    "        )\n",
+    "    print(f\"Question : {question}\")\n",
+    "    print(f\"Routed to {answer_model}\")\n",
+    "    display(Markdown(response.choices[0].message.content))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "test_generation_routing(level=1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "test_generation_routing(level=2)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "test_generation_routing(level=3)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "test_generation_routing(level=4)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "test_generation_routing(level=5)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/1_lab_5_abrar.ipynb

@@ -0,0 +1,490 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "1151ec05",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "from rich.console import Console\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "import json\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "05b104aa",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "todos = []\n",
+    "completed = []"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "f834713b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def show(text):\n",
+    "    try:\n",
+    "        Console().print(text)\n",
+    "    except Exception:\n",
+    "        print(text)\n",
+    "\n",
+    "def get_todo_report() -> str:\n",
+    "    result = \"\"\n",
+    "    for index, todo in enumerate(todos):\n",
+    "        if completed[index]:\n",
+    "            result += f\"Todo #{index + 1}: [green][strike]{todo}[/strike][/green]\\n\"\n",
+    "        else:\n",
+    "            result += f\"Todo #{index + 1}: {todo}\\n\"\n",
+    "    show(result)\n",
+    "    return result\n",
+    "\n",
+    "def create_todos(descriptions: list[str]) -> str:\n",
+    "    todos.extend(descriptions)\n",
+    "    completed.extend([False] * len(descriptions))\n",
+    "    return get_todo_report()\n",
+    "\n",
+    "def mark_complete(index: int, notes: str) -> str:\n",
+    "    if 1<=index<=len(todos):\n",
+    "        completed[index - 1] = True\n",
+    "    else:\n",
+    "        return \"No todos\"\n",
+    "    Console().print(notes)\n",
+    "    return get_todo_report()\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "d381ce66",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>: Buy groceries\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2</span>: Clean the house\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">3</span>: Finish the project\n",
+       "\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "Todo #\u001b[1;36m1\u001b[0m: Buy groceries\n",
+       "Todo #\u001b[1;36m2\u001b[0m: Clean the house\n",
+       "Todo #\u001b[1;36m3\u001b[0m: Finish the project\n",
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/plain": [
+       "'Todo #1: Buy groceries\\nTodo #2: Clean the house\\nTodo #3: Finish the project\\n'"
+      ]
+     },
+     "execution_count": 16,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "create_todos([\"Buy groceries\", \"Clean the house\", \"Finish the project\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "id": "019c032d",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">I have cleaned the house\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "I have cleaned the house\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>: Buy groceries\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2</span>: <span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">Clean the house</span>\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">3</span>: Finish the project\n",
+       "\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "Todo #\u001b[1;36m1\u001b[0m: Buy groceries\n",
+       "Todo #\u001b[1;36m2\u001b[0m: \u001b[9;32mClean the house\u001b[0m\n",
+       "Todo #\u001b[1;36m3\u001b[0m: Finish the project\n",
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/plain": [
+       "'Todo #1: Buy groceries\\nTodo #2: [green][strike]Clean the house[/strike][/green]\\nTodo #3: Finish the project\\n'"
+      ]
+     },
+     "execution_count": 17,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "mark_complete(2, \"I have cleaned the house\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 34,
+   "id": "29a034ce",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "create_todos_json = {\n",
+    "    \"name\": \"create_todos\",\n",
+    "    \"description\": \"Add new todos from a list of descriptions and return the full list\",\n",
+    "    \"parameters\": {\n",
+    "        \"type\": \"object\",\n",
+    "        \"properties\": {\n",
+    "            \"descriptions\": {\n",
+    "                'type': 'array',\n",
+    "                'items': {'type': 'string'},\n",
+    "                'title': 'Descriptions'\n",
+    "                }\n",
+    "            },\n",
+    "        \"required\": [\"descriptions\"],\n",
+    "        \"additionalProperties\": False\n",
+    "    }\n",
+    "}\n",
+    "\n",
+    "mark_complete_json = {\n",
+    "    \"name\": \"mark_complete\",\n",
+    "    \"description\": \"Mark complete the todo at the given position (starting from 1) and return the full list\",\n",
+    "    \"parameters\": {\n",
+    "        'properties': {\n",
+    "            'index': {\n",
+    "                'description': 'The 1-based index of the todo to mark as complete',\n",
+    "                'title': 'Index',\n",
+    "                'type': 'integer'\n",
+    "                },\n",
+    "            'notes': {\n",
+    "                'description': 'Notes about how you completed the todo in rich console markup',\n",
+    "                'title': 'Notes',\n",
+    "                'type': 'string'\n",
+    "                }\n",
+    "            },\n",
+    "        'required': ['index', 'notes'],\n",
+    "        'type': 'object',\n",
+    "        'additionalProperties': False\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 35,
+   "id": "92ccd384",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tools = [{\"type\": \"function\", \"function\": create_todos_json},\n",
+    "        {\"type\": \"function\", \"function\": mark_complete_json}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 36,
+   "id": "64e82bd6",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def handle_tool_calls(tool_calls):\n",
+    "    results = []\n",
+    "    for tool_call in tool_calls:\n",
+    "        tool_name = tool_call.function.name\n",
+    "        arguments = json.loads(tool_call.function.arguments)\n",
+    "        tool = globals().get(tool_name)\n",
+    "        result = tool(**arguments) if tool else {}\n",
+    "        results.append({\"role\": \"tool\",\"content\": json.dumps(result),\"tool_call_id\": tool_call.id})\n",
+    "    return results"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "id": "37c00c69",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def loop(messages):\n",
+    "    done = False\n",
+    "    while not done:\n",
+    "        response = openai.chat.completions.create(model=\"gpt-5.2\", messages=messages, tools=tools, reasoning_effort=\"none\")\n",
+    "        finish_reason = response.choices[0].finish_reason\n",
+    "        if finish_reason==\"tool_calls\":\n",
+    "            message = response.choices[0].message\n",
+    "            tool_calls = message.tool_calls\n",
+    "            results = handle_tool_calls(tool_calls)\n",
+    "            messages.append(message)\n",
+    "            messages.extend(results)\n",
+    "        else:\n",
+    "            done = True\n",
+    "    show(response.choices[0].message.content)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 40,
+   "id": "1263fb23",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "system_message = \"\"\"\n",
+    "You are given a problem to solve, by using your todo tools to plan a list of steps, then carrying out each step in turn.\n",
+    "Now use the todo list tools, create a plan, carry out the steps, and reply with the solution.\n",
+    "If any quantity isn't provided in the question, then include a step to come up with a reasonable estimate.\n",
+    "Provide your solution in Rich console markup without code blocks.\n",
+    "Do not ask the user questions or clarification; respond only with the answer after using your tools.\n",
+    "\"\"\"\n",
+    "user_message = \"\"\"\n",
+    "If I invest $5,000 today at an annual interest rate of 7%, compounded monthly,\n",
+    "how much will I have after 10 years?\n",
+    "\"\"\"\n",
+    "messages = [{\"role\": \"system\", \"content\": system_message}, {\"role\": \"user\", \"content\": user_message}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 41,
+   "id": "0c9ea8db",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>: Identify given values and required formula for monthly compounding future value\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2</span>: Compute future value FV = P*<span style=\"font-weight: bold\">(</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>+r/m<span style=\"font-weight: bold\">)</span>^<span style=\"font-weight: bold\">(</span>m*t<span style=\"font-weight: bold\">)</span>\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">3</span>: Round to sensible cents and present final amount\n",
+       "\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "Todo #\u001b[1;36m1\u001b[0m: Identify given values and required formula for monthly compounding future value\n",
+       "Todo #\u001b[1;36m2\u001b[0m: Compute future value FV = P*\u001b[1m(\u001b[0m\u001b[1;36m1\u001b[0m+r/m\u001b[1m)\u001b[0m^\u001b[1m(\u001b[0mm*t\u001b[1m)\u001b[0m\n",
+       "Todo #\u001b[1;36m3\u001b[0m: Round to sensible cents and present final amount\n",
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"font-weight: bold\">Given</span>: principal P = $<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">5</span>,<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">000</span>; nominal annual rate r = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">0.07</span>; compounding m = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">12</span>/month; time t = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10</span> years.\n",
+       "<span style=\"font-weight: bold\">Use</span> monthly-compound future value: FV = P\\*<span style=\"font-weight: bold\">(</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span> + r/m<span style=\"font-weight: bold\">)</span>^<span style=\"font-weight: bold\">(</span>m\\*t<span style=\"font-weight: bold\">)</span>.\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[1mGiven\u001b[0m: principal P = $\u001b[1;36m5\u001b[0m,\u001b[1;36m000\u001b[0m; nominal annual rate r = \u001b[1;36m0.07\u001b[0m; compounding m = \u001b[1;36m12\u001b[0m/month; time t = \u001b[1;36m10\u001b[0m years.\n",
+       "\u001b[1mUse\u001b[0m monthly-compound future value: FV = P\\*\u001b[1m(\u001b[0m\u001b[1;36m1\u001b[0m + r/m\u001b[1m)\u001b[0m^\u001b[1m(\u001b[0mm\\*t\u001b[1m)\u001b[0m.\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>: <span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">Identify given values and required formula for monthly compounding future value</span>\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2</span>: Compute future value FV = P*<span style=\"font-weight: bold\">(</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>+r/m<span style=\"font-weight: bold\">)</span>^<span style=\"font-weight: bold\">(</span>m*t<span style=\"font-weight: bold\">)</span>\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">3</span>: Round to sensible cents and present final amount\n",
+       "\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "Todo #\u001b[1;36m1\u001b[0m: \u001b[9;32mIdentify given values and required formula for monthly compounding future value\u001b[0m\n",
+       "Todo #\u001b[1;36m2\u001b[0m: Compute future value FV = P*\u001b[1m(\u001b[0m\u001b[1;36m1\u001b[0m+r/m\u001b[1m)\u001b[0m^\u001b[1m(\u001b[0mm*t\u001b[1m)\u001b[0m\n",
+       "Todo #\u001b[1;36m3\u001b[0m: Round to sensible cents and present final amount\n",
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Compute: periodic rate = r/m = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">0.07</span>/<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">12</span> = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">0.0058333333</span>.\n",
+       "Number of periods = m*t = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">12</span>*<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10</span> = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">120</span>.\n",
+       "Growth factor = <span style=\"font-weight: bold\">(</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1.0058333333</span><span style=\"font-weight: bold\">)</span>^<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">120</span> ≈ <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2.009889</span>.\n",
+       "FV ≈ <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">5000</span> * <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2.009889</span> = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10049.447</span>.\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "Compute: periodic rate = r/m = \u001b[1;36m0.07\u001b[0m/\u001b[1;36m12\u001b[0m = \u001b[1;36m0.0058333333\u001b[0m.\n",
+       "Number of periods = m*t = \u001b[1;36m12\u001b[0m*\u001b[1;36m10\u001b[0m = \u001b[1;36m120\u001b[0m.\n",
+       "Growth factor = \u001b[1m(\u001b[0m\u001b[1;36m1.0058333333\u001b[0m\u001b[1m)\u001b[0m^\u001b[1;36m120\u001b[0m ≈ \u001b[1;36m2.009889\u001b[0m.\n",
+       "FV ≈ \u001b[1;36m5000\u001b[0m * \u001b[1;36m2.009889\u001b[0m = \u001b[1;36m10049.447\u001b[0m.\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>: <span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">Identify given values and required formula for monthly compounding future value</span>\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2</span>: <span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">Compute future value FV = P*</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">(</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">1</span><span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">+r/m</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">)</span><span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">^</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">(</span><span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">m*t</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">)</span>\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">3</span>: Round to sensible cents and present final amount\n",
+       "\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "Todo #\u001b[1;36m1\u001b[0m: \u001b[9;32mIdentify given values and required formula for monthly compounding future value\u001b[0m\n",
+       "Todo #\u001b[1;36m2\u001b[0m: \u001b[9;32mCompute future value FV = P*\u001b[0m\u001b[1;9;32m(\u001b[0m\u001b[1;9;32m1\u001b[0m\u001b[9;32m+r/m\u001b[0m\u001b[1;9;32m)\u001b[0m\u001b[9;32m^\u001b[0m\u001b[1;9;32m(\u001b[0m\u001b[9;32mm*t\u001b[0m\u001b[1;9;32m)\u001b[0m\n",
+       "Todo #\u001b[1;36m3\u001b[0m: Round to sensible cents and present final amount\n",
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Round to cents: $<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10</span>,<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">049.45</span>.\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "Round to cents: $\u001b[1;36m10\u001b[0m,\u001b[1;36m049.45\u001b[0m.\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>: <span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">Identify given values and required formula for monthly compounding future value</span>\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2</span>: <span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">Compute future value FV = P*</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">(</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">1</span><span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">+r/m</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">)</span><span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">^</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">(</span><span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">m*t</span><span style=\"color: #008000; text-decoration-color: #008000; font-weight: bold; text-decoration: line-through\">)</span>\n",
+       "Todo #<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">3</span>: <span style=\"color: #008000; text-decoration-color: #008000; text-decoration: line-through\">Round to sensible cents and present final amount</span>\n",
+       "\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "Todo #\u001b[1;36m1\u001b[0m: \u001b[9;32mIdentify given values and required formula for monthly compounding future value\u001b[0m\n",
+       "Todo #\u001b[1;36m2\u001b[0m: \u001b[9;32mCompute future value FV = P*\u001b[0m\u001b[1;9;32m(\u001b[0m\u001b[1;9;32m1\u001b[0m\u001b[9;32m+r/m\u001b[0m\u001b[1;9;32m)\u001b[0m\u001b[9;32m^\u001b[0m\u001b[1;9;32m(\u001b[0m\u001b[9;32mm*t\u001b[0m\u001b[1;9;32m)\u001b[0m\n",
+       "Todo #\u001b[1;36m3\u001b[0m: \u001b[9;32mRound to sensible cents and present final amount\u001b[0m\n",
+       "\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\"><span style=\"font-weight: bold\">Future value (monthly compounding)</span>\n",
+       "\n",
+       "<span style=\"font-weight: bold\">Formula:</span>  FV = <span style=\"color: #800080; text-decoration-color: #800080; font-weight: bold\">P</span><span style=\"font-weight: bold\">(</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span> + r/m<span style=\"font-weight: bold\">)</span>^<span style=\"font-weight: bold\">(</span>m·t<span style=\"font-weight: bold\">)</span>\n",
+       "\n",
+       "<span style=\"font-weight: bold\">Inputs:</span>\n",
+       "• P = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">5</span>,<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">000</span>  \n",
+       "• r = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">0.07</span>  \n",
+       "• m = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">12</span>  \n",
+       "• t = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10</span>  \n",
+       "\n",
+       "<span style=\"font-weight: bold\">Calculation:</span>\n",
+       "• Periodic rate = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">0.07</span>/<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">12</span> = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">0.0058333333</span>  \n",
+       "• Periods = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">12</span>·<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10</span> = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">120</span>  \n",
+       "• FV = <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">5000</span>·<span style=\"font-weight: bold\">(</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1.0058333333</span><span style=\"font-weight: bold\">)</span>^<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">120</span> ≈ <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">5000</span>·<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2.009889</span> ≈ <span style=\"font-weight: bold\">$</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10</span><span style=\"font-weight: bold\">,</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">049.45</span>\n",
+       "\n",
+       "<span style=\"font-weight: bold\">Answer:</span> After <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10</span> years, you’ll have approximately <span style=\"font-weight: bold\">$</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">10</span><span style=\"font-weight: bold\">,</span><span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">049.45</span>.\n",
+       "</pre>\n"
+      ],
+      "text/plain": [
+       "\u001b[1mFuture value \u001b[0m\u001b[1m(\u001b[0m\u001b[1mmonthly compounding\u001b[0m\u001b[1m)\u001b[0m\n",
+       "\n",
+       "\u001b[1mFormula:\u001b[0m  FV = \u001b[1;35mP\u001b[0m\u001b[1m(\u001b[0m\u001b[1;36m1\u001b[0m + r/m\u001b[1m)\u001b[0m^\u001b[1m(\u001b[0mm·t\u001b[1m)\u001b[0m\n",
+       "\n",
+       "\u001b[1mInputs:\u001b[0m\n",
+       "• P = \u001b[1;36m5\u001b[0m,\u001b[1;36m000\u001b[0m  \n",
+       "• r = \u001b[1;36m0.07\u001b[0m  \n",
+       "• m = \u001b[1;36m12\u001b[0m  \n",
+       "• t = \u001b[1;36m10\u001b[0m  \n",
+       "\n",
+       "\u001b[1mCalculation:\u001b[0m\n",
+       "• Periodic rate = \u001b[1;36m0.07\u001b[0m/\u001b[1;36m12\u001b[0m = \u001b[1;36m0.0058333333\u001b[0m  \n",
+       "• Periods = \u001b[1;36m12\u001b[0m·\u001b[1;36m10\u001b[0m = \u001b[1;36m120\u001b[0m  \n",
+       "• FV = \u001b[1;36m5000\u001b[0m·\u001b[1m(\u001b[0m\u001b[1;36m1.0058333333\u001b[0m\u001b[1m)\u001b[0m^\u001b[1;36m120\u001b[0m ≈ \u001b[1;36m5000\u001b[0m·\u001b[1;36m2.009889\u001b[0m ≈ \u001b[1m$\u001b[0m\u001b[1;36m10\u001b[0m\u001b[1m,\u001b[0m\u001b[1;36m049.45\u001b[0m\n",
+       "\n",
+       "\u001b[1mAnswer:\u001b[0m After \u001b[1;36m10\u001b[0m years, you’ll have approximately \u001b[1m$\u001b[0m\u001b[1;36m10\u001b[0m\u001b[1m,\u001b[0m\u001b[1;36m049.45\u001b[0m.\n"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "todos, completed = [], []\n",
+    "loop(messages)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "agents",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.6"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

community_contributions/1_medtech_opportunity_finder/01_medtech.ipynb

@@ -0,0 +1,133 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "8c8f2d93",
+   "metadata": {},
+   "source": [
+    "# 🏥 MedTech AI Opportunity Finder\n",
+    "\n",
+    "- 🌍 Task: Generate quirky healthcare/pharma AI business opportunities with pain points and solutions.\n",
+    "- 🧠 Model: Uses OpenAI GPT-4o-mini for creative business idea generation\n",
+    "- 🎯 Process: Three-step pipeline - Business Area → Pain Point → AI Solution\n",
+    "- 📌 Output Format: Markdown-formatted responses streamed in real-time with humor\n",
+    "- 🔧 Tools: OpenAI API and IPython display for interactive streaming\n",
+    "- 🧑‍💻 Skill Level: Beginner\n",
+    "\n",
+    "🛠️ Requirements\n",
+    "- ⚙️ Hardware: ✅ CPU is sufficient — no GPU required\n",
+    "- 🔑 OpenAI API Key\n",
+    "- IPython environment (Jupyter/Colab)\n",
+    "\n",
+    "---\n",
+    "📢 Discover more Agentic AI notebooks on my [GitHub repository](https://github.com/lisekarimi/agentverse) and explore additional AI projects on my [portfolio](https://lisekarimi.com)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1df27837",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from openai import OpenAI\n",
+    "from IPython.display import display, Markdown, update_display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "b197c72a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "client = OpenAI() # Automatically finds OPENAI_API_KEY without needing os.getenv() or load_dotenv()."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "cc8064bb",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def stream_response(messages, section_title):\n",
+    "    \"\"\"Stream response and display with real-time updates\"\"\"\n",
+    "    response_stream = client.chat.completions.create(\n",
+    "        model=\"gpt-4o-mini\",\n",
+    "        messages=messages,\n",
+    "        stream=True\n",
+    "    )\n",
+    "\n",
+    "    response = \"\"\n",
+    "    display_handle = display(Markdown(f\"## {section_title}\\n\\n\"), display_id=True)\n",
+    "\n",
+    "    for chunk in response_stream:\n",
+    "        if chunk.choices[0].delta.content:\n",
+    "            response += chunk.choices[0].delta.content\n",
+    "            # Clean up any unwanted markdown artifacts\n",
+    "            cleaned_response = response.replace(\"```\", \"\").replace(\"markdown\", \"\")\n",
+    "            update_display(Markdown(f\"## {section_title}\\n\\n{cleaned_response}\"), display_id=display_handle.display_id)\n",
+    "\n",
+    "    return response"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "857e0458",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Step 1: Business area\n",
+    "messages = [{\"role\": \"user\", \"content\": \"Give me a quirky healthcare or pharma business area for an AI agent. Keep it short and clear.\"}]\n",
+    "business_idea = stream_response(messages, \"🏢 Business Area\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "23838465",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Step 2: Pain point\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"What's broken about {business_idea}? Short and funny.\"}]\n",
+    "pain_point = stream_response(messages, \"😵 What's Broken\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5aa70151",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Step 3: AI solution\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"How would an AI agent solve this {pain_point}? Brief and clear.\"}]\n",
+    "solution = stream_response(messages, \"🤖 AI to the Rescue\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "agentverse",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

community_contributions/1_psvasan/day1_exercise.ipynb

@@ -0,0 +1,113 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "73a4a1cd",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Imports required for this exercise\n",
+    "from dotenv import load_dotenv\n",
+    "import os\n",
+    "from openai import OpenAI\n",
+    "from IPython.display import Markdown,display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "be280e57",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# load the env variables from \".env\" file\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "cc673c30",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Check if the API key is set\n",
+    "api_key = os.getenv(\"OPENAI_API_KEY\")\n",
+    "if not api_key:\n",
+    "    raise ValueError(\"OPENAI_API_KEY is not set!!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "c574ee90",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create an instance of the openai python client\n",
+    "openai_client = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "da2d3820",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# First ask LLM to identify the most important pain point in the Cybersecurity domain that companies need to\n",
+    "# focus on in 2026\n",
+    "message = \"\"\"\n",
+    "What is one top area for cybersecurity organizations to focus on in 2026? Limit your answer to 3-5 sentences.\n",
+    "Only return the top pain point and no additional details on solution. Respond in markdown without code blocks.\n",
+    "\"\"\"\n",
+    "messages = [\n",
+    "    {\"role\": \"user\", \"content\": message}\n",
+    "]\n",
+    "\n",
+    "MODEL_NAME=\"gpt-4o-mini\"\n",
+    "\n",
+    "response = openai_client.chat.completions.create(\n",
+    "    model=MODEL_NAME,\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "painpoint = response.choices[0].message.content\n",
+    "display(Markdown(painpoint))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

community_contributions/2_lab2-Evaluator-AnnpaS18.ipynb

@@ -0,0 +1,474 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Important point - please read</h2>\n",
+    "            <span style=\"color:#ff7800;\">The way I collaborate with you may be different to other courses you've taken. I prefer not to type code while you watch. Rather, I execute Jupyter Labs, like this, and give you an intuition for what's going on. My suggestion is that you carefully execute this yourself, <b>after</b> watching the lecture. Add print statements to understand what's going on, and then come up with your own variations.<br/><br/>If you have time, I'd love it if you submit a PR for changes in the community_contributions folder - instructions in the resources. Also, if you have a Github account, use this to showcase your variations. Not only is this essential practice, but it demonstrates your skills to others, including perhaps future clients or employers...\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "\n",
+    "model_name = \"gpt-4o-mini\"\n",
+    "\n",
+    "response = openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "model_name = \"claude-3-7-sonnet-latest\"\n",
+    "\n",
+    "claude = Anthropic()\n",
+    "response = claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "answer = response.content[0].text\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gemini = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "model_name = \"gemini-2.0-flash\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "model_name = \"deepseek-chat\"\n",
+    "\n",
+    "response = deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "groq = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "model_name = \"llama-3.3-70b-versatile\"\n",
+    "\n",
+    "response = groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## For the next cell, we will use Ollama\n",
+    "\n",
+    "Ollama runs a local web service that gives an OpenAI compatible endpoint,  \n",
+    "and runs models locally using high performance C++ code.\n",
+    "\n",
+    "If you don't have Ollama, install it here by visiting https://ollama.com then pressing Download and following the instructions.\n",
+    "\n",
+    "After it's installed, you should be able to visit here: http://localhost:11434 and see the message \"Ollama is running\"\n",
+    "\n",
+    "You might need to restart Cursor (and maybe reboot). Then open a Terminal (control+\\`) and run `ollama serve`\n",
+    "\n",
+    "Useful Ollama commands (run these in the terminal, or with an exclamation mark in this notebook):\n",
+    "\n",
+    "`ollama pull <model_name>` downloads a model locally  \n",
+    "`ollama ls` lists all the models you've downloaded  \n",
+    "`ollama rm <model_name>` deletes the specified model from your downloads"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Super important - ignore me at your peril!</h2>\n",
+    "            <span style=\"color:#ff7800;\">The model called <b>llama3.3</b> is FAR too large for home computers - it's not intended for personal computing and will consume all your resources! Stick with the nicely sized <b>llama3.2</b> or <b>llama3.2:1b</b> and if you want larger, try llama3.1 or smaller variants of Qwen, Gemma, Phi or DeepSeek. See the <A href=\"https://ollama.com/models\">the Ollama models page</a> for a full list of models and sizes.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ollama = OpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "model_name = \"llama3.2\"\n",
+    "\n",
+    "response = ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# So where are we?\n",
+    "\n",
+    "print(competitors)\n",
+    "print(answers)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# It's nice to know how to use \"zip\"\n",
+    "for competitor, answer in zip(competitors, answers):\n",
+    "    print(f\"Competitor: {competitor}\\n\\n{answer}\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's bring this together - note the use of \"enumerate\"\n",
+    "\n",
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(competitors)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Judgement time!\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"o3-mini\",\n",
+    "    messages=judge_messages,\n",
+    ")\n",
+    "results = response.choices[0].message.content\n",
+    "print(results)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "results_dict = json.loads(results)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "for index, result in enumerate(ranks):\n",
+    "    competitor = competitors[int(result)-1]\n",
+    "    print(f\"Rank {index+1}: {competitor}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Which pattern(s) did this use? Try updating this to add another Agentic design pattern.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">These kinds of patterns - to send a task to multiple models, and evaluate results,\n",
+    "            are common where you need to improve the quality of your LLM response. This approach can be universally applied\n",
+    "            to business projects where accuracy is critical.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2-judge-prompt-changed.ipynb

@@ -0,0 +1,476 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Important point - please read</h2>\n",
+    "            <span style=\"color:#ff7800;\">The way I collaborate with you may be different to other courses you've taken. I prefer not to type code while you watch. Rather, I execute Jupyter Labs, like this, and give you an intuition for what's going on. My suggestion is that you carefully execute this yourself, <b>after</b> watching the lecture. Add print statements to understand what's going on, and then come up with your own variations.<br/><br/>If you have time, I'd love it if you submit a PR for changes in the community_contributions folder - instructions in the resources. Also, if you have a Github account, use this to showcase your variations. Not only is this essential practice, but it demonstrates your skills to others, including perhaps future clients or employers...\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "\n",
+    "model_name = \"gpt-4o-mini\"\n",
+    "\n",
+    "response = openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "model_name = \"claude-3-7-sonnet-latest\"\n",
+    "\n",
+    "claude = Anthropic()\n",
+    "response = claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "answer = response.content[0].text\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gemini = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "model_name = \"gemini-2.0-flash\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "model_name = \"deepseek-chat\"\n",
+    "\n",
+    "response = deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "groq = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "model_name = \"llama-3.3-70b-versatile\"\n",
+    "\n",
+    "response = groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## For the next cell, we will use Ollama\n",
+    "\n",
+    "Ollama runs a local web service that gives an OpenAI compatible endpoint,  \n",
+    "and runs models locally using high performance C++ code.\n",
+    "\n",
+    "If you don't have Ollama, install it here by visiting https://ollama.com then pressing Download and following the instructions.\n",
+    "\n",
+    "After it's installed, you should be able to visit here: http://localhost:11434 and see the message \"Ollama is running\"\n",
+    "\n",
+    "You might need to restart Cursor (and maybe reboot). Then open a Terminal (control+\\`) and run `ollama serve`\n",
+    "\n",
+    "Useful Ollama commands (run these in the terminal, or with an exclamation mark in this notebook):\n",
+    "\n",
+    "`ollama pull <model_name>` downloads a model locally  \n",
+    "`ollama ls` lists all the models you've downloaded  \n",
+    "`ollama rm <model_name>` deletes the specified model from your downloads"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Super important - ignore me at your peril!</h2>\n",
+    "            <span style=\"color:#ff7800;\">The model called <b>llama3.3</b> is FAR too large for home computers - it's not intended for personal computing and will consume all your resources! Stick with the nicely sized <b>llama3.2</b> or <b>llama3.2:1b</b> and if you want larger, try llama3.1 or smaller variants of Qwen, Gemma, Phi or DeepSeek. See the <A href=\"https://ollama.com/models\">the Ollama models page</a> for a full list of models and sizes.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ollama = OpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "model_name = \"llama3.2\"\n",
+    "\n",
+    "response = ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# So where are we?\n",
+    "\n",
+    "print(competitors)\n",
+    "print(answers)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# It's nice to know how to use \"zip\"\n",
+    "for competitor, answer in zip(competitors, answers):\n",
+    "    print(f\"Competitor: {competitor}\\n\\n{answer}\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's bring this together - note the use of \"enumerate\"\n",
+    "\n",
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(competitors)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "Answer only the number for example\n",
+    "{{\"results\": [\"1\", \"2\", \"3\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Judgement time!\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"o3-mini\",\n",
+    "    messages=judge_messages,\n",
+    ")\n",
+    "results = response.choices[0].message.content\n",
+    "print(results)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "results_dict = json.loads(results)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "for index, result in enumerate(ranks):\n",
+    "    competitor = competitors[int(result)-1]\n",
+    "    print(f\"Rank {index+1}: {competitor}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Which pattern(s) did this use? Try updating this to add another Agentic design pattern.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">These kinds of patterns - to send a task to multiple models, and evaluate results,\n",
+    "            are common where you need to improve the quality of your LLM response. This approach can be universally applied\n",
+    "            to business projects where accuracy is critical.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2-nv-orch-worker-pattern.ipynb

@@ -0,0 +1,727 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Lab 3: Orchestrator-Worker Pattern\n",
+    "\n",
+    "This notebook implements the **Orchestrator-Worker Pattern** with **Parallel Execution**:\n",
+    "\n",
+    "1. **Orchestrator LLM**: Decides which worker models to call based on the question\n",
+    "2. **Worker Models**: Selected models run **simultaneously** in parallel using async/await\n",
+    "3. **Synthesizer LLM**: Aggregates outputs, synthesizes a final answer, and ranks the workers\n",
+    "\n",
+    "## Pattern Flow\n",
+    "\n",
+    "```\n",
+    "User Question → Orchestrator LLM (\"Which workers to use?\")\n",
+    " ↓\n",
+    "Parallel Worker API Calls (Only selected models)\n",
+    " ↓\n",
+    "Synthesizer LLM (Merge + Rank)\n",
+    " ↓\n",
+    "Final Answer + Worker Rankings\n",
+    "```\n",
+    "\n",
+    "The **LLM orchestrator** replaces hardcoded model selection with intelligent routing."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "import asyncio\n",
+    "import random\n",
+    "from datetime import datetime, timedelta\n",
+    "from typing import Dict, List, Any, Tuple\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display\n",
+    "import textwrap"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 1: Generate Evaluation Question\n",
+    "\n",
+    "First, generate a challenging question to test all the worker models."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "print(question)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 2: Prepare Worker Configurations\n",
+    "\n",
+    "Prepare all available **worker** model configurations that the orchestrator can choose from."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ==========================================\n",
+    "# Worker Preparation: All Available Models\n",
+    "# ==========================================\n",
+    "\n",
+    "def evaluator_prepare_configs():\n",
+    "    \"\"\"\n",
+    "    Evaluator: Gathers API keys and prepares configurations for all models.\n",
+    "    Returns a list of model configurations ready for parallel execution.\n",
+    "    \"\"\"\n",
+    "    configs = []\n",
+    "    \n",
+    "    # Model 1: OpenAI\n",
+    "    configs.append({\n",
+    "        \"model_name\": \"gpt-5-nano\",\n",
+    "        \"provider\": \"openai\",\n",
+    "        \"client\": OpenAI(),\n",
+    "        \"call_type\": \"chat.completions\",\n",
+    "        \"extra_params\": {}\n",
+    "    })\n",
+    "    \n",
+    "    # Model 2: Anthropic\n",
+    "    configs.append({\n",
+    "        \"model_name\": \"claude-sonnet-4-5\",\n",
+    "        \"provider\": \"anthropic\",\n",
+    "        \"client\": Anthropic(),\n",
+    "        \"call_type\": \"messages.create\",\n",
+    "        \"extra_params\": {\"max_tokens\": 1000}\n",
+    "    })\n",
+    "    \n",
+    "    # Model 3: Gemini\n",
+    "    configs.append({\n",
+    "        \"model_name\": \"gemini-2.5-flash\",\n",
+    "        \"provider\": \"gemini\",\n",
+    "        \"client\": OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\"),\n",
+    "        \"call_type\": \"chat.completions\",\n",
+    "        \"extra_params\": {}\n",
+    "    })\n",
+    "    \n",
+    "    # Model 4: DeepSeek\n",
+    "    configs.append({\n",
+    "        \"model_name\": \"deepseek/deepseek-r1-0528:free\",\n",
+    "        \"provider\": \"deepseek\",\n",
+    "        \"client\": OpenAI(api_key=deepseek_api_key, base_url=\"https://openrouter.ai/api/v1\"),\n",
+    "        \"call_type\": \"chat.completions\",\n",
+    "        \"extra_params\": {}\n",
+    "    })\n",
+    "    \n",
+    "    # Model 5: Groq\n",
+    "    configs.append({\n",
+    "        \"model_name\": \"openai/gpt-oss-120b\",\n",
+    "        \"provider\": \"groq\",\n",
+    "        \"client\": OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\"),\n",
+    "        \"call_type\": \"chat.completions\",\n",
+    "        \"extra_params\": {}\n",
+    "    })\n",
+    "    \n",
+    "    # Model 6: Ollama (if available)\n",
+    "    configs.append({\n",
+    "        \"model_name\": \"llama3.2\",\n",
+    "        \"provider\": \"ollama\",\n",
+    "        \"client\": OpenAI(base_url='http://localhost:11434/v1', api_key='ollama'),\n",
+    "        \"call_type\": \"chat.completions\",\n",
+    "        \"extra_params\": {}\n",
+    "    })\n",
+    "    \n",
+    "    print(f\"✅ Evaluator prepared {len(configs)} model configurations\")\n",
+    "    return configs\n",
+    "\n",
+    "# Prepare global config dictionaries\n",
+    "MODEL_CONFIGS = evaluator_prepare_configs()\n",
+    "MODEL_CONFIGS_BY_NAME = {cfg[\"model_name\"]: cfg for cfg in MODEL_CONFIGS}"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 3: Orchestrator LLM - Decide Which Workers to Use\n",
+    "\n",
+    "The **orchestrator LLM** analyzes the question and selects which worker models to invoke in parallel."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ==========================================\n",
+    "# Orchestrator: LLM Decides Worker Selection\n",
+    "# ==========================================\n",
+    "\n",
+    "def list_worker_tools():\n",
+    "    \"\"\"Return tool descriptions for the orchestrator LLM.\"\"\"\n",
+    "    tools = []\n",
+    "    for cfg in MODEL_CONFIGS:\n",
+    "        tools.append({\n",
+    "            \"name\": cfg[\"model_name\"],\n",
+    "            \"description\": f\"Call the {cfg['provider']} model {cfg['model_name']} \"\n",
+    "                          \"to answer the user question.\",\n",
+    "            \"parameters\": {\n",
+    "                \"type\": \"object\",\n",
+    "                \"properties\": {\n",
+    "                    \"reason\": {\n",
+    "                        \"type\": \"string\",\n",
+    "                        \"description\": \"Why this model is useful for this query.\"\n",
+    "                    }\n",
+    "                },\n",
+    "                \"required\": [\"reason\"]\n",
+    "            }\n",
+    "        })\n",
+    "    return tools\n",
+    "\n",
+    "def build_orchestrator_prompt(user_question: str, tools: list) -> list:\n",
+    "    tool_descriptions = \"\\n\".join(\n",
+    "        f\"- {t['name']}: {t['description']}\" for t in tools\n",
+    "    )\n",
+    "\n",
+    "    system_msg = textwrap.dedent(f\"\"\"\n",
+    "        You are an **orchestrator** LLM in an orchestrator–worker system.\n",
+    "\n",
+    "        You do NOT answer the user's question directly.\n",
+    "        Instead, you decide which worker models to call in parallel.\n",
+    "\n",
+    "        Available workers:\n",
+    "        {tool_descriptions}\n",
+    "\n",
+    "        Output STRICTLY valid JSON:\n",
+    "        {{\n",
+    "          \"models_to_call\": [\n",
+    "            {{\"name\": \"<model_name>\", \"reason\": \"<short reason>\"}},\n",
+    "            ...\n",
+    "          ]\n",
+    "        }}\n",
+    "\n",
+    "        Requirements:\n",
+    "        - Choose at least 3 and at most 6 models.\n",
+    "        - Use model names exactly as listed.\n",
+    "        - Prefer diversity (different providers) for hard reasoning tasks.\n",
+    "        - Do not include any fields other than \"models_to_call\".\n",
+    "    \"\"\")\n",
+    "\n",
+    "    return [\n",
+    "        {\"role\": \"system\", \"content\": system_msg},\n",
+    "        {\"role\": \"user\", \"content\": user_question},\n",
+    "    ]\n",
+    "\n",
+    "def orchestrator_plan(user_question: str) -> list:\n",
+    "    \"\"\"\n",
+    "    Ask the orchestrator LLM which workers to use.\n",
+    "    Returns list of selected model names.\n",
+    "    \"\"\"\n",
+    "    tools = list_worker_tools()\n",
+    "    messages = build_orchestrator_prompt(user_question, tools)\n",
+    "\n",
+    "    openai = OpenAI()\n",
+    "    resp = openai.chat.completions.create(\n",
+    "        model=\"gpt-4o-mini\",\n",
+    "        # model=\"gemini-1.5-flash\",\n",
+    "        messages=messages,\n",
+    "        temperature=0.2,\n",
+    "    )\n",
+    "    content = resp.choices[0].message.content\n",
+    "    plan = json.loads(content)\n",
+    "    selected = [m[\"name\"] for m in plan.get(\"models_to_call\", [])]\n",
+    "    print(f\"🎯 Orchestrator selected {len(selected)} workers: {selected}\")\n",
+    "    return selected"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 4: Parallel Worker Execution\n",
+    "\n",
+    "Execute **only the selected workers** simultaneously using async/await."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ==========================================\n",
+    "# Worker Execution: Async Single Model Call\n",
+    "# ==========================================\n",
+    "\n",
+    "async def call_model_async(config: Dict[str, Any], messages: List[Dict]) -> Tuple[str, str]:\n",
+    "    \"\"\"\n",
+    "    Call a single worker model asynchronously.\n",
+    "    Returns (model_name, answer) or (model_name, error_message).\n",
+    "    \"\"\"\n",
+    "    model_name = config[\"model_name\"]\n",
+    "    provider = config[\"provider\"]\n",
+    "    client = config[\"client\"]\n",
+    "    call_type = config[\"call_type\"]\n",
+    "    extra_params = config[\"extra_params\"]\n",
+    "    \n",
+    "    try:\n",
+    "        if provider == \"anthropic\":\n",
+    "            # Anthropic uses a different API structure\n",
+    "            response = await asyncio.to_thread(\n",
+    "                client.messages.create,\n",
+    "                model=model_name,\n",
+    "                messages=messages,\n",
+    "                **extra_params\n",
+    "            )\n",
+    "            answer = response.content[0].text\n",
+    "        else:\n",
+    "            # OpenAI-compatible APIs\n",
+    "            response = await asyncio.to_thread(\n",
+    "                client.chat.completions.create,\n",
+    "                model=model_name,\n",
+    "                messages=messages,\n",
+    "                **extra_params\n",
+    "            )\n",
+    "            answer = response.choices[0].message.content\n",
+    "        \n",
+    "        print(f\"✅ {model_name} completed\")\n",
+    "        return model_name, answer\n",
+    "        \n",
+    "    except Exception as e:\n",
+    "        error_msg = f\"Error calling {model_name}: {str(e)}\"\n",
+    "        print(f\"❌ {error_msg}\")\n",
+    "        return model_name, error_msg"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ==========================================\n",
+    "# Parallel Worker Execution\n",
+    "# ==========================================\n",
+    "\n",
+    "def format_bytes(size: int) -> str:\n",
+    "    \"\"\"Format bytes into a human-readable string (B, KB, MB).\"\"\"\n",
+    "    for unit in ['B', 'KB', 'MB']:\n",
+    "        if size < 1024.0:\n",
+    "            return f\"{size:.2f} {unit}\"\n",
+    "        size /= 1024.0\n",
+    "    return f\"{size:.2f} GB\"\n",
+    "\n",
+    "async def execute_models_in_parallel(configs: List[Dict[str, Any]], messages: List[Dict]) -> Tuple[List[str], List[str]]:\n",
+    "    \"\"\"\n",
+    "    Execute selected worker models in parallel.\n",
+    "    \"\"\"\n",
+    "    print(f\"\\n🚀 Starting parallel execution of {len(configs)} selected workers...\\n\")\n",
+    "    \n",
+    "    table_rows = []\n",
+    "    competitors = []\n",
+    "    answers = []\n",
+    "    \n",
+    "    async def call_with_metrics(config):\n",
+    "        model_name = config.get(\"model_name\", \"Unknown\")\n",
+    "        start_time = datetime.now()\n",
+    "        \n",
+    "        try:\n",
+    "            _, answer = await call_model_async(config, messages)\n",
+    "            end_time = datetime.now()\n",
+    "            \n",
+    "            if isinstance(answer, str) and answer.startswith(\"Error\"):\n",
+    "                status = \"❌ Error\"\n",
+    "                out_size = 0\n",
+    "            else:\n",
+    "                status = \"✅ Success\"\n",
+    "                out_size = len(str(answer).encode('utf-8'))\n",
+    "                \n",
+    "        except Exception as e:\n",
+    "            end_time = datetime.now()\n",
+    "            status = \"❌ Error\"\n",
+    "            answer = str(e)\n",
+    "            out_size = 0\n",
+    "\n",
+    "        # Calculate duration\n",
+    "        duration = end_time - start_time\n",
+    "        total_seconds = int(duration.total_seconds())\n",
+    "        mm, ss = divmod(total_seconds, 60)\n",
+    "        hh, mm = divmod(mm, 60)\n",
+    "        dur_str = f\"{hh:02d}:{mm:02d}:{ss:02d}\" if hh > 0 else f\"{mm:02d}:{ss:02d}\"\n",
+    "\n",
+    "        # Store metrics for table\n",
+    "        table_rows.append({\n",
+    "            \"model\": model_name,\n",
+    "            \"status\": status,\n",
+    "            \"start\": start_time.strftime(\"%H:%M:%S\"),\n",
+    "            \"end\": end_time.strftime(\"%H:%M:%S\"),\n",
+    "            \"duration\": dur_str,\n",
+    "            \"size\": format_bytes(out_size)\n",
+    "        })\n",
+    "        \n",
+    "        return model_name, answer, status\n",
+    "\n",
+    "    # Run tasks in parallel\n",
+    "    tasks = [call_with_metrics(config) for config in configs]\n",
+    "    results = await asyncio.gather(*tasks)\n",
+    "\n",
+    "    # Process final lists\n",
+    "    for model_name, answer, status in results:\n",
+    "        if status == \"✅ Success\":\n",
+    "            competitors.append(model_name)\n",
+    "            answers.append(answer)\n",
+    "\n",
+    "    # Print Tabular Output\n",
+    "    header = f\"{'Model':<25} {'Status':<10} {'Start':<10} {'End':<10} {'Duration':<10} {'Size':<12}\"\n",
+    "    print(header)\n",
+    "    print(\"-\" * len(header))\n",
+    "    for row in table_rows:\n",
+    "        print(f\"{row['model']:<25} {row['status']:<10} {row['start']:<10} {row['end']:<10} {row['duration']:<10} {row['size']:<12}\")\n",
+    "    \n",
+    "    print(f\"\\n✅ Completed. {len(competitors)}/{len(configs)} workers successful.\")\n",
+    "    return competitors, answers\n",
+    "\n",
+    "async def mock_execute_models_in_parallel(configs: List[Dict[str, Any]]) -> Tuple[List[str], List[str]]:\n",
+    "    \"\"\"\n",
+    "    Mocks parallel API calls to display timing and size metrics in a table.\n",
+    "    No actual API calls are made.\n",
+    "    \"\"\"\n",
+    "    print(f\"\\n🚀 Starting MOCK execution of {len(configs)} models...\\n\")\n",
+    "    \n",
+    "    table_rows = []\n",
+    "    competitors = []\n",
+    "    answers = []\n",
+    "\n",
+    "    async def mock_api_call(config):\n",
+    "        model_name = config.get(\"model_name\", \"Unknown-Model\")\n",
+    "        start_time = datetime.now()\n",
+    "        \n",
+    "        # Simulate varying network latency (0.5 to 2.5 seconds)\n",
+    "        await asyncio.sleep(random.uniform(0.5, 2.5))\n",
+    "        \n",
+    "        # Randomly decide if this mock call \"fails\" (10% chance)\n",
+    "        is_success = random.random() > 0.1\n",
+    "        \n",
+    "        if is_success:\n",
+    "            status = \"✅ Success\"\n",
+    "            # Mock a response string of random length\n",
+    "            mock_answer = \"Mock response data \" * random.randint(5, 500)\n",
+    "            out_size = len(mock_answer.encode('utf-8'))\n",
+    "        else:\n",
+    "            status = \"❌ Error\"\n",
+    "            mock_answer = \"Error: Mocked API failure\"\n",
+    "            out_size = 0\n",
+    "            \n",
+    "        end_time = datetime.now()\n",
+    "        \n",
+    "        # Calculate duration in mm:ss or hh:mm:ss\n",
+    "        duration = end_time - start_time\n",
+    "        total_seconds = int(duration.total_seconds())\n",
+    "        mm, ss = divmod(total_seconds, 60)\n",
+    "        hh, mm = divmod(mm, 60)\n",
+    "        dur_str = f\"{hh:02d}:{mm:02d}:{ss:02d}\" if hh > 0 else f\"{mm:02d}:{ss:02d}\"\n",
+    "\n",
+    "        # Record metrics for the final table\n",
+    "        metrics = {\n",
+    "            \"model\": model_name,\n",
+    "            \"status\": status,\n",
+    "            \"start\": start_time.strftime(\"%H:%M:%S\"),\n",
+    "            \"end\": end_time.strftime(\"%H:%M:%S\"),\n",
+    "            \"duration\": dur_str,\n",
+    "            \"size\": format_bytes(out_size)\n",
+    "        }\n",
+    "        \n",
+    "        return model_name, mock_answer, status, metrics\n",
+    "\n",
+    "    # Execute mock tasks in parallel\n",
+    "    tasks = [mock_api_call(config) for config in configs]\n",
+    "    results = await asyncio.gather(*tasks)\n",
+    "\n",
+    "    # Prepare table headers\n",
+    "    header = f\"{'Model':<20} {'Status':<10} {'Start':<10} {'End':<10} {'Duration':<10} {'Size':<12}\"\n",
+    "    print(header)\n",
+    "    print(\"-\" * len(header))\n",
+    "\n",
+    "    # Output rows and collect final success data\n",
+    "    for model_name, answer, status, row in results:\n",
+    "        print(f\"{row['model']:<20} {row['status']:<10} {row['start']:<10} {row['end']:<10} {row['duration']:<10} {row['size']:<12}\")\n",
+    "        if status == \"✅ Success\":\n",
+    "            competitors.append(model_name)\n",
+    "            answers.append(answer)\n",
+    "\n",
+    "    print(f\"\\n✅ Completed. {len(competitors)}/{len(configs)} models simulated successfully.\")\n",
+    "    return competitors, answers\n",
+    "\n",
+    "async def execute_selected_models(model_names: list, messages: list):\n",
+    "    \"\"\"Execute only the orchestrator-selected workers.\"\"\"\n",
+    "    selected_configs = [MODEL_CONFIGS_BY_NAME[m] for m in model_names]\n",
+    "    return await execute_models_in_parallel(selected_configs, messages)\n",
+    "\n",
+    "async def mock_execute_selected_models(model_names: list):\n",
+    "    \"\"\"Execute only the orchestrator-selected workers.\"\"\"\n",
+    "    selected_configs = [MODEL_CONFIGS_BY_NAME[m] for m in model_names]\n",
+    "    return await mock_execute_models_in_parallel(selected_configs)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 5: Run Orchestrated Pipeline\n",
+    "\n",
+    "**Full end-to-end execution**: Orchestrator → Workers → Synthesizer."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ==========================================\n",
+    "# FULL ORCHESTRATED PIPELINE\n",
+    "# ==========================================\n",
+    "\n",
+    "user_question = question  # From Step 1\n",
+    "messages = [{\"role\": \"user\", \"content\": user_question}]\n",
+    "\n",
+    "# 1) Orchestrator chooses workers\n",
+    "selected_models = orchestrator_plan(user_question)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# 2) Mock execute chosen workers\n",
+    "competitors, answers = await mock_execute_selected_models(selected_models)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# 2) Run chosen workers in parallel\n",
+    "competitors, answers = await execute_selected_models(selected_models, messages)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 6: Synthesizer LLM - Merge + Rank\n",
+    "\n",
+    "The **synthesizer LLM** creates a final answer and ranks the worker models."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ==========================================\n",
+    "# Synthesizer: Merge Outputs + Rank Workers\n",
+    "# ==========================================\n",
+    "\n",
+    "def aggregator_format_outputs(competitors: List[str], answers: List[str]) -> str:\n",
+    "    \"\"\"Format worker outputs for the synthesizer.\"\"\"\n",
+    "    together = \"\"\n",
+    "    for index, answer in enumerate(answers):\n",
+    "        together += f\"# Response from {competitors[index]}\\n\\n\"\n",
+    "        together += answer + \"\\n\\n\"\n",
+    "    return together\n",
+    "\n",
+    "def build_synthesizer_prompt(question: str, competitors: list, answers: list) -> list:\n",
+    "    formatted = aggregator_format_outputs(competitors, answers)\n",
+    "    num_workers = len(competitors)\n",
+    "    \n",
+    "    system_msg = f\"\"\"\n",
+    "    You are evaluating EXACTLY {num_workers} worker responses.\n",
+    "    \n",
+    "    CRITICAL: There are ONLY {num_workers} competitors numbered 1-{num_workers}.\n",
+    "    \n",
+    "    Tasks:\n",
+    "    1. Synthesize final answer from these {num_workers} responses\n",
+    "    2. Rank ONLY these {num_workers} responses (indices 1-{num_workers})\n",
+    "    \n",
+    "    Output STRICTLY valid JSON:\n",
+    "    {{\n",
+    "      \"final_answer\": \"your synthesized answer\",\n",
+    "      \"rankings\": [\n",
+    "        {{\"competitor_index\": N, \"reason\": \"why N is good\"}}  // N is 1-{num_workers}\n",
+    "        // EXACTLY {num_workers} entries, no more, no less\n",
+    "      ]\n",
+    "    }}\n",
+    "    \n",
+    "    Responses ({num_workers} total):\n",
+    "    {formatted}\n",
+    "    \"\"\"\n",
+    "    \n",
+    "    return [{\"role\": \"system\", \"content\": system_msg}]\n",
+    "\n",
+    "def run_synthesizer(question: str, competitors: list, answers: list):\n",
+    "    \"\"\"Run the synthesizer LLM.\"\"\"\n",
+    "    messages = build_synthesizer_prompt(question, competitors, answers)\n",
+    "    openai = OpenAI()\n",
+    "    resp = openai.chat.completions.create(\n",
+    "        model=\"gpt-4o-mini\",\n",
+    "        messages=messages,\n",
+    "        temperature=0.3,\n",
+    "    )\n",
+    "    data = json.loads(resp.choices[0].message.content)\n",
+    "    return data"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ==========================================\n",
+    "# FINAL SYNTHESIS AND RANKINGS\n",
+    "# ==========================================\n",
+    "\n",
+    "# Run synthesizer\n",
+    "synth = run_synthesizer(question, competitors, answers)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "for idx, r in enumerate(synth[\"rankings\"], start=1):\n",
+    "    name = competitors[r[\"competitor_index\"] - 1]\n",
+    "    print(f\"{idx}. {name} — {r['reason']}\")\n",
+    "\n",
+    "print(f\"\\n✅ Pipeline complete! Orchestrator → {len(selected_models)} Workers → Synthesizer\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# IMMEDIATE DEBUG\n",
+    "print(\"COMPETITORS:\", competitors)\n",
+    "print(\"NUM COMPETITORS:\", len(competitors))\n",
+    "print(\"RAW SYNTH:\", json.dumps(synth, indent=2))\n",
+    "print(\"RANKINGS:\", [r.get(\"competitor_index\") for r in synth.get(\"rankings\", [])])\n",
+    "\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2-parallelization.ipynb

@@ -0,0 +1,440 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Changes I've made with this lab.\n",
+    "1) Modified the original question to instead generate a range of questions, 12 of them.  These questions will be used to evaluate each LLM's reasoning, knowledge, creativity, and ability to handle nuanced scenarios.\n",
+    "2) I've changed this lab to run the queries in parallel.  Thanks GPT for helping with the code to do that.  :)\n",
+    "3) Instead of having one LLM rate all the responses, I have all of the LLM's rate each others work and then use a Borda Count to asign points to determine the winner."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "gemini_api_key = os.getenv('GEMINI_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if gemini_api_key:\n",
+    "    print(f\"Gemini API Key exists and begins {gemini_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Gemini API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"\"\"You are being evaluated for your reasoning, knowledge, creativity, and ability to handle nuanced scenarios. \n",
+    "Generate 12 questions that cover the following categories:\n",
+    "- Logical reasoning and problem solving\n",
+    "- Creative writing and storytelling\n",
+    "- Factual accuracy and knowledge recall\n",
+    "- Following instructions with strict constraints\n",
+    "- Multi-step planning and organization\n",
+    "- Ethical dilemmas and debatable issues\n",
+    "- Philosophical or abstract reasoning\n",
+    "- Summarization and explanation at different levels\n",
+    "- Translation and multilingual ability\n",
+    "- Roleplay or adaptive communication style\n",
+    "\n",
+    "Number each question from 1 to 12. \n",
+    "The result should be a balanced benchmark question set that fully tests an LLM’s capabilities.\n",
+    "\n",
+    "Important: Output only clean plain text. \n",
+    "Do not use any markup, formatting symbols, quotation marks, brackets, lists, or special characters \n",
+    "that could cause misinterpretation. Only provide plain text questions, one per line, numbered 1 to 20.\n",
+    "\"\"\"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Generate the questions.\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(question))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ask the LLM's in Parallel\n",
+    "\n",
+    "import asyncio\n",
+    "\n",
+    "clients = {\n",
+    "    \"openai\": OpenAI(),\n",
+    "    \"claude\": Anthropic(),\n",
+    "    \"gemini\": OpenAI(api_key=gemini_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\"),\n",
+    "    \"deepseek\": OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\"),\n",
+    "    \"groq\": OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\"),\n",
+    "}\n",
+    "\n",
+    "# Get the answers from the LLM\n",
+    "async def call_llm(model_name, messages):\n",
+    "    try:\n",
+    "        if \"claude\" in model_name:\n",
+    "            response = await asyncio.to_thread(\n",
+    "                clients[\"claude\"].messages.create,\n",
+    "                model=model_name,\n",
+    "                messages=messages,\n",
+    "                max_tokens=3000,\n",
+    "            )\n",
+    "            answer = \"\".join([c.text for c in response.content if c.type == \"text\"])\n",
+    "        \n",
+    "        elif \"gpt-4o-mini\" in model_name:\n",
+    "            response = await asyncio.to_thread(\n",
+    "                clients[\"openai\"].chat.completions.create,\n",
+    "                model=model_name,\n",
+    "                messages=messages,\n",
+    "            )\n",
+    "            answer = response.choices[0].message.content\n",
+    "\n",
+    "        elif \"gemini\" in model_name:\n",
+    "            response = await asyncio.to_thread(\n",
+    "                clients[\"gemini\"].chat.completions.create,\n",
+    "                model=model_name,\n",
+    "                messages=messages,\n",
+    "            )\n",
+    "            answer = response.choices[0].message.content\n",
+    "\n",
+    "        elif \"deepseek\" in model_name:\n",
+    "            response = await asyncio.to_thread(\n",
+    "                clients[\"deepseek\"].chat.completions.create,\n",
+    "                model=model_name,\n",
+    "                messages=messages,\n",
+    "            )\n",
+    "            answer = response.choices[0].message.content\n",
+    "\n",
+    "        elif \"llama\" in model_name:\n",
+    "            response = await asyncio.to_thread(\n",
+    "                clients[\"groq\"].chat.completions.create,\n",
+    "                model=model_name,\n",
+    "                messages=messages,\n",
+    "            )\n",
+    "            answer = response.choices[0].message.content\n",
+    "\n",
+    "        return model_name, answer        \n",
+    "\n",
+    "    except Exception as e:\n",
+    "        print (f\"❌ Error: {str(e)}\")\n",
+    "        return model_name, \"I was not able to generate answers for any of the questions.\"\n",
+    "\n",
+    "\n",
+    "# send out the calls to the LLM to ask teh questions.\n",
+    "async def ask_questions_in_parallel(messages):\n",
+    "    competitor_models = [\n",
+    "        \"gpt-4o-mini\",\n",
+    "        \"claude-3-7-sonnet-latest\",\n",
+    "        \"gemini-2.0-flash\",\n",
+    "        \"deepseek-chat\",\n",
+    "        \"llama-3.3-70b-versatile\"\n",
+    "    ]\n",
+    "\n",
+    "    # create tasks to call the LLM's in parallel\n",
+    "    tasks = [call_llm(model, messages) for model in competitor_models]\n",
+    "\n",
+    "    answers = []\n",
+    "    competitors = []\n",
+    "\n",
+    "    # When we have an answer, we can process it.  No waiting.\n",
+    "    for task in asyncio.as_completed(tasks):\n",
+    "        model_name, answer = await task\n",
+    "        competitors.append(model_name)\n",
+    "        answers.append(answer)\n",
+    "        print(f\"\\n✅ Got response from {model_name}\")\n",
+    "\n",
+    "    return competitors, answers"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Fire off the ask to all the LLM's at once.  Parallelization...\n",
+    "competitors, answers = await ask_questions_in_parallel(messages)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#Look at the results\n",
+    "print (len(answers))\n",
+    "print (len(competitors))\n",
+    "print (competitors)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's bring this together - note the use of \"enumerate\"\n",
+    "\n",
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "judge = f\"\"\"You are judging a competition between {len(competitors)} competitors.\n",
+    "Each model has been given the folowing questions:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your task is to evaluate the overall strength of the arguments presented by each competitor. \n",
+    "Consider the following factors:\n",
+    "- Clarity: how clearly the ideas are communicated\n",
+    "- Relevance: how directly the response addresses the question\n",
+    "- Depth: the level of reasoning, insight, or supporting evidence provided\n",
+    "- Persuasiveness: how compelling or convincing the response is overall\n",
+    "Respond with JSON, and only JSON.\n",
+    "The output must be a single JSON array of competitor names, ordered from best to worst.\n",
+    "Do not include any keys, labels, or extra text.\n",
+    "\n",
+    "Example format:\n",
+    "[\"1\", \"3\", \"5\", \"2\", \"4\"]\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\n",
+    "Do not deviate from the json format as described above.  Do not include the term ranking in the final json\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Have each LLM rate all of the results.\n",
+    "results = dict()\n",
+    "LLM_result = ''\n",
+    "\n",
+    "competitors, answers = await ask_questions_in_parallel(judge_messages)\n",
+    "\n",
+    "results = dict()\n",
+    "for index, each_competitor in enumerate(competitors):\n",
+    "    results[each_competitor] = answers[index].strip()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# See the results\n",
+    "print (len(answers))\n",
+    "results = dict()\n",
+    "for index, each_competitor in enumerate(competitors):\n",
+    "    results[each_competitor] = answers[index]\n",
+    "\n",
+    "print (results)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Lets convert these rankings into scores.  Borda Count - (1st gets 4, 2nd gets 3, etc.).\n",
+    "number_of_competitors = len(competitors)\n",
+    "scores = {}\n",
+    "\n",
+    "for rankings in results.values():\n",
+    "    print(rankings)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# # Borda count points (1st gets n-1, 2nd gets n-2, etc.)\n",
+    "num_competitors = len(competitors)\n",
+    "\n",
+    "competitor_dict = dict()\n",
+    "for index, each_competitor in enumerate(competitors):\n",
+    "    competitor_dict[each_competitor] = index + 1\n",
+    "\n",
+    "borda_scores_dict = dict()\n",
+    "for each_competitor in competitors:\n",
+    "    if each_competitor not in borda_scores_dict:\n",
+    "        borda_scores_dict[each_competitor] = 0\n",
+    "\n",
+    "for voter_llm, ranking_str in results.items():\n",
+    "    ranking_indices = json.loads(ranking_str)\n",
+    "    ranking_indices = [int(x) for x in ranking_indices]\n",
+    "\n",
+    "    # For each position in the ranking, award points\n",
+    "    for position, competitor_index in enumerate(ranking_indices):\n",
+    "        competitor_name = competitors[competitor_index - 1]\n",
+    "\n",
+    "        # Borda count points (1st gets n-1, 2nd gets n-2, etc.)\n",
+    "        points = num_competitors - 1 - position  \n",
+    "        borda_scores_dict[competitor_name] += points\n",
+    "    \n",
+    "sorted_results = sorted(borda_scores_dict.items(), key=lambda x: x[1], reverse=True)\n",
+    "\n",
+    "print(f\"{'Rank':<4} {'LLM':<30} {'Points':<3}\")\n",
+    "print(\"-\" * 50)\n",
+    "\n",
+    "for rank, (llm, points) in enumerate(sorted_results, 1):\n",
+    "    print(f\"{rank:<4} {llm:<30} {points:<8}\")\n",
+    "\n",
+    "print(\"\\nQuestions asked:\")\n",
+    "print(question)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.2"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2.1_ss.ipynb

@@ -0,0 +1,767 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Multimodel Architecture - Routing Workflow "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OpenAI API Key exists and begins sk-proj-\n",
+      "Anthropic API Key not set (and this is optional)\n",
+      "Google API Key exists and begins AI\n",
+      "DeepSeek API Key exists and begins sk-\n",
+      "Groq API Key exists and begins gsk_\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai_client = OpenAI(api_key=openai_api_key)\n",
+    "deepseek_client = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "gemini_client = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "groq_client = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "MODEL_REGISTRY = {\n",
+    "    \"gpt-5-nano\": {\n",
+    "        \"provider\": \"openai\",\n",
+    "        \"strength\": \"general\",\n",
+    "        \"cost\": \"low\"\n",
+    "    },\n",
+    "    \"gpt-5-mini\": {\n",
+    "        \"provider\": \"openai\",\n",
+    "        \"strength\": \"reasoning\",\n",
+    "        \"cost\": \"medium\"\n",
+    "    },\n",
+    "    \n",
+    "    \"deepseek-chat\": {\n",
+    "        \"provider\": \"deepseek\",\n",
+    "        \"strength\": \"coding\",\n",
+    "        \"cost\": \"low\"\n",
+    "    },\n",
+    "    \"gemini-2.5-flash\": {\n",
+    "        \"provider\": \"google\",\n",
+    "        \"strength\": \"general\",\n",
+    "        \"cost\": \"low\"\n",
+    "    }\n",
+    "}\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "ROUTER AGENT"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def classify_task(user_input):\n",
+    "    router_prompt = f\"\"\"\n",
+    "    Classify the task into ONE of these categories:\n",
+    "    - coding\n",
+    "    - creative_writing\n",
+    "    - quantitative_reasoning\n",
+    "    - strategic_analysis\n",
+    "    - simple_general\n",
+    "\n",
+    "    Respond ONLY with the category name.\n",
+    "\n",
+    "    User request:\n",
+    "    {user_input}\n",
+    "    \"\"\"\n",
+    "\n",
+    "    response = openai_client.chat.completions.create(\n",
+    "        model=\"gpt-5-nano\",\n",
+    "        messages=[{\"role\": \"user\", \"content\": router_prompt}],\n",
+    "    )\n",
+    "\n",
+    "    return response.choices[0].message.content.strip()\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "ROUTING LOGIC"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def select_model(task_type):\n",
+    "    if task_type == \"coding\":\n",
+    "        return \"deepseek-chat\"\n",
+    "    elif task_type == \"creative_writing\":\n",
+    "        return \"gemini-2.5-flash\"\n",
+    "    elif task_type == \"quantitative_reasoning\":\n",
+    "        return \"gpt-5-mini\"\n",
+    "    elif task_type == \"strategic_analysis\":\n",
+    "        return \"gpt-5-mini\"\n",
+    "    else:\n",
+    "        return \"gpt-5-nano\"\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "EXECUTION LAYER"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def call_model(model_name, user_input):\n",
+    "\n",
+    "    if model_name in [\"gpt-5-nano\", \"gpt-5-mini\"]:\n",
+    "        response = openai_client.chat.completions.create(\n",
+    "            model=model_name,\n",
+    "            messages=[{\"role\": \"user\", \"content\": user_input}],\n",
+    "        )\n",
+    "        return response.choices[0].message.content\n",
+    "\n",
+    "    elif model_name == \"deepseek-chat\":\n",
+    "        response = deepseek_client.chat.completions.create(\n",
+    "            model=model_name,\n",
+    "            messages=[{\"role\": \"user\", \"content\": user_input}],\n",
+    "        )\n",
+    "        return response.choices[0].message.content\n",
+    "\n",
+    "    elif model_name == \"gemini-2.5-flash\":\n",
+    "        response = gemini_client.chat.completions.create(\n",
+    "            model=model_name,\n",
+    "            messages=[{\"role\": \"user\", \"content\": user_input}],\n",
+    "        )\n",
+    "        return response.choices[0].message.content\n",
+    "\n",
+    "    else:\n",
+    "        raise ValueError(\"Unknown model\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def route_and_execute(user_input):\n",
+    "\n",
+    "    print(\"Classifying task...\")\n",
+    "    task_type = classify_task(user_input)\n",
+    "    print(\"Task type:\", task_type)\n",
+    "\n",
+    "    model_name = select_model(task_type)\n",
+    "    print(\"Selected model:\", model_name)\n",
+    "\n",
+    "    print(\"Executing\")\n",
+    "    answer = call_model(model_name, user_input)\n",
+    "\n",
+    "    return answer\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "TESTING"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Classifying task...\n",
+      "Task type: coding\n",
+      "Selected model: deepseek-chat\n",
+      "Executing\n",
+      "\n",
+      "Final Answer:\n",
+      "\n",
+      "Here's a Python function to calculate factorial recursively:\n",
+      "\n",
+      "```python\n",
+      "def factorial(n):\n",
+      "    \"\"\"\n",
+      "    Calculate the factorial of a non-negative integer n recursively.\n",
+      "    \n",
+      "    Parameters:\n",
+      "    n (int): A non-negative integer\n",
+      "    \n",
+      "    Returns:\n",
+      "    int: The factorial of n (n!)\n",
+      "    \n",
+      "    Raises:\n",
+      "    ValueError: If n is negative\n",
+      "    \"\"\"\n",
+      "    # Base case: factorial of 0 is 1\n",
+      "    if n == 0:\n",
+      "        return 1\n",
+      "    \n",
+      "    # Error case: factorial is not defined for negative numbers\n",
+      "    if n < 0:\n",
+      "        raise ValueError(\"Factorial is not defined for negative numbers\")\n",
+      "    \n",
+      "    # Recursive case: n! = n * (n-1)!\n",
+      "    return n * factorial(n - 1)\n",
+      "\n",
+      "\n",
+      "# Example usage\n",
+      "if __name__ == \"__main__\":\n",
+      "    # Test cases\n",
+      "    test_numbers = [0, 1, 5, 7, 10]\n",
+      "    \n",
+      "    for num in test_numbers:\n",
+      "        result = factorial(num)\n",
+      "        print(f\"factorial({num}) = {result}\")\n",
+      "    \n",
+      "    # Test with negative number (will raise ValueError)\n",
+      "    try:\n",
+      "        factorial(-3)\n",
+      "    except ValueError as e:\n",
+      "        print(f\"Error: {e}\")\n",
+      "```\n",
+      "\n",
+      "**Key points about this implementation:**\n",
+      "\n",
+      "1. **Base Case**: `factorial(0) = 1` - This stops the recursion\n",
+      "2. **Recursive Case**: `factorial(n) = n * factorial(n-1)` - This breaks down the problem\n",
+      "3. **Error Handling**: Raises `ValueError` for negative inputs\n",
+      "4. **Documentation**: Includes docstring explaining the function's purpose and parameters\n",
+      "\n",
+      "**How it works:**\n",
+      "- For `factorial(5)`, the recursion unfolds as:\n",
+      "  - `5 * factorial(4)`\n",
+      "  - `5 * (4 * factorial(3))`\n",
+      "  - `5 * (4 * (3 * factorial(2)))`\n",
+      "  - `5 * (4 * (3 * (2 * factorial(1))))`\n",
+      "  - `5 * (4 * (3 * (2 * (1 * factorial(0)))))`\n",
+      "  - `5 * (4 * (3 * (2 * (1 * 1)))) = 120`\n",
+      "\n",
+      "**Note**: While recursive solutions are elegant, they can cause stack overflow for very large values of `n` due to Python's recursion depth limit (typically around 1000). For production code with large inputs, an iterative approach would be more efficient and safer.\n"
+     ]
+    }
+   ],
+   "source": [
+    "user_question = \"Write a Python function to calculate factorial recursively.\"\n",
+    "\n",
+    "result = route_and_execute(user_question)\n",
+    "\n",
+    "print(\"\\nFinal Answer:\\n\")\n",
+    "print(result)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Classifying task...\n",
+      "Task type: quantitative_reasoning\n",
+      "Selected model: gpt-5-mini\n",
+      "Executing\n",
+      "\n",
+      "Final Answer:\n",
+      "\n",
+      "Let p = 12% be the price cut and q = 18% the increase in quantity.\n",
+      "\n",
+      "New revenue / old revenue = (1 − p)(1 + q) = 0.88 × 1.18 = 1.0384, so revenue rises by 3.84%.\n",
+      "\n",
+      "In general revenue increases iff (1 − p)(1 + q) > 1, i.e.\n",
+      "q > p/(1 − p).\n",
+      "\n",
+      "For p = 0.12 this threshold is 0.12/0.88 ≈ 13.636%. Since q = 18% > 13.636%, revenue increases.\n",
+      "\n",
+      "Equivalently (using elasticity): the price cut raises revenue when demand is elastic (|%ΔQ| / |%ΔP| > 1). Here 18%/12% = 1.5 > 1, so revenue increases.\n"
+     ]
+    }
+   ],
+   "source": [
+    "user_question = \"If a company reduces prices by 12% and sales volume increases by 18%, under what conditions does total revenue increase?\"\n",
+    "\n",
+    "result = route_and_execute(user_question)\n",
+    "\n",
+    "print(\"\\nFinal Answer:\\n\")\n",
+    "print(result)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Classifying task...\n",
+      "Task type: creative_writing\n",
+      "Selected model: gemini-2.5-flash\n",
+      "Executing\n",
+      "\n",
+      "Final Answer:\n",
+      "\n",
+      "AI is deeply reshaping the creative industry, offering immense opportunities and complex challenges. It empowers artists, designers, and writers by accelerating idea generation, streamlining workflows, and enabling rapid prototyping. AI tools democratize creation, lowering barriers for individuals to produce high-quality content, from personalized marketing to novel art forms, boosting efficiency and expanding artistic boundaries.\n",
+      "\n",
+      "However, job displacement concerns are valid as AI automates routine tasks. Ethical dilemmas surrounding copyright, data ownership, and fair artist compensation are pressing. The debate about AI-generated art's authenticity versus human creations also persists. Ultimately, the creative industry must adapt, viewing AI as a powerful co-pilot and tool, not a full replacement, to navigate this evolving future.\n"
+     ]
+    }
+   ],
+   "source": [
+    "user_question = \"Write a 150 word essay on AI impacting creative industry\"\n",
+    "\n",
+    "result = route_and_execute(user_question)\n",
+    "\n",
+    "print(\"\\nFinal Answer:\\n\")\n",
+    "print(result)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Classifying task...\n",
+      "Task type: strategic_analysis\n",
+      "Selected model: gpt-5-mini\n",
+      "Executing\n",
+      "\n",
+      "Final Answer:\n",
+      "\n",
+      "Short summary\n",
+      "- Problem: clients are switching to AI automation because the firm’s services are increasingly commoditized, price-sensitive, and easily replicated by AI tools.\n",
+      "- Goal: reposition the firm from pure labor-driven delivery to a higher-value, AI-augmented advisor that combines domain expertise, outcome guarantees, and turnkey AI-enabled products and managed services — while cutting costs, stabilizing cash flow, and rebuilding growth.\n",
+      "\n",
+      "High-level turnaround objectives (12 months)\n",
+      "1. Stop client churn and stabilize revenue within 90 days.\n",
+      "2. Launch 2–3 AI-augmented productized offerings and 1 managed-service capability within 6 months.\n",
+      "3. Re-skill core consulting staff and build an AI/analytics capability to support scaled delivery within 12 months.\n",
+      "4. Achieve positive EBITDA improvement and restore pipeline velocity by month 12.\n",
+      "\n",
+      "Quick diagnosis — why clients leave\n",
+      "- Client problems are becoming commoditized (data cleaning, reporting, forecasting), and AI tools do these faster/cheaper.\n",
+      "- The firm competes on hourly rate/delivery rather than outcomes and IP.\n",
+      "- Limited internal AI skills, so clients go to pure-play AI vendors.\n",
+      "- Few productized offerings, low repeatability, and high delivery cost base.\n",
+      "\n",
+      "Strategic pillars (what to do)\n",
+      "1. Move up the value chain: sell outcome-based, strategic services clients can’t easily automate (strategy, governance, business model design, change management, complex multi-stakeholder programs).\n",
+      "2. Productize and scale: turn repeatable work into packaged offerings, accelerators, and managed services (subscription, outcome-based contracts).\n",
+      "3. Become AI-native: adopt AI internally to increase efficiency and create differentiated client offerings (human + AI workflow).\n",
+      "4. Reskill and reconfigure talent: create T-shaped consultants (domain + AI/tooling) and build small multidisciplinary squads.\n",
+      "5. Market repositioning & partnerships: lead with ROI-focused case studies, partner with cloud/AI providers and niche AI boutiques.\n",
+      "6. Financial triage: cut non-core cost, stabilize cash, prioritize must-win accounts and profitable services.\n",
+      "\n",
+      "90/180/365-day roadmap (prioritized, with owners)\n",
+      "0–30 days — Stabilize (CEO / CRO / CFO)\n",
+      "- Top-10 client retention blitz: assign exec sponsors, run account health calls, offer rapid-value pilots (free/discounted AI health check + 6-week ROI pilot).\n",
+      "- Triage portfolio: identify top 30% profitable offerings and stop lowest-margin services.\n",
+      "- Cash & cost actions: freeze hiring, re-negotiate vendor contracts, reduce discretionary spend, evaluate lease/staffing options.\n",
+      "KPIs: churn rate, cash runway, # retention meetings.\n",
+      "\n",
+      "30–90 days — Quick wins and foundation (COO / Head of Delivery / Head of Sales)\n",
+      "- Launch “AI Health Check” and “Automation Fast-Track” 4–6 week productized pilots with clear ROI metrics and case-study playbook.\n",
+      "- Create go/no-go criteria for continuing projects (profitability, strategic fit).\n",
+      "- Form a small AI Center of Excellence (CoE) — hire/contract 2-4 data engineers/scientists and 1 product manager.\n",
+      "- Sales enablement: new value-selling pitch decks, ROI calculators, reference pricing templates.\n",
+      "KPIs: pilots launched, pilot-to-paid conversion, gross margin improvement.\n",
+      "\n",
+      "90–180 days — Build & productize (Head of Product / CTO / CHRO)\n",
+      "- Productize 2–3 high-potential offerings (e.g., \"AI-augmented Forecasting Package\", \"Regulatory AI Governance & Ops\", \"M&A Data Room + Insights as a Service\").\n",
+      "- Launch managed services: run-rate, subscription pricing (e.g., Managed Insights or MLOps).\n",
+      "- Reskilling program: cohort training for consultants (AI tools, prompt engineering, data literacy, change mgmt).\n",
+      "- Establish partnerships with 1–2 cloud/AI vendors (AWS/Azure/GCP, OpenAI/Databricks) for tech & go-to-market.\n",
+      "KPIs: number of productized offerings, subscription/recurring revenue, staff upskilled.\n",
+      "\n",
+      "180–365 days — Scale & optimize (CEO / CFO / CRO)\n",
+      "- Scale sales motions for packaged offerings with playbooks and verticalized sales teams.\n",
+      "- Launch outcome-based pricing pilots (gainshare / risk-sharing) on 3–5 deals.\n",
+      "- Institutionalize reuse: knowledge base, accelerators, IP marketplaces, delivery templates.\n",
+      "- Explore bolt-on acquisition of an AI boutique or platform if gaps remain.\n",
+      "KPIs: ARR from productized services, average project margin, NPS, pipeline conversion.\n",
+      "\n",
+      "Detailed initiatives (what to build & sell)\n",
+      "- Advisory & transformation: AI strategy, operating model, data strategy, regulatory & ethics advisory — priced by value, not hours.\n",
+      "- AI-enabled “diagnostic + pilot” package: standardized discovery, rapid PoV, 6-8 week ROI pilot with dashboard and decision pack.\n",
+      "- Managed Insights / AI Ops: continuous model monitoring, governance, retraining, performance reporting as a subscription.\n",
+      "- Industry-specific solutions: focus on 2–3 verticals where domain nuance matters (healthcare, financial services, manufacturing, energy).\n",
+      "- Change & adoption services: training, behavior change, process redesign — these remain hard to automate.\n",
+      "- Productized accelerators: reusable ETL connectors, templates, dashboards, prompt libraries, model wrappers — sell as add-ons or license.\n",
+      "\n",
+      "Sales & pricing playbook\n",
+      "- Move from hourly to outcome-based selling: define measurable client KPIs (cost savings, time-to-insight, revenue uplift) and tie fees to outcomes.\n",
+      "- Pilot-to-scale path: discovery → low-cost pilot (fixed fee) → scaled implementation (subscription / gainshare).\n",
+      "- Account-based marketing and EVP: target accounts with specific case studies showing X% ROI in Y months.\n",
+      "- Value calculator and case-study repository for rapid ROI proof.\n",
+      "\n",
+      "Talent & organization\n",
+      "- Create AI CoE to centralize platform, IP, accelerators, and best practices.\n",
+      "- Build multidisciplinary squads: PM, data eng, data scientist, domain consultant, change lead.\n",
+      "- Reskill senior consultants via certification tracks (cloud + AI + domain).\n",
+      "- Use blended workforce: permanent core + vetted freelance network for surge capacity.\n",
+      "- Revise performance incentives: reward landing productized deals, subscription growth, client retention, and reuse/IP contributions.\n",
+      "\n",
+      "Technology & delivery\n",
+      "- Adopt internal AI tools to improve utilization (automate proposals, scoping, coding, reporting).\n",
+      "- Standardize cloud infra, CI/CD, MLOps to speed delivery and reduce cost.\n",
+      "- Invest in reusable data and model pipelines to lower delivery time for repeatable tasks.\n",
+      "\n",
+      "Partnerships & M&A\n",
+      "- Strategic partnerships with cloud providers for credits, solution certifications and co-selling.\n",
+      "- Partner with niche AI firms for rapid capability injection.\n",
+      "- Consider acquiring a small AI shop to accelerate capability if financially viable.\n",
+      "\n",
+      "Financial plan & cost management\n",
+      "- Prioritize high-margin and strategic accounts; pause or offboard low-margin work.\n",
+      "- Short-term cost reductions: pause hiring, reduce travel, renegotiate vendors.\n",
+      "- Reinvest savings into CoE, sales enablement, and 2–3 productization projects.\n",
+      "- Target: improve gross margins by 6–10% within 12 months; reach break-even on product development via recurring contracts in 9–12 months.\n",
+      "\n",
+      "Governance & change management\n",
+      "- Appoint a Turnaround Leader (CRO or COO) with 90-day and 12-month accountability.\n",
+      "- Weekly steering committee (CEO, CFO, CRO, Head of Delivery, Head of Product) for rapid decisions.\n",
+      "- Monthly reviews of KPIs and client recovery plan status.\n",
+      "- Communicate transparently to staff and priority clients to maintain confidence.\n",
+      "\n",
+      "KPIs to track\n",
+      "- Client churn rate and retention of top-20 accounts\n",
+      "- Pipeline value and conversion rate for productized offers\n",
+      "- Revenue mix: % recurring/subscription vs. time-and-materials\n",
+      "- Average project margin and utilization\n",
+      "- Number of pilots converted to paid engagements\n",
+      "- NPS / client satisfaction\n",
+      "- Time-to-value for pilots (target < 90 days)\n",
+      "\n",
+      "Top 6 quick wins (week 1–8)\n",
+      "1. Executive outreach to top 10 at-risk clients with retention offers and pilot proposals.\n",
+      "2. Free/discounted AI Health Check as a client win-back mechanism.\n",
+      "3. Stop or renegotiate low-margin contracts and redeploy staff to pilots.\n",
+      "4. Build a one-page “ROI for automation vs. buy advisory” calculator for sales.\n",
+      "5. Stand up a 2–4 person AI CoE (mix of hires + contractors).\n",
+      "6. Publish 2 short case studies/POVs from pilots to use in marketing.\n",
+      "\n",
+      "Risks and mitigations\n",
+      "- Revenue drop during transition: mitigate with prioritized retention, rapid pilots, and cost reductions.\n",
+      "- Talent attrition: communicate vision, fast reskilling, and incentives for new behaviors.\n",
+      "- Execution overload: sequence initiatives, focus on 2–3 productized offerings first.\n",
+      "- Client skepticism of new models: use small guaranteed pilots and outcome-based pricing to build trust.\n",
+      "\n",
+      "Estimated resource needs (ballpark)\n",
+      "- AI CoE launch: $200–500k initial (contractors + tooling) if lean; $1–2M if hiring full-time team and tooling.\n",
+      "- Productization & GTM: $150–400k for 2–3 productized offers (PM, engineering, marketing, pilot subsidies).\n",
+      "- Reskilling program: $50–150k for cohorts, training content, and certifications.\n",
+      "(Adjust to actual firm size and burn runway)\n",
+      "\n",
+      "Immediate next steps (first week)\n",
+      "1. CEO convenes leadership to approve turnaround plan and appoint Turnaround Leader.\n",
+      "2. Create playbook and one-pager for AI Health Check pilot; assign sales owners for top-10 accounts.\n",
+      "3. Freeze non-essential spend and start client outreach.\n",
+      "4. Hire/contract 2 technical resources for CoE and prepare pilot templates.\n",
+      "\n",
+      "Closing thought\n",
+      "Clients aren’t rejecting consulting — they’re rejecting low-differentiation, labor-heavy delivery. The firm’s path back to growth is to combine domain expertise, outcome-oriented commercial models, and AI-native delivery with repeatable, productized offerings and managed services. Focus the first 90 days on retaining clients and proving quick ROI pilots; use those wins to fund the transformation to a scalable, differentiated business.\n",
+      "\n",
+      "If you want, I can:\n",
+      "- Draft the 90-day execution checklist with owners and dates,\n",
+      "- Sketch 3 productized service packages (scope, pricing model, metrics),\n",
+      "- Prepare a client outreach script and ROI calculator template. Which would help most right now?\n"
+     ]
+    }
+   ],
+   "source": [
+    "user_question = \"A mid-sized consulting firm is losing clients due to AI automation. Propose a structured turnaround strategy.\"\n",
+    "\n",
+    "result = route_and_execute(user_question)\n",
+    "\n",
+    "print(\"\\nFinal Answer:\\n\")\n",
+    "print(result)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Classifying task...\n",
+      "Task type: strategic_analysis\n",
+      "Selected model: gpt-5-mini\n",
+      "Executing\n",
+      "\n",
+      "Final Answer:\n",
+      "\n",
+      "Executive summary\n",
+      "- Problem: Clients are switching to AI automation (tools/products) that replace parts of traditional consulting work. That erodes revenue, pipeline and perceived relevance.\n",
+      "- Goal: Stabilize revenue, stop client churn, and rebuild a differentiated, sustainable services/offering model where the firm adds value that AI alone cannot.\n",
+      "- Approach: Three-phase turnaround (Stabilize 0–3 months; Rebuild 3–12 months; Grow & Scale 12–36 months) built on five strategic pillars: client centricity & retention, productized outcome offerings, AI-native advisory + delivery, talent & operating model, and partnerships & IP.\n",
+      "\n",
+      "Diagnosis (what to check immediately)\n",
+      "- Client churn analysis: Which segments, services, and clients left and why (cost, speed, perceived equivalence of AI)?\n",
+      "- Service mapping: Which consulting tasks are commoditized by AI vs. which remain high-value (strategy, leadership, change, complex data integration, regulatory)?\n",
+      "- Revenue concentration & pipeline health.\n",
+      "- Cost base & utilization of consultants.\n",
+      "- Current AI skills, tools, accelerators, proprietary IP.\n",
+      "- Sales messaging: Are you selling outputs (reports, PPTs) or outcomes (revenue, cost, risk reduction)?\n",
+      "\n",
+      "Strategic objectives (90 days / 12 months)\n",
+      "- 90 days: Stop urgent churn, stabilize cash flow, get leadership alignment, quick-win AI-enabled offerings.\n",
+      "- 12 months: Launch 3-5 differentiated, outcome-based service lines; retrain top talent; sign new contracts with outcome or subscription pricing.\n",
+      "- 24–36 months: Grow recurring revenue, expand IP, become a recognized AI + domain specialist in 1–2 verticals.\n",
+      "\n",
+      "Five strategic pillars and concrete actions\n",
+      "\n",
+      "1) Client retention & win-back (Immediate)\n",
+      "- Triage clients: segment by risk and lifetime value. Prioritize Top 20% and at-risk accounts.\n",
+      "- Outreach program: executive-to-executive win-back calls, present a short “AI impact and recovery” plan and free diagnostics/workshop.\n",
+      "- Offer immediate value: free or discounted AI-readiness assessment and a 4-week proof-of-value (PoV) focused on a revenue/cost/risk metric.\n",
+      "- Contract tactics: short-term renewal discounts tied to pilots or outcome guarantees to lock revenue while you rebuild offerings.\n",
+      "\n",
+      "2) Productize outcomes (Short—Medium term)\n",
+      "- Move from time-and-materials / slide decks to productized services: “AI-enabled forecasting as a service,” “Regulatory AI compliance program,” “Sales opportunity prediction + remediation.”\n",
+      "- Define standardized scopes, packaging, pricing, SLAs and KPIs.\n",
+      "- Launch managed services/subscription models for recurrent work. This de-risks clients and creates predictable revenue.\n",
+      "\n",
+      "3) AI-native advisory + delivery (Short—Medium term)\n",
+      "- Create an internal AI Center of Excellence (CoE) that combines domain experts, ML engineers, data engineers and experience designers.\n",
+      "- Offer integrated solutions: strategy + data platform + change management. Sell outcomes (e.g., X% cost reduction, Y% increase in sales conversion).\n",
+      "- Build accelerators: templates, pre-trained models, connectors to popular vendors (OpenAI, Azure, AWS, Snowflake, etc.) to shorten time-to-value.\n",
+      "- Governance & ethics practice: clients need help with model risk, compliance and trustworthy AI—package this as a service.\n",
+      "\n",
+      "4) Talent, organization & operating model (Immediate—Medium)\n",
+      "- Rapid skills triage: identify high-potential consultants to retrain (data engineering, prompt engineering, AI product management, change leadership).\n",
+      "- Training & certification plan (partner with vendors for bootcamps).\n",
+      "- Realign delivery teams from project-centric to product/engagement squads (cross-functional pods with accountability for outcomes).\n",
+      "- Incentives: shift compensation mix to reward subscription revenue, outcomes, client retention and IP reuse.\n",
+      "\n",
+      "5) Partnerships & IP (Medium)\n",
+      "- Form alliances with 2–3 technology vendors (cloud providers, LLM/AI platforms, specialized vertical AI vendors). Get partner enablement, co-marketing, and preferential pricing.\n",
+      "- Acquire or license vertical datasets or micro-IP where possible.\n",
+      "- Consider small bolt-on acquisitions (AI product, vertical SaaS, specialized data engineering shop) if capital allows.\n",
+      "\n",
+      "Phase-based roadmap\n",
+      "\n",
+      "Phase 1 — Stabilize (0–3 months)\n",
+      "- Actions: client triage & outreach; freeze non-essential hiring; quick Win PoV offers; pricing concessions tied to pilots; form leadership turnaround team.\n",
+      "- Deliverables: list of at-risk clients, 10–15 PoV offers, immediate cost savings plan, CoE charter.\n",
+      "- Metrics: churn rate stopped, pipeline stabilized, PoV conversion rate.\n",
+      "\n",
+      "Phase 2 — Rebuild (3–12 months)\n",
+      "- Actions: productize 3–5 service offerings; launch CoE and 2–3 client pilots; retrain top 20% staff; set new sales playbook and marketing (thought leadership on AI + domain).\n",
+      "- Deliverables: packaged offerings, managed services SLAs, partnerships with 1–2 vendors, first recurring contracts.\n",
+      "- Metrics: % revenue from new offerings, MRR from subscriptions, utilization, customer NPS.\n",
+      "\n",
+      "Phase 3 — Scale & Grow (12–36 months)\n",
+      "- Actions: expand vertical specialization, invest in IP (accelerators, data assets), pursue strategic hires or acquisitions, global go-to-market expansion.\n",
+      "- Deliverables: repeatable playbooks, marketplace assets, recognized brand in chosen verticals.\n",
+      "- Metrics: ARR, gross margin increase, client retention LTV, ROI on CoE.\n",
+      "\n",
+      "Go-to-market and pricing\n",
+      "- Messaging: shift from “we do analysis” to “we guarantee X outcome” and “we integrate AI safely into operations.”\n",
+      "- Sales plays: industry-specific AI transformation plays, fast PoV plays, compliance & governance play.\n",
+      "- Pricing: hybrid models — upfront AI assessment + subscription for managed services + outcome-based bonus. Example: 20% upfront, monthly fee, and a success fee tied to agreed KPI uplift.\n",
+      "- Case studies: document PoVs into short case studies for sales enablement.\n",
+      "\n",
+      "Operations & delivery\n",
+      "- Standardize delivery templates and reusable code/modules to lower cost-per-project.\n",
+      "- Implement DevOps and MLOps practices: CI/CD for models, monitoring, retraining schedules.\n",
+      "- Quality & compliance: run model risk assessments and client-facing runbooks for incidents.\n",
+      "\n",
+      "Talent & culture\n",
+      "- Fast-track \"AI Fellows\" program: upskill 5–10 client-facing leaders to become AI-practice leads who can sell PoVs.\n",
+      "- New roles: AI product manager, prompt engineer, ML engineer, data engineer, change lead.\n",
+      "- Cultural change: reward client outcomes and IP reuse; embed learning and experimentation time.\n",
+      "\n",
+      "Partnerships & ecosystem\n",
+      "- Tech partners for infrastructure and models (negotiate go-to-market support).\n",
+      "- Boutique specialists (NLP, computer vision) to augment capacity without heavy hiring.\n",
+      "- Universities / labs for advanced R&D if long-term differentiation desired.\n",
+      "\n",
+      "Financials & investment priority (rules of thumb)\n",
+      "- Prioritize revenue-stabilizing actions first (client retention, PoVs).\n",
+      "- Initial investment range: 3–8% of annual revenue to build CoE, accelerate sales, and run pilots (adjust to cash position).\n",
+      "- Reallocate existing spend: pause low-margin engagements and non-strategic initiatives.\n",
+      "- Track payback: aim for PoV-to-paid-contract conversion in <6 months.\n",
+      "\n",
+      "KPIs & OKRs (examples)\n",
+      "- OKR (90 days): Reduce churn by 40% among top 50 clients. Key results: 50 executive win-back calls completed, 20 PoVs sold.\n",
+      "- OKR (6 months): Launch three productized services with $X MRR. Key results: 3 contracts signed, CoE staffed, 2 published case studies.\n",
+      "- KPIs to monitor: client churn, renewal rate, % revenue from subscriptions, PoV conversion rate, utilization, average deal size, gross margin by offering.\n",
+      "\n",
+      "Risks & mitigations\n",
+      "- Risk: PoVs fail to convert — Mitigate: run very focused PoVs with clear, measurable KPIs and executive buy-in.\n",
+      "- Risk: Talent defection — Mitigate: retain top billers with short-term incentives and clear retraining paths.\n",
+      "- Risk: Cash constraints — Mitigate: prioritize high-ROI, low-capex pilots and use partner credits.\n",
+      "- Risk: Competitive pressure from large players — Mitigate: focus on vertical specialization, regulatory know-how, and trusted client relationships.\n",
+      "\n",
+      "Quick 10-step action checklist (first 30 days)\n",
+      "1. Convene leadership turnaround team and set weekly cadence.\n",
+      "2. Run client churn analysis and list top 50 clients by risk/LTV.\n",
+      "3. Launch executive outreach program for top accounts.\n",
+      "4. Define 5 short PoV packages (2–4 week) with pricing and success metrics.\n",
+      "5. Freeze non-essential hiring; reallocate training budget.\n",
+      "6. Appoint head of AI CoE and hire 2 senior engineers/architects (contract if needed).\n",
+      "7. Negotiate at least one vendor partnership for credits/support.\n",
+      "8. Create sales playbook and one-pager for new AI-enabled offerings.\n",
+      "9. Start retraining plan for 20% of consultants.\n",
+      "10. Set 30/60/90 day KPIs and reporting dashboard.\n",
+      "\n",
+      "Next step\n",
+      "If you want, I can:\n",
+      "- Turn this into a detailed 90-day implementation plan with owners, tasks, and estimated budgets;\n",
+      "- Draft sample PoV packages and pricing;\n",
+      "- Build a client outreach script and slide deck template for executive win-backs.\n",
+      "\n",
+      "Which would you like first, or tell me three specifics about the firm (annual revenue, top verticals, current AI skills) and I’ll tailor the plan.\n"
+     ]
+    }
+   ],
+   "source": [
+    "user_question = \"A mid-sized consulting firm is losing clients due to AI automation. Propose a structured turnaround strategy.\"\n",
+    "\n",
+    "result = route_and_execute(user_question)\n",
+    "\n",
+    "print(\"\\nFinal Answer:\\n\")\n",
+    "print(result)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "agents (3.12.12)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2.ipynb

@@ -0,0 +1,517 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Important point - please read</h2>\n",
+    "            <span style=\"color:#ff7800;\">The way I collaborate with you may be different to other courses you've taken. I prefer not to type code while you watch. Rather, I execute Jupyter Labs, like this, and give you an intuition for what's going on. My suggestion is that you carefully execute this yourself, <b>after</b> watching the lecture. Add print statements to understand what's going on, and then come up with your own variations.<br/><br/>If you have time, I'd love it if you submit a PR for changes in the community_contributions folder - instructions in the resources. Also, if you have a Github account, use this to showcase your variations. Not only is this essential practice, but it demonstrates your skills to others, including perhaps future clients or employers...\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os #allows the code to interact with the operating system\n",
+    "import json #imports Python's JSON library\n",
+    "from dotenv import load_dotenv #allows the code to load the .env file. A .env file must be explicity loaded\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True) #prioritizes the local .env file and will replace existing env variables"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OpenAI API Key exists and begins sk-proj-\n",
+      "Anthropic API Key not set (and this is optional)\n",
+      "Google API Key not set (and this is optional)\n",
+      "DeepSeek API Key not set (and this is optional)\n",
+      "Groq API Key not set (and this is optional)\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "request += \"Answer only with the question, no explanation. I want the question to be related to the cruelty of life\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[{'role': 'user',\n",
+       "  'content': 'Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. Answer only with the question, no explanation.'}]"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "messages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "In a scenario where two intelligent agents with differing ethical frameworks encounter a moral dilemma involving a choice between the greater good and individual rights, how should they navigate their decision-making process, and what factors should they consider to justify their final actions?\n"
+     ]
+    }
+   ],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "\n",
+    "model_name = \"gpt-4o-mini\"\n",
+    "\n",
+    "response = openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "model_name = \"claude-3-7-sonnet-latest\"\n",
+    "\n",
+    "claude = Anthropic()\n",
+    "response = claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "answer = response.content[0].text\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gemini = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "model_name = \"gemini-2.0-flash\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "model_name = \"deepseek-chat\"\n",
+    "\n",
+    "response = deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "groq = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "model_name = \"llama-3.3-70b-versatile\"\n",
+    "\n",
+    "response = groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## For the next cell, we will use Ollama\n",
+    "\n",
+    "Ollama runs a local web service that gives an OpenAI compatible endpoint,  \n",
+    "and runs models locally using high performance C++ code.\n",
+    "\n",
+    "If you don't have Ollama, install it here by visiting https://ollama.com then pressing Download and following the instructions.\n",
+    "\n",
+    "After it's installed, you should be able to visit here: http://localhost:11434 and see the message \"Ollama is running\"\n",
+    "\n",
+    "You might need to restart Cursor (and maybe reboot). Then open a Terminal (control+\\`) and run `ollama serve`\n",
+    "\n",
+    "Useful Ollama commands (run these in the terminal, or with an exclamation mark in this notebook):\n",
+    "\n",
+    "`ollama pull <model_name>` downloads a model locally  \n",
+    "`ollama ls` lists all the models you've downloaded  \n",
+    "`ollama rm <model_name>` deletes the specified model from your downloads"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Super important - ignore me at your peril!</h2>\n",
+    "            <span style=\"color:#ff7800;\">The model called <b>llama3.3</b> is FAR too large for home computers - it's not intended for personal computing and will consume all your resources! Stick with the nicely sized <b>llama3.2</b> or <b>llama3.2:1b</b> and if you want larger, try llama3.1 or smaller variants of Qwen, Gemma, Phi or DeepSeek. See the <A href=\"https://ollama.com/models\">the Ollama models page</a> for a full list of models and sizes.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ollama = OpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "model_name = \"llama3.2\"\n",
+    "\n",
+    "response = ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# So where are we?\n",
+    "\n",
+    "print(competitors)\n",
+    "print(answers)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# It's nice to know how to use \"zip\"\n",
+    "for competitor, answer in zip(competitors, answers):\n",
+    "    print(f\"Competitor: {competitor}\\n\\n{answer}\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's bring this together - note the use of \"enumerate\"\n",
+    "\n",
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(competitors)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Judgement time!\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"o3-mini\",\n",
+    "    messages=judge_messages,\n",
+    ")\n",
+    "results = response.choices[0].message.content\n",
+    "print(results)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "results_dict = json.loads(results)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "for index, result in enumerate(ranks):\n",
+    "    competitor = competitors[int(result)-1]\n",
+    "    print(f\"Rank {index+1}: {competitor}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Which pattern(s) did this use? Try updating this to add another Agentic design pattern.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">These kinds of patterns - to send a task to multiple models, and evaluate results,\n",
+    "            are common where you need to improve the quality of your LLM response. This approach can be universally applied\n",
+    "            to business projects where accuracy is critical.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_Execution_measurement.py

@@ -0,0 +1,401 @@
+import os
+import json
+import asyncio
+import concurrent.futures
+import time
+from typing import Dict, List, Tuple, Optional
+from dotenv import load_dotenv
+from openai import OpenAI
+
+load_dotenv(override=True)
+
+openai = OpenAI()
+competitors = []
+answers = []
+together = ""
+openai_api_key = os.getenv('OPENAI_API_KEY')
+anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')
+google_api_key = os.getenv('GOOGLE_API_KEY')
+deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')
+groq_api_key = os.getenv('GROQ_API_KEY')
+
+models_dict = {
+    'openai': {
+        'model': 'gpt-4o-mini',
+        'api_key': openai_api_key,
+        'base_url': None
+    },
+    'gemini': {
+        'model': 'gemini-2.0-flash',
+        'api_key': google_api_key,
+        'base_url': 'https://generativelanguage.googleapis.com/v1beta/openai/'
+    },
+    'groq': {
+        'model': 'llama-3.3-70b-versatile',
+        'api_key': groq_api_key,
+        'base_url': 'https://api.groq.com/openai/v1'
+    },
+    'ollama': {
+        'model': 'llama3.2',
+        'api_key': 'ollama',
+        'base_url': 'http://localhost:11434/v1'
+    }
+}
+
+def key_checker():
+
+    if openai_api_key:
+        print(f"OpenAI API Key exists and begins {openai_api_key[:8]}")
+    else:
+        print("OpenAI API Key not set")
+        
+    if anthropic_api_key:
+        print(f"Anthropic API Key exists and begins {anthropic_api_key[:7]}")
+    else:
+        print("Anthropic API Key not set (and this is optional)")
+
+    if google_api_key:
+        print(f"Google API Key exists and begins {google_api_key[:2]}")
+    else:
+        print("Google API Key not set (and this is optional)")
+
+    if deepseek_api_key:
+        print(f"DeepSeek API Key exists and begins {deepseek_api_key[:3]}")
+    else:
+        print("DeepSeek API Key not set (and this is optional)")
+
+    if groq_api_key:
+        print(f"Groq API Key exists and begins {groq_api_key[:4]}")
+    else:
+        print("Groq API Key not set (and this is optional)")
+
+def question_prompt_generator():
+    request = "Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. "
+    request += "Answer only with the question, no explanation."
+    messages = [{"role": "user", "content": request}]
+    return messages
+
+def generate_competition_question():
+    """
+    Generate a challenging question for the LLM competition
+    Returns the question text and formatted messages for LLM calls
+    """
+    print("Generating competition question...")
+    question_prompt = question_prompt_generator()
+    question = llm_caller(question_prompt)
+    question_messages = [{"role": "user", "content": question}]
+    print(f"Question: \n{question}")
+    return question, question_messages
+
+def llm_caller(messages):
+    response = openai.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=messages,
+    )
+    return response.choices[0].message.content
+
+def llm_caller_with_model(messages, model_name, api_key, base_url):
+    llm = None
+
+    if base_url:
+        try:
+            llm = OpenAI(api_key=api_key, base_url=base_url)
+        except Exception as e:
+            print(f"Error creating OpenAI client: {e}")
+            return None
+    else:
+        try:
+            llm = OpenAI(api_key=api_key)
+        except Exception as e:
+            print(f"Error creating OpenAI client: {e}")
+            return None
+
+    response = llm.chat.completions.create(model=model_name, messages=messages)
+    return response.choices[0].message.content
+
+def get_single_model_answer(provider: str, details: Dict, question_messages: List[Dict]) -> Tuple[str, Optional[str]]:
+    """
+    Call a single model and return (provider, answer) or (provider, None) if failed.
+    This function is designed to be used with ThreadPoolExecutor.
+    """
+    print(f"Calling model {provider}...")
+    try:
+        answer = llm_caller_with_model(question_messages, details['model'], details['api_key'], details['base_url'])
+        print(f"Model {provider} was successfully called!")
+        return provider, answer
+    except Exception as e:
+        print(f"Model {provider} failed to call: {e}")
+        return provider, None
+
+def get_models_answers(question_messages):
+    """
+    Sequential version - kept for backward compatibility
+    """
+    for provider, details in models_dict.items():
+        print(f"Calling model {provider}...")
+        try:
+            answer = llm_caller_with_model(question_messages, details['model'], details['api_key'], details['base_url'])
+            print(f"Model {provider} was successful called!")
+        except Exception as e:
+            print(f"Model {provider} failed to call: {e}")
+            continue
+        competitors.append(provider)
+        answers.append(answer)
+
+def get_models_answers_parallel(question_messages, max_workers: int = 4):
+    """
+    Parallel version - calls all models simultaneously using ThreadPoolExecutor
+    """
+    print("Starting parallel execution of all models...")
+    
+    # Clear previous results
+    competitors.clear()
+    answers.clear()
+    
+    # Use ThreadPoolExecutor for parallel execution
+    with concurrent.futures.ThreadPoolExecutor(max_workers=max_workers) as executor:
+        # Submit all tasks
+        future_to_provider = {
+            executor.submit(get_single_model_answer, provider, details, question_messages): provider 
+            for provider, details in models_dict.items()
+        }
+        
+        # Collect results as they complete
+        for future in concurrent.futures.as_completed(future_to_provider):
+            provider, answer = future.result()
+            if answer is not None:  # Only add successful calls
+                competitors.append(provider)
+                answers.append(answer)
+    
+    print(f"Parallel execution completed. {len(competitors)} models responded successfully.")
+
+async def get_single_model_answer_async(provider: str, details: Dict, question_messages: List[Dict]) -> Tuple[str, Optional[str]]:
+    """
+    Async version of single model call - for even better performance
+    """
+    print(f"Calling model {provider} (async)...")
+    try:
+        # Run the synchronous call in a thread pool
+        loop = asyncio.get_event_loop()
+        answer = await loop.run_in_executor(
+            None, 
+            llm_caller_with_model, 
+            question_messages, 
+            details['model'], 
+            details['api_key'], 
+            details['base_url']
+        )
+        print(f"Model {provider} was successfully called!")
+        return provider, answer
+    except Exception as e:
+        print(f"Model {provider} failed to call: {e}")
+        return provider, None
+
+async def get_models_answers_async(question_messages):
+    """
+    Async version - calls all models simultaneously using asyncio
+    """
+    print("Starting async execution of all models...")
+    
+    # Clear previous results
+    competitors.clear()
+    answers.clear()
+    
+    # Create tasks for all models
+    tasks = [
+        get_single_model_answer_async(provider, details, question_messages)
+        for provider, details in models_dict.items()
+    ]
+    
+    # Wait for all tasks to complete
+    results = await asyncio.gather(*tasks, return_exceptions=True)
+    
+    # Process results
+    for result in results:
+        if isinstance(result, Exception):
+            print(f"Task failed with exception: {result}")
+            continue
+        provider, answer = result
+        if answer is not None:  # Only add successful calls
+            competitors.append(provider)
+            answers.append(answer)
+    
+    print(f"Async execution completed. {len(competitors)} models responded successfully.")
+
+def together_maker(answers):
+    together = ""
+    for index, answer in enumerate(answers):
+        together += f"# Response from competitor {index+1}\n\n"
+        together += answer + "\n\n"    
+    return together
+
+def judge_prompt_generator(competitors, question, together):
+    judge = f"""You are judging a competition between {len(competitors)} competitors.
+    Each model has been given this question:
+
+    {question}
+
+    Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.
+    Respond with JSON, and only JSON, with the following format:
+    {{"results": ["best competitor number", "second best competitor number", "third best competitor number", ...]}}
+
+    Here are the responses from each competitor:
+
+    {together}
+
+    Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks."""
+    return judge
+
+def judge_caller(judge_prompt, competitors):
+    print(f"Calling judge...")
+    judge_messages = [{"role": "user", "content": judge_prompt}]
+    results = llm_caller_with_model(judge_messages, "o3-mini", openai_api_key, None)
+    results_dict = json.loads(results)
+    ranks = results_dict["results"]
+    for index, result in enumerate(ranks):
+        competitor = competitors[int(result)-1]
+        print(f"Rank {index+1}: {competitor}")
+    return ranks
+
+def compare_execution_methods(question_messages, runs_per_method=1):
+    """
+    Compare performance of different execution methods
+    """
+    methods = ['sequential', 'parallel', 'async']
+    results = {}
+    
+    for method in methods:
+        print(f"\n{'='*50}")
+        print(f"Testing {method} execution method")
+        print(f"{'='*50}")
+        
+        method_times = []
+        
+        for run in range(runs_per_method):
+            print(f"\nRun {run + 1}/{runs_per_method}")
+            
+            # Clear previous results
+            competitors.clear()
+            answers.clear()
+            
+            start_time = time.time()
+            
+            if method == 'sequential':
+                get_models_answers(question_messages)
+            elif method == 'parallel':
+                get_models_answers_parallel(question_messages, max_workers=4)
+            elif method == 'async':
+                asyncio.run(get_models_answers_async(question_messages))
+            
+            execution_time = time.time() - start_time
+            method_times.append(execution_time)
+            print(f"Run {run + 1} completed in {execution_time:.2f} seconds")
+        
+        avg_time = sum(method_times) / len(method_times)
+        results[method] = {
+            'times': method_times,
+            'avg_time': avg_time,
+            'successful_models': len(competitors)
+        }
+        
+        print(f"\n{method.upper()} Results:")
+        print(f"  Average time: {avg_time:.2f} seconds")
+        print(f"  Successful models: {len(competitors)}")
+        print(f"  All times: {[f'{t:.2f}s' for t in method_times]}")
+    
+    # Print comparison summary
+    print(f"\n{'='*60}")
+    print("PERFORMANCE COMPARISON SUMMARY")
+    print(f"{'='*60}")
+    
+    for method, data in results.items():
+        print(f"{method.upper():>12}: {data['avg_time']:>6.2f}s avg, {data['successful_models']} models")
+    
+    # Calculate speedup
+    if 'sequential' in results:
+        seq_time = results['sequential']['avg_time']
+        print(f"\nSpeedup vs Sequential:")
+        for method, data in results.items():
+            if method != 'sequential':
+                speedup = seq_time / data['avg_time']
+                print(f"  {method.upper()}: {speedup:.2f}x faster")
+    
+    return results
+
+def run_llm_competition(question_messages, execution_method, question):
+    """
+    Run the LLM competition with the specified execution method
+    """
+    print(f"\nUsing {execution_method} execution method...")
+    start_time = time.time()
+
+    if execution_method == 'sequential':
+        get_models_answers(question_messages)
+    elif execution_method == 'parallel':
+        get_models_answers_parallel(question_messages, max_workers=4)
+    elif execution_method == 'async':
+        asyncio.run(get_models_answers_async(question_messages))
+    else:
+        raise ValueError(f"Unknown execution method: {execution_method}")
+
+    execution_time = time.time() - start_time
+    print(f"Execution completed in {execution_time:.2f} seconds")
+
+    together = together_maker(answers)
+    judge_prompt = judge_prompt_generator(competitors, question, together)
+    judge_caller(judge_prompt, competitors)
+    
+    return execution_time
+
+# Interactive execution method selection
+def get_execution_method():
+    """
+    Prompt user to select execution method
+    """
+    print("\n" + "="*60)
+    print("EXECUTION METHOD SELECTION")
+    print("="*60)
+    print("Choose how to execute the LLM calls:")
+    print("1. Sequential - Call models one after another (original method)")
+    print("2. Parallel   - Call all models simultaneously (recommended)")
+    print("3. Async      - Use async/await for maximum performance")
+    print("4. Compare    - Run all methods and compare performance")
+    print("="*60)
+    
+    while True:
+        try:
+            choice = input("Enter your choice (1-4): ").strip()
+            
+            if choice == '1':
+                return 'sequential'
+            elif choice == '2':
+                return 'parallel'
+            elif choice == '3':
+                return 'async'
+            elif choice == '4':
+                return 'compare'
+            else:
+                print("Invalid choice. Please enter 1, 2, 3, or 4.")
+                continue
+        except KeyboardInterrupt:
+            print("\nExiting...")
+            exit(0)
+        except EOFError:
+            print("\nExiting...")
+            exit(0)
+
+def main():
+    key_checker()
+    
+    # Get user's execution method choice
+    EXECUTION_METHOD = get_execution_method()
+    # Generate the competition question and get the question messages
+    question, question_messages = generate_competition_question()
+
+    if EXECUTION_METHOD == 'compare':
+        print("\nRunning performance comparison...")
+        compare_execution_methods(question_messages, runs_per_method=1)
+    else:
+     run_llm_competition(question_messages, EXECUTION_METHOD, question)
+
+main()

community_contributions/2_lab2_Japyh_Reflection_Pattern.ipynb

@@ -0,0 +1,484 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-5-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "print(question)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "# I've updated this with the latest model, but it can take some time because it likes to think!\n",
+    "# Replace the model with gpt-4.1-mini if you'd prefer not to wait 1-2 mins\n",
+    "\n",
+    "model_name = \"gpt-5-nano\"\n",
+    "\n",
+    "response = openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gemini = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "model_name = \"gemini-2.5-flash\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "model_name = \"gemini-3-flash-preview\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# So where are we?\n",
+    "print(competitors)\n",
+    "print(answers)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# It's nice to know how to use \"zip\"\n",
+    "for competitor, answer in zip(competitors, answers):\n",
+    "    print(f\"Competitor: {competitor}\\n\\n{answer}\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's bring this together - note the use of \"enumerate\"\n",
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(competitors)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Judgement time!\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-5-mini\",\n",
+    "    messages=judge_messages,\n",
+    ")\n",
+    "results = response.choices[0].message.content\n",
+    "print(results)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "results_dict = json.loads(results)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "for index, result in enumerate(ranks):\n",
+    "    competitor = competitors[int(result)-1]\n",
+    "    print(f\"Rank {index+1}: {competitor}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Pattern(s) already used in this notebook\n",
+    "\n",
+    "| Pattern | Where it appears |\n",
+    "|---|---|\n",
+    "| **Multi-Agent Collaboration** | Multiple LLMs (GPT, Gemini Flash, Gemini Pro) independently answer the same question |\n",
+    "| **LLM-as-a-Judge / Orchestration** | A separate GPT instance acts as an orchestrator: it generates the question, collects all responses, then evaluates and ranks them |\n",
+    "\n",
+    "Together these form the **\"parallel generation + judge\"** agentic workflow.\n",
+    "\n",
+    "---\n",
+    "\n",
+    "### New pattern being added below: **Reflection**\n",
+    "\n",
+    "The Reflection pattern adds a *feedback loop*:\n",
+    "1. **Critique** — the judge analyses *why* the worst answer lost\n",
+    "2. **Reflect & Revise** — the losing model sees the critique and rewrites its answer\n",
+    "3. **Re-judge** — the revised answer is compared against the original winner\n",
+    "\n",
+    "This loop can be iterated until quality converges."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# ============================================================\n",
+    "# REFLECTION PATTERN\n",
+    "# ============================================================\n",
+    "# Pattern summary:\n",
+    "#   1. CRITIQUE   — Ask the judge WHY the last-place competitor lost\n",
+    "#                   and what specifically was weak in its response.\n",
+    "#   2. REFLECT    — Feed that critique back to the losing competitor\n",
+    "#                   so it can revise its answer.\n",
+    "#   3. RE-JUDGE   — Compare the revised answer against the original\n",
+    "#                   winner to see whether quality improved.\n",
+    "#\n",
+    "# This closes the \"generate → evaluate → improve\" loop, which is\n",
+    "# the defining characteristic of the Reflection agentic pattern.\n",
+    "# ============================================================\n",
+    "\n",
+    "import json\n",
+    "from openai import OpenAI\n",
+    "\n",
+    "openai_client = OpenAI()\n",
+    "\n",
+    "# ----------------------------------------------------------\n",
+    "# Step 0: Identify the loser from the previous judge ranking\n",
+    "# ----------------------------------------------------------\n",
+    "# 'ranks'       — list of competitor numbers ordered best→worst (from previous cells)\n",
+    "# 'competitors' — list of model names in the same positional order\n",
+    "# 'answers'     — list of model answers in the same positional order\n",
+    "# 'question'    — the original question every competitor answered\n",
+    "\n",
+    "# The last element in `ranks` is the worst-ranked competitor number (1-based string)\n",
+    "loser_rank_number = ranks[-1]                              # e.g. \"3\"\n",
+    "loser_index       = int(loser_rank_number) - 1            # convert to 0-based index\n",
+    "loser_model       = competitors[loser_index]\n",
+    "loser_answer      = answers[loser_index]\n",
+    "\n",
+    "winner_rank_number = ranks[0]\n",
+    "winner_index       = int(winner_rank_number) - 1\n",
+    "winner_model       = competitors[winner_index]\n",
+    "winner_answer      = answers[winner_index]\n",
+    "\n",
+    "print(f\"Winner : {winner_model}\")\n",
+    "print(f\"Loser  : {loser_model}\")\n",
+    "\n",
+    "# ----------------------------------------------------------\n",
+    "# Step 1: CRITIQUE — ask the judge to explain the loser's flaws\n",
+    "# ----------------------------------------------------------\n",
+    "critique_prompt = f\"\"\"You previously judged responses to this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "The weakest response was from Competitor {loser_rank_number}:\n",
+    "\n",
+    "{loser_answer}\n",
+    "\n",
+    "Please provide specific, constructive critique. Explain exactly what was unclear,\n",
+    "missing, or logically weak. Be direct so the model can act on your feedback.\"\"\"\n",
+    "\n",
+    "critique_messages = [{\"role\": \"user\", \"content\": critique_prompt}]\n",
+    "\n",
+    "critique_response = openai_client.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",          # Judge model — can use any capable LLM\n",
+    "    messages=critique_messages,\n",
+    ")\n",
+    "critique = critique_response.choices[0].message.content\n",
+    "print(\"\\n--- CRITIQUE ---\\n\", critique)\n",
+    "\n",
+    "# ----------------------------------------------------------\n",
+    "# Step 2: REFLECT — send the critique back to the losing model\n",
+    "# so it can revise its answer (Reflection loop)\n",
+    "# ----------------------------------------------------------\n",
+    "# We re-use whichever client matches the losing competitor.\n",
+    "# For simplicity we route through the gemini client if it is a\n",
+    "# Gemini model, otherwise fall back to the OpenAI-compatible client.\n",
+    "\n",
+    "if \"gemini\" in loser_model.lower():\n",
+    "    reflect_client = OpenAI(\n",
+    "        api_key=google_api_key,\n",
+    "        base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\",\n",
+    "    )\n",
+    "else:\n",
+    "    reflect_client = openai_client          # Works for any OpenAI model\n",
+    "\n",
+    "reflect_prompt = f\"\"\"You previously answered this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your original answer was:\n",
+    "\n",
+    "{loser_answer}\n",
+    "\n",
+    "A judge reviewed your answer and gave the following critique:\n",
+    "\n",
+    "{critique}\n",
+    "\n",
+    "Please reflect on this critique and write an improved answer.\n",
+    "Focus on addressing every point raised.\"\"\"\n",
+    "\n",
+    "reflect_messages = [{\"role\": \"user\", \"content\": reflect_prompt}]\n",
+    "\n",
+    "reflect_response = reflect_client.chat.completions.create(\n",
+    "    model=loser_model,             # Same model attempts to self-improve\n",
+    "    messages=reflect_messages,\n",
+    ")\n",
+    "revised_answer = reflect_response.choices[0].message.content\n",
+    "print(\"\\n--- REVISED ANSWER ---\\n\", revised_answer)\n",
+    "\n",
+    "# ----------------------------------------------------------\n",
+    "# Step 3: RE-JUDGE — compare the revised answer against the\n",
+    "# original winner to see whether the Reflection loop helped\n",
+    "# ----------------------------------------------------------\n",
+    "rejudge_prompt = f\"\"\"You are evaluating two responses to this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Response A (original winner, from {winner_model}):\n",
+    "{winner_answer}\n",
+    "\n",
+    "Response B (revised answer, from {loser_model} after reflection):\n",
+    "{revised_answer}\n",
+    "\n",
+    "Evaluate which response is better: clearer, more accurate, and more insightful.\n",
+    "Respond with JSON only, in this format:\n",
+    "{{\"winner\": \"A or B\", \"reason\": \"one sentence explanation\"}}\"\"\"\n",
+    "\n",
+    "rejudge_messages = [{\"role\": \"user\", \"content\": rejudge_prompt}]\n",
+    "\n",
+    "rejudge_response = openai_client.chat.completions.create(\n",
+    "    model=\"gpt-4.1-mini\",\n",
+    "    messages=rejudge_messages,\n",
+    ")\n",
+    "rejudge_result = json.loads(rejudge_response.choices[0].message.content)\n",
+    "\n",
+    "print(\"\\n--- RE-JUDGE RESULT ---\")\n",
+    "print(f\"Winner after Reflection loop: Response {rejudge_result['winner']}\")\n",
+    "print(f\"Reason: {rejudge_result['reason']}\")\n",
+    "\n",
+    "if rejudge_result[\"winner\"] == \"B\":\n",
+    "    print(f\"\\n✓ Reflection worked — {loser_model} improved enough to beat {winner_model}!\")\n",
+    "else:\n",
+    "    print(f\"\\n✗ Reflection did not flip the result — {winner_model} still leads.\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "agents",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_Mohan_M.ipynb

@@ -0,0 +1,492 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Important point - please read</h2>\n",
+    "            <span style=\"color:#ff7800;\">The way I collaborate with you may be different to other courses you've taken. I prefer not to type code while you watch. Rather, I execute Jupyter Labs, like this, and give you an intuition for what's going on. My suggestion is that you carefully execute this yourself, <b>after</b> watching the lecture. Add print statements to understand what's going on, and then come up with your own variations.<br/><br/>If you have time, I'd love it if you submit a PR for changes in the community_contributions folder - instructions in the resources. Also, if you have a Github account, use this to showcase your variations. Not only is this essential practice, but it demonstrates your skills to others, including perhaps future clients or employers...\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-5-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Note - update since the videos\n",
+    "\n",
+    "I've updated the model names to use the latest models below, like GPT 5 and Claude Sonnet 4.5. It's worth noting that these models can be quite slow - like 1-2 minutes - but they do a great job! Feel free to switch them for faster models if you'd prefer, like the ones I use in the video."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "# I've updated this with the latest model, but it can take some time because it likes to think!\n",
+    "# Replace the model with gpt-4.1-mini if you'd prefer not to wait 1-2 mins\n",
+    "\n",
+    "model_name = \"gpt-5-nano\"\n",
+    "\n",
+    "response = openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "model_name = \"claude-sonnet-4-5\"\n",
+    "\n",
+    "claude = Anthropic()\n",
+    "response = claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "answer = response.content[0].text\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gemini = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "model_name = \"gemini-2.5-flash\"\n",
+    "\n",
+    "response = gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "model_name = \"deepseek-chat\"\n",
+    "\n",
+    "response = deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Updated with the latest Open Source model from OpenAI\n",
+    "\n",
+    "groq = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "model_name = \"openai/gpt-oss-120b\"\n",
+    "\n",
+    "response = groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## For the next cell, we will use Ollama\n",
+    "\n",
+    "Ollama runs a local web service that gives an OpenAI compatible endpoint,  \n",
+    "and runs models locally using high performance C++ code.\n",
+    "\n",
+    "If you don't have Ollama, install it here by visiting https://ollama.com then pressing Download and following the instructions.\n",
+    "\n",
+    "After it's installed, you should be able to visit here: http://localhost:11434 and see the message \"Ollama is running\"\n",
+    "\n",
+    "You might need to restart Cursor (and maybe reboot). Then open a Terminal (control+\\`) and run `ollama serve`\n",
+    "\n",
+    "Useful Ollama commands (run these in the terminal, or with an exclamation mark in this notebook):\n",
+    "\n",
+    "`ollama pull <model_name>` downloads a model locally  \n",
+    "`ollama ls` lists all the models you've downloaded  \n",
+    "`ollama rm <model_name>` deletes the specified model from your downloads"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Super important - ignore me at your peril!</h2>\n",
+    "            <span style=\"color:#ff7800;\">The model called <b>llama3.3</b> is FAR too large for home computers - it's not intended for personal computing and will consume all your resources! Stick with the nicely sized <b>llama3.2</b> or <b>llama3.2:1b</b> and if you want larger, try llama3.1 or smaller variants of Qwen, Gemma, Phi or DeepSeek. See the <A href=\"https://ollama.com/models\">the Ollama models page</a> for a full list of models and sizes.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ollama = OpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "model_name = \"llama3.2\"\n",
+    "\n",
+    "response = ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(answer))\n",
+    "competitors.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# So where are we?\n",
+    "\n",
+    "print(competitors)\n",
+    "print(answers)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# It's nice to know how to use \"zip\"\n",
+    "for competitor, answer in zip(competitors, answers):\n",
+    "    print(f\"Competitor: {competitor}\\n\\n{answer}\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Let's bring this together - note the use of \"enumerate\"\n",
+    "\n",
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from competitor {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(together)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(competitors)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors, nothing else. Do not include markdown formatting or code blocks.\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Judgement time!\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-5-mini\",\n",
+    "    messages=judge_messages,\n",
+    ")\n",
+    "results = response.choices[0].message.content\n",
+    "print(results)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "results_dict = json.loads(results)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "for index, result in enumerate(ranks):\n",
+    "    competitor = competitors[int(result)-1]\n",
+    "    print(f\"Rank {index+1}: {competitor}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Which pattern(s) did this use? Try updating this to add another Agentic design pattern.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">These kinds of patterns - to send a task to multiple models, and evaluate results,\n",
+    "            are common where you need to improve the quality of your LLM response. This approach can be universally applied\n",
+    "            to business projects where accuracy is critical.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_ReAct_Pattern.ipynb

@@ -0,0 +1,289 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/stop.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Important point - please read</h2>\n",
+    "            <span style=\"color:#ff7800;\">The way I collaborate with you may be different to other courses you've taken. I prefer not to type code while you watch. Rather, I execute Jupyter Labs, like this, and give you an intuition for what's going on. My suggestion is that you carefully execute this yourself, <b>after</b> watching the lecture. Add print statements to understand what's going on, and then come up with your own variations.<br/><br/>If you have time, I'd love it if you submit a PR for changes in the community_contributions folder - instructions in the resources. Also, if you have a Github account, use this to showcase your variations. Not only is this essential practice, but it demonstrates your skills to others, including perhaps future clients or employers...\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Which pattern(s) did this use? Try updating this to add another Agentic design pattern.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# ReAct Pattern"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import openai\n",
+    "import os\n",
+    "from dotenv import load_dotenv\n",
+    "import io\n",
+    "from anthropic import Anthropic\n",
+    "from IPython.display import Markdown, display"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "anthropic_api_key = os.getenv('ANTHROPIC_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "deepseek_api_key = os.getenv('DEEPSEEK_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "    \n",
+    "if anthropic_api_key:\n",
+    "    print(f\"Anthropic API Key exists and begins {anthropic_api_key[:7]}\")\n",
+    "else:\n",
+    "    print(\"Anthropic API Key not set (and this is optional)\")\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if deepseek_api_key:\n",
+    "    print(f\"DeepSeek API Key exists and begins {deepseek_api_key[:3]}\")\n",
+    "else:\n",
+    "    print(\"DeepSeek API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 50,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "from openai import OpenAI\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "\n",
+    "# Request prompt\n",
+    "request = (\n",
+    "    \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "    \"Answer only with the question, no explanation.\"\n",
+    ")\n",
+    "\n",
+    "\n",
+    "\n",
+    "def generate_question(prompt: str) -> str:\n",
+    "    response = openai.chat.completions.create(\n",
+    "        model='gpt-4o-mini',\n",
+    "        messages=[{'role': 'user', 'content': prompt}]\n",
+    "    )\n",
+    "    question = response.choices[0].message.content\n",
+    "    return question\n",
+    "\n",
+    "def react_agent_decide_model(question: str) -> str:\n",
+    "    prompt = f\"\"\"\n",
+    "            You are an intelligent AI assistant tasked with evaluating which language model is most suitable to answer a given question.\n",
+    "\n",
+    "            Available models:\n",
+    "            - OpenAI: excels at reasoning and factual answers.\n",
+    "            - Claude: better for philosophical, nuanced, and ethical topics.\n",
+    "            - Gemini: good for concise and structured summaries.\n",
+    "            - Groq: good for creative or exploratory tasks.\n",
+    "            - DeepSeek: strong at coding, technical reasoning, and multilingual responses.\n",
+    "\n",
+    "            Here is the question to answer:\n",
+    "            \"{question}\"\n",
+    "\n",
+    "            ### Thought:\n",
+    "            Which model is best suited to answer this question, and why?\n",
+    "\n",
+    "            ### Action:\n",
+    "            Respond with only the model name you choose (e.g., \"Claude\").\n",
+    "                \"\"\"\n",
+    "\n",
+    "    response = openai.chat.completions.create(\n",
+    "        model=\"o3-mini\",\n",
+    "        messages=[{\"role\": \"user\", \"content\": prompt}]\n",
+    "    )\n",
+    "    model = response.choices[0].message.content.strip()\n",
+    "    return model\n",
+    "\n",
+    "def generate_answer_openai(prompt):\n",
+    "    answer = openai.chat.completions.create(\n",
+    "            model='gpt-4o-mini',\n",
+    "            messages=[{'role': 'user', 'content': prompt}]\n",
+    "        ).choices[0].message.content\n",
+    "    return answer\n",
+    "\n",
+    "def generate_answer_anthropic(prompt):\n",
+    "    anthropic = Anthropic(api_key=anthropic_api_key)\n",
+    "    model_name = \"claude-3-5-sonnet-20240620\"\n",
+    "    answer = anthropic.messages.create(\n",
+    "            model=model_name,\n",
+    "            messages=[{'role': 'user', 'content': prompt}],\n",
+    "            max_tokens=1000\n",
+    "        ).content[0].text\n",
+    "    return answer\n",
+    "\n",
+    "def generate_answer_deepseek(prompt):\n",
+    "    deepseek = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "    model_name = \"deepseek-chat\"    \n",
+    "    answer = deepseek.chat.completions.create(\n",
+    "            model=model_name,\n",
+    "            messages=[{'role': 'user', 'content': prompt}],\n",
+    "            base_url='https://api.deepseek.com/v1'\n",
+    "        ).choices[0].message.content\n",
+    "    return answer\n",
+    "\n",
+    "def generate_answer_gemini(prompt):\n",
+    "    gemini=OpenAI(base_url='https://generativelanguage.googleapis.com/v1beta/openai/',api_key=google_api_key)\n",
+    "    model_name = \"gemini-2.0-flash\"\n",
+    "    answer = gemini.chat.completions.create(\n",
+    "            model=model_name,\n",
+    "            messages=[{'role': 'user', 'content': prompt}],\n",
+    "        ).choices[0].message.content\n",
+    "    return answer\n",
+    "\n",
+    "def generate_answer_groq(prompt):\n",
+    "    groq=OpenAI(base_url='https://api.groq.com/openai/v1',api_key=groq_api_key)\n",
+    "    model_name=\"llama3-70b-8192\"\n",
+    "    answer = groq.chat.completions.create(\n",
+    "            model=model_name,\n",
+    "            messages=[{'role': 'user', 'content': prompt}],\n",
+    "            base_url=\"https://api.groq.com/openai/v1\"\n",
+    "        ).choices[0].message.content\n",
+    "    return answer\n",
+    "\n",
+    "def main():\n",
+    "    print(\"Generating question...\")\n",
+    "    question = generate_question(request)\n",
+    "    print(f\"\\n🧠 Question: {question}\\n\")\n",
+    "    selected_model = react_agent_decide_model(question)\n",
+    "    print(f\"\\n🔹 {selected_model}:\\n\")\n",
+    "    \n",
+    "    if selected_model.lower() == \"openai\":\n",
+    "        answer = generate_answer_openai(question)\n",
+    "    elif selected_model.lower() == \"deepseek\":\n",
+    "        answer = generate_answer_deepseek(question)\n",
+    "    elif selected_model.lower() == \"gemini\":\n",
+    "        answer = generate_answer_gemini(question)\n",
+    "    elif selected_model.lower() == \"groq\":\n",
+    "        answer = generate_answer_groq(question)\n",
+    "    elif selected_model.lower() == \"claude\":\n",
+    "        answer = generate_answer_anthropic(question)\n",
+    "    print(f\"\\n🔹 {selected_model}:\\n{answer}\\n\")\n",
+    "    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "main()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">These kinds of patterns - to send a task to multiple models, and evaluate results,\n",
+    "            are common where you need to improve the quality of your LLM response. This approach can be universally applied\n",
+    "            to business projects where accuracy is critical.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_akash_parallelization.ipynb

@@ -0,0 +1,295 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "Today we will work with lots of models! This is a way to get comfortable with APIs."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "\n",
+    "import os\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI, AsyncOpenAI\n",
+    "from IPython.display import Markdown, display\n",
+    "import asyncio\n",
+    "from functools import partial"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Print the key prefixes to help with any debugging\n",
+    "\n",
+    "openai_api_key = os.getenv('OPENAI_API_KEY')\n",
+    "google_api_key = os.getenv('GOOGLE_API_KEY')\n",
+    "groq_api_key = os.getenv('GROQ_API_KEY')\n",
+    "\n",
+    "if openai_api_key:\n",
+    "    print(f\"OpenAI API Key exists and begins {openai_api_key[:8]}\")\n",
+    "else:\n",
+    "    print(\"OpenAI API Key not set\")\n",
+    "\n",
+    "\n",
+    "if google_api_key:\n",
+    "    print(f\"Google API Key exists and begins {google_api_key[:2]}\")\n",
+    "else:\n",
+    "    print(\"Google API Key not set (and this is optional)\")\n",
+    "\n",
+    "if groq_api_key:\n",
+    "    print(f\"Groq API Key exists and begins {groq_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Groq API Key not set (and this is optional)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their intelligence. \"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = AsyncOpenAI()\n",
+    "response = await openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "question = response.choices[0].message.content\n",
+    "print(question)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from dataclasses import dataclass\n",
+    "\n",
+    "@dataclass\n",
+    "class LLMResource:\n",
+    "    api_key: str\n",
+    "    model: str\n",
+    "    url: str = None # optional otherwise NOone\n",
+    "\n",
+    "llm_resources = [\n",
+    "    LLMResource(api_key=openai_api_key, model=\"gpt-4o-mini\"),\n",
+    "    LLMResource(api_key=google_api_key, model=\"gemini-2.5-flash\", url=\"https://generativelanguage.googleapis.com/v1beta/openai/\"),\n",
+    "    LLMResource(api_key=groq_api_key, model=\"qwen/qwen3-32b\", url=\"https://api.groq.com/openai/v1\"),\n",
+    "    LLMResource(api_key=\"ollama\", model=\"deepseek-r1:1.5b\", url=\"http://localhost:11434/v1\" )\n",
+    "]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "\n",
+    "async def llm_call(key, model_name, url, messages) -> tuple:\n",
+    "    if url is None:\n",
+    "        llm = AsyncOpenAI(api_key=key)\n",
+    "    else: \n",
+    "        llm = AsyncOpenAI(base_url=url,api_key=key)\n",
+    "    \n",
+    "    response = await llm.chat.completions.create(\n",
+    "        model=model_name, messages=messages)\n",
+    "    \n",
+    "    answer = (model_name, response.choices[0].message.content)\n",
+    "\n",
+    "    return answer #returns tuple of modle and response from LLM\n",
+    "\n",
+    "llm_callable = partial(llm_call, messages=messages) #prefill with messages\n",
+    "# Always remember to do this!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#gather all responses concurrently\n",
+    "tasks = [llm_callable(res.api_key,res.model,res.url) for res in llm_resources]\n",
+    "results =  await asyncio.gather(*tasks)\n",
+    "together =  [f'Response from competitor {model}:{answer}' for model,answer in results]#gather results once all model finish running\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(llm_resources)} competitors.\n",
+    "Each model has been given this question:\n",
+    "\n",
+    "{request}\n",
+    "\n",
+    "Your job is to evaluate each response for clarity and strength of argument, and rank them in order of best to worst.\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": [\"best competitor number\", \"second best competitor number\", \"third best competitor number\", ...]}}\n",
+    "\n",
+    "Here are the responses from each competitor:\n",
+    "\n",
+    "{together} # all responses\n",
+    "\n",
+    "Now respond with the JSON with the ranked order of the competitors name, nothing else. Do not include markdown formatting or code blocks.\"\"\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Judgement time!\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"o3-mini\",\n",
+    "    messages=judge_messages,\n",
+    ")\n",
+    "results = response.choices[0].message.content\n",
+    "print(results)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "results_dict = json.loads(results)\n",
+    "\n",
+    "ranks = results_dict[\"results\"]\n",
+    "\n",
+    "for index, result in enumerate(ranks):\n",
+    "    print(f\"Rank {index+1}: {result}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/exercise.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#ff7800;\">Exercise</h2>\n",
+    "            <span style=\"color:#ff7800;\">Which pattern(s) did this use? Try updating this to add another Agentic design pattern.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/business.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Commercial implications</h2>\n",
+    "            <span style=\"color:#00bfff;\">These kinds of patterns - to send a task to multiple models, and evaluate results,\n",
+    "            are common where you need to improve the quality of your LLM response. This approach can be universally applied\n",
+    "            to business projects where accuracy is critical.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}