Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,12 @@ 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/ChatBot_with_evaluator_and_notifier/career_db/chroma.sqlite3 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/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/hidden_gems_world_travel_guide/Screenshot1.png 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/seung-gu/me/linkedin.pdf filter=lfs diff=lfs merge=lfs -text

.gradio/certificate.pem

@@ -0,0 +1,31 @@
+-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
+-----END CERTIFICATE-----

1_lab1.ipynb

@@ -0,0 +1,561 @@
+{
+ "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": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "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": 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": 1,
+   "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": 2,
+   "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": 3,
+   "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": 5,
+   "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": 6,
+   "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": 7,
+   "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": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# form a new messages list\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Let's analyze the problem step-by-step:\n",
+      "\n",
+      "- **Given:** 5 machines take 5 minutes to make 5 widgets.\n",
+      "\n",
+      "This means:\n",
+      "\n",
+      "- 5 machines ⇒ 5 widgets in 5 minutes.\n",
+      "- So, 1 machine makes 1 widget in 5 minutes (because the rate is uniform).\n",
+      "\n",
+      "Now, we want to find out:\n",
+      "\n",
+      "- How long would it take **100 machines** to make **100 widgets**?\n",
+      "\n",
+      "Since 1 machine makes 1 widget in 5 minutes, each machine makes widgets at the rate of:\n",
+      "\n",
+      "- 1 widget / 5 minutes = 0.2 widgets per minute.\n",
+      "\n",
+      "With 100 machines working together, the total rate is:\n",
+      "\n",
+      "- 100 machines × 0.2 widgets per minute = 20 widgets per minute.\n",
+      "\n",
+      "To make 100 widgets at this rate:\n",
+      "\n",
+      "- Time = Total widgets / Rate = 100 widgets / 20 widgets per minute = 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": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "Let's analyze the problem step-by-step:\n",
+       "\n",
+       "- **Given:** 5 machines take 5 minutes to make 5 widgets.\n",
+       "\n",
+       "This means:\n",
+       "\n",
+       "- 5 machines ⇒ 5 widgets in 5 minutes.\n",
+       "- So, 1 machine makes 1 widget in 5 minutes (because the rate is uniform).\n",
+       "\n",
+       "Now, we want to find out:\n",
+       "\n",
+       "- How long would it take **100 machines** to make **100 widgets**?\n",
+       "\n",
+       "Since 1 machine makes 1 widget in 5 minutes, each machine makes widgets at the rate of:\n",
+       "\n",
+       "- 1 widget / 5 minutes = 0.2 widgets per minute.\n",
+       "\n",
+       "With 100 machines working together, the total rate is:\n",
+       "\n",
+       "- 100 machines × 0.2 widgets per minute = 20 widgets per minute.\n",
+       "\n",
+       "To make 100 widgets at this rate:\n",
+       "\n",
+       "- Time = Total widgets / Rate = 100 widgets / 20 widgets per minute = 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": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "To create a comprehensive agentic AI solution that effectively addresses the significant pain points outlined in the realm of education, we can develop a multi-faceted platform that leverages cutting-edge AI technologies while prioritizing personalization, data security, integration, assessment quality, educator support, and scalability. Below is a detailed breakdown of the proposed solution:\n",
+      "\n",
+      "### **Agentic AI Learning Ecosystem (AI-LE)**\n",
+      "\n",
+      "**1. Core Features of AI-LE:**\n",
+      "\n",
+      "**a. Personalized Learning Pathways**\n",
+      "- **Adaptive Learning Algorithms**: Utilize machine learning algorithms to continuously assess students' performance and learning styles. AI-LE would deliver personalized content recommendations, adjusting lessons, resources, and assessments in real time to meet individual student needs.\n",
+      "- **Learning Style Assessment**: Incorporate surveys and interactive modules to identify students' learning preferences and adapt educational material accordingly (e.g., videos, readings, hands-on activities).\n",
+      "\n",
+      "**b. Data Privacy and Security**\n",
+      "- **Privacy by Design**: Ensure that all data collection and processing adhere to privacy regulations (like GDPR and COPPA). Implement encryption, anonymization, and secure data storage mechanisms.\n",
+      "- **Transparent Consent Mechanism**: Design user-friendly consent forms where students and parents can easily understand what data is being collected, how it will be used, and their rights regarding data access and deletion.\n",
+      "\n",
+      "**c. Seamless Integration Framework**\n",
+      "- **API Solutions**: Develop robust APIs that allow AI-LE to easily integrate with existing Learning Management Systems (LMS), Student Information Systems (SIS), and other educational tools without disrupting current workflows.\n",
+      "- **Middleware Solutions**: Create middleware that acts as a bridge, enabling the AI-LE ecosystem to communicate with various platforms and databases efficiently.\n",
+      "\n",
+      "**d. Intelligent Assessment and Feedback**\n",
+      "- **Automated Formative Assessments**: Use AI to generate dynamic assessments that adapt based on prior student performance, providing immediate and informative feedback.\n",
+      "- **Bias Detection During Evaluation**: Implement algorithms that analyze assessment data for bias, providing educators with insights into potential discrepancies in evaluation, which can inform instructional improvements.\n",
+      "\n",
+      "**e. Educator Support and Professional Development**\n",
+      "- **Integrated Support Resources**: Provide educators with on-demand access to training modules, pedagogical best practices, and how-to guides on using the AI-LE platform.\n",
+      "- **Community of Practice**: Establish a collaborative space for educators to share experiences, challenges, and strategies for integrating AI-enhanced methodologies into their classrooms.\n",
+      "\n",
+      "**f. Scalability and Resource Optimization**\n",
+      "- **Cloud-Based Infrastructure**: Host the AI-LE on a scalable cloud platform, allowing educational institutions of all sizes to access the technology without significant upfront investments in infrastructure.\n",
+      "- **Tiered Pricing Model**: Offer different pricing tiers based on institutional size and needs, ensuring affordability for smaller educational institutions.\n",
+      "\n",
+      "### **2. Technology Stack**\n",
+      "\n",
+      "- **Machine Learning Frameworks**: Leverage TensorFlow or PyTorch for developing adaptive learning algorithms.\n",
+      "- **Data Security Protocols**: Use best practices like AES encryption and secure multitenancy architecture for data storage and processing.\n",
+      "- **Cloud Services**: Utilize AWS, Google Cloud, or Azure for scalable hosting solutions.\n",
+      "- **Frontend Development**: Employ React or Vue.js for creating an engaging and user-friendly interface for both students and educators.\n",
+      "\n",
+      "### **3. Business Model**\n",
+      "\n",
+      "- **Subscription-Based Access**: Schools pay a subscription fee that includes access to features, support, and updates.\n",
+      "- **Freemium Model**: Offer basic features for free to attract users, with advanced features and support available via paid plans.\n",
+      "- **Professional Development Packages**: Provide optional training workshops and consultation services at additional costs.\n",
+      "\n",
+      "### **4. Potential Partnerships**\n",
+      "\n",
+      "- **EdTech Companies**: Collaborate with existing educational technology firms for integration and joint offerings.\n",
+      "- **Data Privacy Organizations**: Partner with experts in data privacy to ensure compliance and best practices are enforced throughout the platform.\n",
+      "- **Research Institutions**: Work with universities to conduct longitudinal studies on the efficacy of personalized learning through AI.\n",
+      "\n",
+      "### **Conclusion**\n",
+      "\n",
+      "The Agentic AI Learning Ecosystem (AI-LE) aims to revolutionize personalized education by addressing the core pain points associated with agentic AI in learning environments. By providing a comprehensive platform that balances personalization with data security, integration ease, high-quality assessments, and robust educator support, AI-LE is positioned to enhance educational experiences and outcomes at scale. Through a thoughtful business model and strategic partnerships, this solution can ensure sustainability and widespread adoption in the educational sector.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# First create the messages:\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": \"What Agentic AI busienss opportunities can be availed in the field of education?\"}]\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "business_idea = response.choices[0].message.content\n",
+    "\n",
+    "# Then make the first call:\n",
+    "\n",
+    "lines = business_idea.splitlines()\n",
+    "line1 = lines[0]\n",
+    "\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": f\"Please provide a pain point in the field of {line1}\"}]\n",
+    "\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "# Then read the business idea:\n",
+    "\n",
+    "paint_point = 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\"Please provide an agentic ai solution to address {paint_point}\"}]\n",
+    "\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages\n",
+    ")\n",
+    "\n",
+    "solution = response.choices[0].message.content\n",
+    "print(solution)\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.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

3_lab3.ipynb

@@ -0,0 +1,533 @@
+{
+ "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": 1,
+   "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": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "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": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "   \n",
+      "Contact\n",
+      "4083385126 (Mobile)\n",
+      "rohitm02@gmail.com\n",
+      "www.linkedin.com/in/irohitmathur\n",
+      "(LinkedIn)\n",
+      "Top Skills\n",
+      "Business Development\n",
+      "Management\n",
+      "Internet of Things\n",
+      "Honors-Awards\n",
+      "Best BDM Award FY2015-16\n",
+      "Chairman Award FY22\n",
+      "Rohit Mathur\n",
+      "CEO | Ex-Entrepreneur | Empathetic Leader\n",
+      "Dallas-Fort Worth Metroplex\n",
+      "Summary\n",
+      "As CEO of the T.I.D.E Business Unit at Happiest Minds\n",
+      "Technologies, I hold P&amp;L responsibility and oversee the\n",
+      "strategic growth of three key sectors: EduTech, Industrial &amp;\n",
+      "Manufacturing, and HiTech &amp; Media. My leadership is driven by\n",
+      "expertise in business development, management, and a commitment\n",
+      "to advancing innovation in these industries.  With over a decade of\n",
+      "experience, including 7+ years in various senior sales and leadership\n",
+      "roles at Happiest Minds, I have consistently contributed to aligning\n",
+      "sales strategies with organizational goals. My focus remains on\n",
+      "fostering collaborative teams, nurturing client relationships, and\n",
+      "driving sustainable growth in the competitive digital engineering and\n",
+      "technology landscape.\n",
+      "Experience\n",
+      "Happiest Minds Technologies\n",
+      "11 years\n",
+      "CEO T.I.D.E BU\n",
+      "October 2025 - Present (5 months)\n",
+      "Dallas-Fort Worth Metroplex\n",
+      "P&L Responsibility for T.I.D.E BU (Moving Industries Forward) comprising of\n",
+      "EduTech, Industrial & Manufacturing, and HiTech & Media\n",
+      "SVP PDES Global Sales Head\n",
+      "March 2022 - October 2025 (3 years 8 months)\n",
+      "Dallas-Fort Worth Metroplex\n",
+      "Heading Global Sales for PES (Product Engineering Services) and US Sales\n",
+      "for DBS (Digital Business Services)\n",
+      "VP Global Sales Head - Product Engineering Services\n",
+      "April 2018 - March 2022 (4 years)\n",
+      "Austin, Texas Metropolitan Area\n",
+      "Heading US & India Sales for the Product Engineering Services Business Unit.\n",
+      "  Page 1 of 4   \n",
+      "GM & US Sales Head - Product Engineering Services\n",
+      "March 2015 - March 2018 (3 years 1 month)\n",
+      "Austin, Texas Area\n",
+      "L&T Technology Services Limited\n",
+      "Director\n",
+      "November 2014 - March 2015 (5 months)\n",
+      "Austin, Texas Metropolitan Area\n",
+      "Mindtree Ltd.\n",
+      "Senior Director\n",
+      "May 2013 - November 2014 (1 year 7 months)\n",
+      "YAssume & MakeMyDabba.com\n",
+      "Co-Founder & CEO\n",
+      "January 2011 - May 2013 (2 years 5 months)\n",
+      "San Francisco Bay Area\n",
+      "MakeMyDabba is India’s #1 platform for ordering home food online. Order\n",
+      "daily lunch or dinner dabbas from one of our chefs and enjoy tasty, homely\n",
+      "food delivered at your doorstep for free.\n",
+      "YAssume helps salespeople convert prospects to customers through known\n",
+      "relationships. It discovers key relationships by analyzing millions of contacts\n",
+      "points across multiple data sources to get salespeople connected with the right\n",
+      "person fast. Over 15,000 users from Startups and Fortune 500 companies are\n",
+      "already benefiting from the 300,000+ records generated in YAssume.\n",
+      "MindTree\n",
+      "Regional Director\n",
+      "November 2005 - March 2011 (5 years 5 months)\n",
+      "# Connecting prospects who desire to deliver enhanced customer satisfaction\n",
+      "with MindTree's software product engineering services (Sales)\n",
+      "# Bringing new innovations to customers thereby helping them beat\n",
+      "competition with lower cost, better quality, or both (Account Management)\n",
+      "# Generating and sharing new ideas/approaches to move us to the next level\n",
+      "(Being Self!)\n",
+      "Sasken\n",
+      "Alliance manager\n",
+      "  Page 2 of 4   \n",
+      "December 2004 - November 2005 (1 year)\n",
+      "Bangalore Urban, Karnataka, India\n",
+      "I was responsible for handling the partners we worked with for integrating their\n",
+      "software component into the Integrated Solution Framework for mobile phones\n",
+      "that we were building. The partners ranged from small ISVs to established\n",
+      "ones from around the world. The responsibilities included partner selection,\n",
+      "commercial negotiation, contracting and management.\n",
+      "Citibank\n",
+      "Acquisition Manager\n",
+      "May 2004 - December 2004 (8 months)\n",
+      "Bangalore Urban, Karnataka, India\n",
+      "Wipro Infotech Ltd\n",
+      "IIMB - Summer Training\n",
+      "2003 - 2003 (less than a year)\n",
+      "Bangalore Urban, Karnataka, India\n",
+      "Sasken Communication Technologies\n",
+      "Senior Software Engineer\n",
+      "October 2000 - May 2002 (1 year 8 months)\n",
+      "Bangalore Urban, Karnataka, India\n",
+      "C-Dot\n",
+      "Research Engineer\n",
+      "1999 - 2000 (1 year)\n",
+      "Delhi, India\n",
+      "Education\n",
+      "IIM Bangalore\n",
+      "PGDM, Marketing, Strategy · (June 2002 - March 2004)\n",
+      "Punjab Engineering College\n",
+      "Bachelor of Engineering (BE), Electronics and Electrical\n",
+      "Communication · (1995 - 1999)\n",
+      "D.A.V. College, Chandigarh\n",
+      "12th, Non-medical · (1993 - 1995)\n",
+      "Bharatiya Vidya Bhavan's\n",
+      "  Page 3 of 4   \n",
+      " · (1989 - 1993)\n",
+      "  Page 4 of 4\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(linkedin)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with open(\"me/summary.txt\", \"r\", encoding=\"utf-8\") as f:\n",
+    "    summary = f.read()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "name = \"Rohit Mathur\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "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": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "\"You are acting as Rohit Mathur. You are answering questions on Rohit Mathur's website, particularly questions related to Rohit Mathur's career, background, skills and experience. Your responsibility is to represent Rohit Mathur for interactions on the website as faithfully as possible. You are given a summary of Rohit Mathur'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, say so.\\n\\n## Summary:\\nMy name is Ed Donner. I'm an entrepreneur, software engineer and data scientist. I'm originally from London, England, but I moved to NYC in 2000.\\nI love all foods, particularly French food, but strangely I'm repelled by almost all forms of cheese. I'm not allergic, I just hate the taste! I make an exception for cream cheese and mozarella though - cheesecake and pizza are the greatest.\\n\\n## LinkedIn Profile:\\n\\xa0 \\xa0\\nContact\\n4083385126 (Mobile)\\nrohitm02@gmail.com\\nwww.linkedin.com/in/irohitmathur\\n(LinkedIn)\\nTop Skills\\nBusiness Development\\nManagement\\nInternet of Things\\nHonors-Awards\\nBest BDM Award FY2015-16\\nChairman Award FY22\\nRohit Mathur\\nCEO | Ex-Entrepreneur | Empathetic Leader\\nDallas-Fort Worth Metroplex\\nSummary\\nAs CEO of the T.I.D.E Business Unit at Happiest Minds\\nTechnologies, I hold P&amp;L responsibility and oversee the\\nstrategic growth of three key sectors: EduTech, Industrial &amp;\\nManufacturing, and HiTech &amp; Media. My leadership is driven by\\nexpertise in business development, management, and a commitment\\nto advancing innovation in these industries.  With over a decade of\\nexperience, including 7+ years in various senior sales and leadership\\nroles at Happiest Minds, I have consistently contributed to aligning\\nsales strategies with organizational goals. My focus remains on\\nfostering collaborative teams, nurturing client relationships, and\\ndriving sustainable growth in the competitive digital engineering and\\ntechnology landscape.\\nExperience\\nHappiest Minds Technologies\\n11 years\\nCEO T.I.D.E BU\\nOctober 2025\\xa0-\\xa0Present\\xa0(5 months)\\nDallas-Fort Worth Metroplex\\nP&L Responsibility for T.I.D.E BU (Moving Industries Forward) comprising of\\nEduTech, Industrial & Manufacturing, and HiTech & Media\\nSVP PDES Global Sales Head\\nMarch 2022\\xa0-\\xa0October 2025\\xa0(3 years 8 months)\\nDallas-Fort Worth Metroplex\\nHeading Global Sales for PES (Product Engineering Services) and US Sales\\nfor DBS (Digital Business Services)\\nVP Global Sales Head - Product Engineering Services\\nApril 2018\\xa0-\\xa0March 2022\\xa0(4 years)\\nAustin, Texas Metropolitan Area\\nHeading US & India Sales for the Product Engineering Services Business Unit.\\n\\xa0 Page 1 of 4\\xa0 \\xa0\\nGM & US Sales Head - Product Engineering Services\\nMarch 2015\\xa0-\\xa0March 2018\\xa0(3 years 1 month)\\nAustin, Texas Area\\nL&T Technology Services Limited\\nDirector\\nNovember 2014\\xa0-\\xa0March 2015\\xa0(5 months)\\nAustin, Texas Metropolitan Area\\nMindtree Ltd.\\nSenior Director\\nMay 2013\\xa0-\\xa0November 2014\\xa0(1 year 7 months)\\nYAssume & MakeMyDabba.com\\nCo-Founder & CEO\\nJanuary 2011\\xa0-\\xa0May 2013\\xa0(2 years 5 months)\\nSan Francisco Bay Area\\nMakeMyDabba is India’s #1 platform for ordering home food online. Order\\ndaily lunch or dinner dabbas from one of our chefs and enjoy tasty, homely\\nfood delivered at your doorstep for free.\\nYAssume helps salespeople convert prospects to customers through known\\nrelationships. It discovers key relationships by analyzing millions of contacts\\npoints across multiple data sources to get salespeople connected with the right\\nperson fast. Over 15,000 users from Startups and Fortune 500 companies are\\nalready benefiting from the 300,000+ records generated in YAssume.\\nMindTree\\nRegional Director\\nNovember 2005\\xa0-\\xa0March 2011\\xa0(5 years 5 months)\\n# Connecting prospects who desire to deliver enhanced customer satisfaction\\nwith MindTree's software product engineering services (Sales)\\n# Bringing new innovations to customers thereby helping them beat\\ncompetition with lower cost, better quality, or both (Account Management)\\n# Generating and sharing new ideas/approaches to move us to the next level\\n(Being Self!)\\nSasken\\nAlliance manager\\n\\xa0 Page 2 of 4\\xa0 \\xa0\\nDecember 2004\\xa0-\\xa0November 2005\\xa0(1 year)\\nBangalore Urban, Karnataka, India\\nI was responsible for handling the partners we worked with for integrating their\\nsoftware component into the Integrated Solution Framework for mobile phones\\nthat we were building. The partners ranged from small ISVs to established\\nones from around the world. The responsibilities included partner selection,\\ncommercial negotiation, contracting and management.\\nCitibank\\nAcquisition Manager\\nMay 2004\\xa0-\\xa0December 2004\\xa0(8 months)\\nBangalore Urban, Karnataka, India\\nWipro Infotech Ltd\\nIIMB - Summer Training\\n2003\\xa0-\\xa02003\\xa0(less than a year)\\nBangalore Urban, Karnataka, India\\nSasken Communication Technologies\\nSenior Software Engineer\\nOctober 2000\\xa0-\\xa0May 2002\\xa0(1 year 8 months)\\nBangalore Urban, Karnataka, India\\nC-Dot\\nResearch Engineer\\n1999\\xa0-\\xa02000\\xa0(1 year)\\nDelhi, India\\nEducation\\nIIM Bangalore\\nPGDM,\\xa0Marketing, Strategy\\xa0·\\xa0(June 2002\\xa0-\\xa0March 2004)\\nPunjab Engineering College\\nBachelor of Engineering (BE),\\xa0Electronics and Electrical\\nCommunication\\xa0·\\xa0(1995\\xa0-\\xa01999)\\nD.A.V. College, Chandigarh\\n12th,\\xa0Non-medical\\xa0·\\xa0(1993\\xa0-\\xa01995)\\nBharatiya Vidya Bhavan's\\n\\xa0 Page 3 of 4\\xa0 \\xa0\\n\\xa0·\\xa0(1989\\xa0-\\xa01993)\\n\\xa0 Page 4 of 4\\n\\nWith this context, please chat with the user, always staying in character as Rohit Mathur.\""
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "system_prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "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": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "* Running on local URL:  http://127.0.0.1:7862\n",
+      "* To create a public link, set `share=True` in `launch()`.\n"
+     ]
+    },
+    {
+     "data": {
+      "text/html": [
+       "<div><iframe src=\"http://127.0.0.1:7862/\" 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": 12,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "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": 11,
+   "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": 23,
+   "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": 24,
+   "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": 25,
+   "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": 26,
+   "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.0-flash\", messages=messages, response_format=Evaluation)\n",
+    "    return response.choices[0].message.parsed"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "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": 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": 30,
+   "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": 35,
+   "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": [],
+   "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
+}

4_lab4.ipynb

@@ -0,0 +1,450 @@
+{
+ "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",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "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 = \"Ed Donner\""
+   ]
+  },
+  {
+   "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": [
+    "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.12"
+  }
+ },
+ "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
+}

LinkedIn_Articles.txt

@@ -0,0 +1,206 @@
+https://www.linkedin.com/posts/irohitmathur_leadership-valuecreation-customerexperience-activity-7420288090239430656-1nt_?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_happiestminds-fitness-fun-activity-7416213639692574720-qquz?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-focus-growthmindset-activity-7415973073297879040-MML9?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_over-dinner-a-few-weeks-ago-the-kids-started-activity-7409102031686406145-HNSw?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_when-math-met-music-and-ai-stepped-in-activity-7402581316082331650-TLT8?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_fight-flight-or-focus-managing-your-activity-7400391807672573952-2lTL?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_foster-a-culture-of-gratitude-activity-7396319239118209024-WVEa?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_fairness-choices-and-the-lessons-kids-teach-activity-7376438087670947840-xkf5?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_value-of-persistence-and-the-fight-to-save-activity-7372091546634153986-QD30?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_have-you-ever-misread-silence-only-to-later-activity-7360501772957704192-W-uR?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_lawrence-a-bossidy-who-led-a-major-corporate-activity-7359793058898456576-oGN1?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_from-tears-to-triumph-a-lesson-in-letting-activity-7354701247632846848-98Mv?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_sales-artificialintelligence-humanedge-activity-7337640384396726273-cTPd?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-empowerment-initiative-activity-7330798094042693634-aejp?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_emotionalintelligence-mentalhealth-productivity-activity-7329189133396901888-MLkh?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_i-coached-in-the-nfl-for-years-this-is-the-activity-7324270809378627584-hTC1?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-feedback-activity-7316655213291941888-HgMd?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_two-ways-to-boost-performance-we-had-heard-activity-7310469638285365248-lNYh?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_in-skiing-where-champions-pull-up-champions-activity-7307087031497543680-3ldZ?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-indoor-mile-world-record-stood-for-years-activity-7297124152274993152-TPF3?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_how-sales-teams-can-use-gen-ai-to-discover-activity-7296516369838182400-B4Ou?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_changemanagement-adaptability-leadershipdevelopment-activity-7294151119969103875-dFpj?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leaders-shouldnt-try-to-do-it-all-activity-7272477763419185153-VYJl?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-3-cups-of-tea-revisited-many-years-activity-7270203268750815232-8KxP?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-hole-dug-deep-the-ride-was-bumpy-for-activity-7268661732212899840-5OPj?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_no-no-yes-we-were-happy-that-we-got-activity-7265879255438241792-hwD3?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-4-ss-of-presentations-one-of-the-common-activity-7265230033080709121-_8nX?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-speech-the-road-hugged-the-bank-of-the-activity-7243643659160600578-A8fv?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_gestures-of-kindness-are-you-sure-you-really-activity-7235789161461342208-oImK?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-7230612251269808128-D0Vh?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_we-would-have-played-and-gifted-a-teddy-bear-activity-7225530476743028736-Ho64?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-7223544322418262016-CeSK?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-7220464053956005888-jpnD?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-7218474594091814912-CQTV?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_deciding-to-defeat-the-failure-quite-often-activity-7217929894398152704-3uZi?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-magic-mat-the-website-of-the-hotel-showed-activity-7216297520329629696-GyZ6?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-7210852238439645185-Vr-e?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-alphabet-soup-on-the-leaderboard-for-activity-7190455048886276097-BP4v?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_museums-are-becoming-more-expensive-activity-7180357088877981696-__4f?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_dont-let-gen-ai-limit-your-teams-creativity-activity-7167170577349197824-Rrgk?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-13th-dancer-reality-shows-have-been-activity-7166641657965076480-czdR?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_tech-ma-raises-fears-over-software-pricing-activity-7166470277755813888-Egp-?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_why-costco-is-so-loved-activity-7166291290844770304-Zqzj?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.happiestminds.com/blogs/the-importance-of-interest-quotient-nq-in-connecting-the-dots-with-iq-eq/
+https://www.linkedin.com/posts/irohitmathur_it-aint-over-till-its-over-ask-your-activity-7151986233844359168-xSPB?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_motivation-isnt-something-that-you-always-activity-7150314749342138371-oB5R?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-7149971066461786112-wbhZ?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-wonka-activity-7143087870512148480-btbe?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_team-leadership-activity-7131524444392484864-psZR?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_welcome-to-the-final-installment-of-our-series-activity-7106448698741583872--0mb?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-purposedrivenleadership-activity-7105222457103458304-WpSX?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_in-this-second-part-of-our-series-on-the-activity-7103911983359426560-fSMS?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_for-cxos-the-challenge-of-balancing-short-term-activity-7102288813250547712-ibTb?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_as-senior-vice-president-of-global-sales-activity-7101357100647256064-zOMj?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_when-smiles-are-not-miles-deep-the-slight-activity-7099474015093755904-maCZ?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_sales-business-people-activity-7078852561063088128-k3Zh?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_team-culture-happiness-activity-7077791371276783617-SAgK?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_customer-is-always-or-all-ways-right-activity-7050317081921126400-Ew59?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_creativity-productivity-activity-7047990799355035648-8i1p?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-pricey-dragon-fruit-though-it-caught-activity-7044526154036248576-TBEn?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-leaders-activity-7040691718098227200-6GkO?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_grass-will-always-be-greener-on-the-other-activity-7036701670092791808-UfCY?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_opportunity-employment-future-activity-7032755928454098944-6zsE?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_generation-of-new-habits-though-not-surprising-activity-7030219683702214657-C0C0?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_big-ipad-vs-small-ipad-one-of-the-friends-activity-7025173474096668672-ExgC?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_three-words-to-use-for-the-last-few-years-activity-7015528868837036032-hpR3?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_inspiration-creative-activity-7014714130385293312--MqR?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_new-year-resolutions-for-many-this-is-activity-7011516914610962433-peTL?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_people-leadership-activity-7009868307231109120-Lx-_?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_small-boots-on-the-ground-it-is-hard-to-activity-7001580633726603264-SbGW?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_expressing-emotions-tears-rolled-down-the-activity-6999985188814409728-v6Ru?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_mindfulness-leadershipdevelopment-activity-6995245975334248448--Neo?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_diversityandinclusion-activity-6992560272058056704-bPvD?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_virat-and-sunak-thanks-all-those-who-have-activity-6990701353199185920-yX2z?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_growthmindset-leadership-diwali-activity-6990153811017297920-j7Wo?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_growth-power-leadership-activity-6985377573501366272-D8xC?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_learning-leadership-activity-6984558057917755393-Uozn?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_teamwork-leadership-activity-6979295166687825920-92vT?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-team-activity-6972243396585304065-y9oV?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-6969521924557201408-heM4?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_insightful-hbr-article-when-hiring-ceos-activity-6966776452616785920-tzeB?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leaders-leadership-activity-6963985283654569985-glGg?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_1776-activity-6962498431361712129-wYAb?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_when-you-see-that-smile-on-your-face-in-the-activity-6961901494312845312-qzxa?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_wonderful-quote-from-the-sports-legend-bill-activity-6961697429997973504-OTHO?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-team-activity-6960797907474141184-9tFr?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-business-mindfulness-activity-6959366219745431552-HYmM?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_one-person-moves-the-whole-world-moves-activity-6954651071935893504-RNvX?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-6954140686539517952-TXn4?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-team-activity-6951751786307211264-R6uS?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-success-activity-6947261853320318976-GOIF?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_bringing-ironman-back-to-life-the-quest-activity-6946305893965729792-kKJD?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_i-need-hulk-right-now-one-of-the-benefits-activity-6945221157444866048-PU0E?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_running-late-for-flight-it-was-a-short-activity-6944514608627949568-m3kS?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-leaders-activity-6941610342531678210-IH7C?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-point-of-leaving-google-or-yelp-review-activity-6941190084037685248-Iw8M?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leader-team-activity-6928696126820806656-bibS?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_energy-leadershipqualities-activity-6927757831001559040-OuPA?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-ford-and-the-coconut-the-whiff-of-fresh-activity-6921996978285408257-ayFQ?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_storytelling-assumptions-activity-6915496122903920640-8WBr?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_every-night-i-try-myself-by-court-martial-activity-6913340287490699264-GAu7?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-people-activity-6909639465858723840-nfoI?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_sometimes-our-assumption-about-complexity-activity-6903709212208427008-698s?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-6901750620894711808-a4hp?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_theres-no-way-around-hard-work-embrace-activity-6898684121225289728-kRJr?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_al-pacino-any-given-sunday-inch-by-activity-6898417719746662400-OsM_?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_learning-leadership-activity-6898143215464136704-jgVp?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_why-learn-this-skill-after-learning-how-activity-6896597450266701824-qBgM?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_airplane-stays-up-because-it-doesnt-have-activity-6893346747096141824-NXwK?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-mean-master-one-of-the-movies-that-activity-6892251350571331584-nzKF?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-mean-master-one-of-the-movies-that-activity-6892246400554414080-mwAl?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_learning-opportunities-activity-6888493595477852160-ThTf?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_fishing-around-an-old-proverb-which-goes-activity-6887615243879636992--Nwr?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-5th-penny-you-are-walking-down-a-busy-activity-6887253609474605056-ae3g?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_is-my-laptop-heavier-it-was-as-innocuous-activity-6885799690898604032-6knv?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-business-sales-activity-6883095750675447808-HDBj?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_charles-darwin-said-attention-or-conscious-activity-6882884067541553152-Z6UE?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_time-of-the-year-to-renew-it-took-some-courage-activity-6882387779716837376-_9V-?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_storytelling-activity-6882340404524658689-ZuzM?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_on-a-lighter-note-if-you-want-to-be-featured-activity-6882183355534848000-GwXx?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_people-activity-6882179228922707968-t3K-?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leaders-activity-6882004819574431744-Oa6F?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-6881476110924816384-bUl_?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_people-like-gandhi-mandela-lincoln-etc-activity-6881266377894838273-KmSB?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_energy-follows-attention-so-goes-the-wisdom-activity-6881261987981070336-WItV?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leaders-culture-team-activity-6881099697830944768-LRyn?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_finding-the-right-ceo-activity-6878338249169928192-p_e3?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-best-of-celestial-weapons-one-side-activity-6878093171784523776-8H8J?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_strong-language-is-often-used-by-weak-men-activity-6878005364684681217-8gkG?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_what-chanels-new-indian-origin-global-ceo-activity-6876884463431884800-UvB4?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_asked-in-an-interview-in-1902-about-the-desirable-activity-6875492771281678336-o6x8?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_happiestminds-gratitute-leaders-activity-6875449546059730944-R1M0?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_a-road-a-long-road-a-long-paved-road-activity-6872231976649179136-EHyL?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-accidental-discovery-of-plow-fictional-activity-6870401388594167808-N6gz?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_just-felt-like-expressing-thanks-to-the-couple-activity-6869727837746737152-4vr2?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_business-leadershipqualities-activity-6867838592882921472-77l5?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_respect-learning-share-activity-6867285841937539072-RIb5?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershipqualities-activity-6866589108710498305-0Cqi?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_experience-culture-activity-6864799312077996032-c1rH?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_ge-breaks-up-with-its-storied-past-published-activity-6864020003943981056-P6ak?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leaders-people-activity-6861511766766075904-OOBx?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leaders-timingiseverything-activity-6857545303172669440-DX3F?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_pregnant-pauses-i-was-using-a-software-activity-6856364049194631168-F1Wn?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_how-adobe-became-silicon-valleys-quiet-reinventor-activity-6854590576969474048-y3_G?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_well-if-that-numbskull-could-pass-i-know-activity-6854503759171592192-2yxn?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_learning-leaders-email-activity-6852622522198892544-Ml4s?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-6851528610902269952-sbEJ?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershiptips-activity-6851029190016331776-CAg0?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-digital-twin-opportunity-activity-6851003143132655616-4Q43?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_if-we-are-all-in-agreement-on-the-decision-activity-6850448310390591488-JVWb?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-people-activity-6849955615230476288-vwSB?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_coffeetime-conversations-activity-6848822562844143616-Xyb2?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_one-of-the-greatest-discoveries-a-man-makes-activity-6848643241961689088-Hc4w?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershipadvice-emotions-activity-6847903843095764993-nrVm?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_management-is-doing-things-right-leadership-activity-6847422985222053888-pFFB?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershipqualities-activity-6846673128962215936-dWUZ?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_never-ascribe-to-malice-that-which-is-adequately-activity-6846619844952027136-lggc?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_humor-leadershipadvice-activity-6846438586456313856-ZmYS?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_teamofrivals-leadershipadvice-activity-6846299786010800128-hcCk?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_the-speed-of-the-boss-is-the-speed-of-the-activity-6846168724458803200-m7gp?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_it-is-impossible-to-get-the-measure-of-what-activity-6845927439126839296-BLw8?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershipandmanagement-growthculture-leadingchange-activity-6844860363524096000-a4UW?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershipdevelopment-talentmanagement-activity-6843753668433518592-BZ3g?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-management-activity-6843048123892318208-R1_x?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershipdevelopment-activity-6842309464431894528-0QRI?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-goals-motivation-activity-6841562208837652480--L1_?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-people-leader-activity-6841006552132976641-J5jB?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-success-inspiration-activity-6834705118391263232-vdbV?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_believe-it-or-not-in-these-days-lockdown-activity-6832683144978731008-w4hr?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-activity-6832189980085952512-hVdp?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-success-inspiration-activity-6832174141735522304-EJN7?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_innovation-iot-happiestminds-activity-6822691305156620288-9cLy?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershiptalks-activity-6822547592510017536-kWLJ?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_iot-microsoft-happiestminds-activity-6822004048993034240-3BnI?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-happiestminds-empathyatwork-activity-6821848326112124928-ejsH?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-team-success-activity-6811868074753449984-RsIN?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadershipdevelopment-biographies-leadershipskills-activity-6811068049500766208-GbYT?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_humble-request-pls-dont-post-your-political-activity-6809866045201932288-G4he?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-leadershipdevelopment-employeeengagement-activity-6781978598631911424-7DP-?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_your-team-is-the-one-who-delivers-the-results-activity-6764045599449894912-CMG3?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-team-leadershipdevelopment-activity-6747981228022009856-YkXa?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-inspiration-team-activity-6747723151448305664-ETZL?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_work-leadership-management-activity-6747250408978202624-TZAN?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-team-learning-activity-6742166420043415553-ww-s?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+https://www.linkedin.com/posts/irohitmathur_leadership-motivation-mindset-activity-6741874917605744640-VLhF?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAAoKrwBzt79q9K1gZ9eIMsicKMUOnyDJZs
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

README.md

@@ -1,12 +1,6 @@
 ---
-title: Journey Time
-emoji: 📚
-colorFrom: gray
-colorTo: purple
-sdk: gradio
-sdk_version: 6.7.0
+title: journey_time
 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,134 @@
+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 = "Ed Donner"
+        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="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
+    
+
+if __name__ == "__main__":
+    me = Me()
+    gr.ChatInterface(me.chat, type="messages").launch()
+    

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/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_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_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_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.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_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
+}

community_contributions/2_lab2_async.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": "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",
+    "import asyncio\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI, AsyncOpenAI\n",
+    "from anthropic import AsyncAnthropic\n",
+    "from pydantic import BaseModel"
+   ]
+  },
+  {
+   "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": [
+    "print(messages)"
+   ]
+  },
+  {
+   "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": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define Pydantic model for storing LLM results\n",
+    "class LLMResult(BaseModel):\n",
+    "    model: str\n",
+    "    answer: str\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "results: list[LLMResult] = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "async def openai_answer() -> None:\n",
+    "\n",
+    "  if OPENAI_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"OpenAI starting!\")\n",
+    "  model_name = \"gpt-4o-mini\"\n",
+    "\n",
+    "  try:\n",
+    "    response = await openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with OpenAI: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"OpenAI done!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "async def anthropic_answer() -> None:\n",
+    "\n",
+    "  if ANTHROPIC_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"Anthropic starting!\")\n",
+    "  model_name = \"claude-3-7-sonnet-latest\"\n",
+    "\n",
+    "  claude = AsyncAnthropic()\n",
+    "  try:\n",
+    "    response = await claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "    answer = response.content[0].text\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with Anthropic: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"Anthropic done!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def google_answer() -> None:\n",
+    "\n",
+    "  if GOOGLE_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"Google starting!\")\n",
+    "  model_name = \"gemini-2.0-flash\"\n",
+    "\n",
+    "  gemini = AsyncOpenAI(api_key=GOOGLE_API_KEY, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "  try:\n",
+    "    response = await gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer =  response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with Google: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"Google done!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def deepseek_answer() -> None:\n",
+    "\n",
+    "  if DEEPSEEK_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"DeepSeek starting!\")\n",
+    "  model_name = \"deepseek-chat\"\n",
+    "\n",
+    "  deepseek = AsyncOpenAI(api_key=DEEPSEEK_API_KEY, base_url=\"https://api.deepseek.com/v1\")\n",
+    "  try:\n",
+    "    response = await deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with DeepSeek: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"DeepSeek done!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def groq_answer() -> None:\n",
+    "\n",
+    "  if GROQ_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"Groq starting!\")\n",
+    "  model_name = \"llama-3.3-70b-versatile\"\n",
+    "\n",
+    "  groq = AsyncOpenAI(api_key=GROQ_API_KEY, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "  try:\n",
+    "    response = await groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with Groq: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"Groq done!\")\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": 15,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def ollama_answer() -> None:\n",
+    "  model_name = \"llama3.2\"\n",
+    "\n",
+    "  print(\"Ollama starting!\")\n",
+    "  ollama = AsyncOpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "  try:\n",
+    "    response = await ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with Ollama: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"Ollama done!\") "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def gather_answers():\n",
+    "  tasks = [\n",
+    "    openai_answer(),\n",
+    "    anthropic_answer(),\n",
+    "    google_answer(),\n",
+    "    deepseek_answer(),\n",
+    "    groq_answer(),\n",
+    "    ollama_answer()\n",
+    "  ]\n",
+    "  await asyncio.gather(*tasks)\n",
+    "\n",
+    "await gather_answers()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "together = \"\"\n",
+    "competitors = []\n",
+    "answers = []\n",
+    "\n",
+    "for res in results:\n",
+    "    competitor = res.model\n",
+    "    answer = res.answer\n",
+    "    competitors.append(competitor)\n",
+    "    answers.append(answer)\n",
+    "    together += f\"# Response from competitor {competitor}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\"\n",
+    "\n",
+    "print(f\"Number of competitors: {len(results)}\")\n",
+    "print(together)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(results)} 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": 20,
+   "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",
+    "judgement = response.choices[0].message.content\n",
+    "print(judgement)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "results_dict = json.loads(judgement)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "for index, comp in enumerate(ranks):\n",
+    "    print(f\"Rank {index+1}: {comp}\")"
+   ]
+  }
+ ],
+ "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/2_lab2_async_with_reasons.ipynb

@@ -0,0 +1,490 @@
+{
+ "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": [
+    "This was derived from 2_lab2_async. "
+   ]
+  },
+  {
+   "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",
+    "import asyncio\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI, AsyncOpenAI\n",
+    "from anthropic import AsyncAnthropic\n",
+    "from pydantic import BaseModel"
+   ]
+  },
+  {
+   "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": [
+    "print(messages)"
+   ]
+  },
+  {
+   "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": [
+    "# Define Pydantic model for storing LLM results\n",
+    "class LLMResult(BaseModel):\n",
+    "    model: str\n",
+    "    answer: str\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "results: list[LLMResult] = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "async def openai_answer() -> None:\n",
+    "\n",
+    "  if OPENAI_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"OpenAI starting!\")\n",
+    "  model_name = \"gpt-4o-mini\"\n",
+    "\n",
+    "  try:\n",
+    "    response = await openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with OpenAI: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"OpenAI done!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "async def anthropic_answer() -> None:\n",
+    "\n",
+    "  if ANTHROPIC_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"Anthropic starting!\")\n",
+    "  model_name = \"claude-3-7-sonnet-latest\"\n",
+    "\n",
+    "  claude = AsyncAnthropic()\n",
+    "  try:\n",
+    "    response = await claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "    answer = response.content[0].text\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with Anthropic: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"Anthropic done!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def google_answer() -> None:\n",
+    "\n",
+    "  if GOOGLE_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"Google starting!\")\n",
+    "  model_name = \"gemini-2.0-flash\"\n",
+    "\n",
+    "  gemini = AsyncOpenAI(api_key=GOOGLE_API_KEY, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "  try:\n",
+    "    response = await gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer =  response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with Google: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"Google done!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def deepseek_answer() -> None:\n",
+    "\n",
+    "  if DEEPSEEK_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"DeepSeek starting!\")\n",
+    "  model_name = \"deepseek-chat\"\n",
+    "\n",
+    "  deepseek = AsyncOpenAI(api_key=DEEPSEEK_API_KEY, base_url=\"https://api.deepseek.com/v1\")\n",
+    "  try:\n",
+    "    response = await deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with DeepSeek: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"DeepSeek done!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def groq_answer() -> None:\n",
+    "\n",
+    "  if GROQ_API_KEY is None:\n",
+    "    return None\n",
+    "  \n",
+    "  print(\"Groq starting!\")\n",
+    "  model_name = \"llama-3.3-70b-versatile\"\n",
+    "\n",
+    "  groq = AsyncOpenAI(api_key=GROQ_API_KEY, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "  try:\n",
+    "    response = await groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with Groq: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"Groq done!\")\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": [
+    "async def ollama_answer() -> None:\n",
+    "  model_name = \"llama3.2\"\n",
+    "\n",
+    "  print(\"Ollama starting!\")\n",
+    "  ollama = AsyncOpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "  try:\n",
+    "    response = await ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    results.append(LLMResult(model=model_name, answer=answer))\n",
+    "  except Exception as e:\n",
+    "    print(f\"Error with Ollama: {e}\")\n",
+    "    return None\n",
+    "\n",
+    "  print(\"Ollama done!\") "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def gather_answers():\n",
+    "  tasks = [\n",
+    "    openai_answer(),\n",
+    "    anthropic_answer(),\n",
+    "    google_answer(),\n",
+    "    deepseek_answer(),\n",
+    "    groq_answer(),\n",
+    "    ollama_answer()\n",
+    "  ]\n",
+    "  await asyncio.gather(*tasks)\n",
+    "\n",
+    "await gather_answers()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "together = \"\"\n",
+    "competitors = []\n",
+    "answers = []\n",
+    "\n",
+    "for res in results:\n",
+    "    competitor = res.model\n",
+    "    answer = res.answer\n",
+    "    competitors.append(competitor)\n",
+    "    answers.append(answer)\n",
+    "    together += f\"# Response from competitor {competitor}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\"\n",
+    "\n",
+    "print(f\"Number of competitors: {len(results)}\")\n",
+    "print(together)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"You are judging a competition between {len(results)} 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",
+    "\"explanations\": [\"explanation for each rank\", \"explanation for each rank\", \"explanation for each rank\", ...]}}\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=\"o3-mini\",\n",
+    "    messages=judge_messages,\n",
+    ")\n",
+    "judgement = response.choices[0].message.content\n",
+    "print(judgement)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "results_dict = json.loads(judgement)\n",
+    "ranks = results_dict[\"results\"]\n",
+    "explanations = results_dict[\"explanations\"]\n",
+    "for index, comp in enumerate(ranks):\n",
+    "    print(f\"Rank {index+1}: {comp} \\n\\t{explanations[index]}\")"
+   ]
+  },
+  {
+   "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/2_lab2_doclee99_gpt5_improves_gemini.25flash.ipynb

@@ -0,0 +1,620 @@
+{
+ "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-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": [
+    "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": 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)\n",
+    "display(Markdown(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",
+    "\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": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Implement Evaluator-Optimizer workflow design pattern - An Optimizer LLM analyzes the response of the top-ranked competitor\n",
+    "# and creates a system prompt designed to improve the response. The system prompot is then\n",
+    "# sent back to the top-ranked competitor to deliver a new response.  \n",
+    "# The optimizer LLM then compares the new response to the old response and surmises\n",
+    "# what aspects of the system prompt may be responsible for the differences in the responses.\n",
+    "\n",
+    "\n",
+    "\n",
+    "# Get the top competitor (model name) and their response\n",
+    "top_rank_index = int(ranks[0]) - 1\n",
+    "top_competitor_name = competitors[top_rank_index]\n",
+    "top_competitor_response = answers[top_rank_index]\n",
+    "top_competitor_prompt = question\n",
+    "\n",
+    "# Compose a system prompt for GPT-5 to act as an expert evaluator of question quality and answer depth\n",
+    "system_prompt = (\n",
+    "    \"You are an expert evaluator of LLM prompt quality and answer depth. \"\n",
+    "    \"Your task is to analyze the comprehensiveness and depth of thought in the following answer, \"\n",
+    "    \"which was generated by a language model in response to a challenging question. \"\n",
+    "    \"Consider aspects such as completeness, insight, reasoning, and nuance. \"\n",
+    "    \"Provide a detailed analysis of the answer's strengths and weaknesses and store in the 'markdown_analysis' property.\"\n",
+    "    \"Generate a suggested system prompt that will improve the answer and store in the 'system_prompt' property.\"\n",
+    ")\n",
+    "\n",
+    "# Compose the user prompt for GPT-5\n",
+    "user_prompt = (\n",
+    "    f\"Prompt:\\n{top_competitor_prompt}\\n\\n\"\n",
+    "    f\"Answer:\\n{top_competitor_response}\\n\\n\"\n",
+    "    \"Please analyze the comprehensiveness and depth of thought of the above answer. \"\n",
+    "    \"Discuss its strengths and weaknesses in detail.\"\n",
+    ")\n",
+    "\n",
+    "# Call GPT-5 to perform the evaluation\n",
+    "gpt5 = OpenAI()\n",
+    "\n",
+    "# Define the tool schema\n",
+    "tools = [\n",
+    "    {\n",
+    "        \"type\": \"function\",\n",
+    "        \"function\": {\n",
+    "            \"name\": \"markdown_and_structured_data\",\n",
+    "            \"description\": \"Provide both markdown analysis and structured data\",\n",
+    "            \"parameters\": {\n",
+    "                \"type\": \"object\",\n",
+    "                \"properties\": {\n",
+    "                    \"markdown_analysis\": {\n",
+    "                        \"type\": \"string\",\n",
+    "                        \"description\": \"Detailed markdown analysis\"\n",
+    "                    },\n",
+    "                    \"system_prompt\": {\n",
+    "                        \"type\": \"string\"\n",
+    "                    }\n",
+    "                },\n",
+    "                \"required\": [\"markdown_analysis\", \"sentiment\", \"confidence\", \"key_phrases\"]\n",
+    "            }\n",
+    "        }\n",
+    "    }\n",
+    "]\n",
+    "\n",
+    "gpt5_response = gpt5.chat.completions.create(\n",
+    "    model=\"gpt-5\",\n",
+    "    messages=[\n",
+    "        {\"role\": \"system\", \"content\": system_prompt},\n",
+    "        {\"role\": \"user\", \"content\": user_prompt}\n",
+    "    ],\n",
+    "    tools=tools,\n",
+    "    tool_choice={\"type\": \"function\", \"function\": {\"name\": \"markdown_and_structured_data\"}}\n",
+    ")\n",
+    "\n",
+    "tool_call = gpt5_response.choices[0].message.tool_calls[0]\n",
+    "arguments = json.loads(tool_call.function.arguments)\n",
+    "\n",
+    "markdown_analysis = arguments[\"markdown_analysis\"]\n",
+    "system_prompt = arguments[\"system_prompt\"]\n",
+    "\n",
+    "\n",
+    "\n",
+    "\n",
+    "# Display the evaluation\n",
+    "from IPython.display import Markdown, display\n",
+    "display(Markdown(\"### GPT-5 Evaluation of Top Competitor's Answer\"))\n",
+    "display(Markdown(f\"Top Competitor: {top_competitor_name}\"))\n",
+    "display(Markdown(markdown_analysis))\n",
+    "display(Markdown(\"### Suggested System Prompt\"))\n",
+    "display(Markdown(system_prompt))\n",
+    "\n",
+    "\n",
+    "# The top competitor was gemini-2.0-flash, so send the original question and suggested system prompt to generate a new response\n",
+    "# Send the system_prompt and original question to gemini-2.0-flash to generate a new answer\n",
+    "\n",
+    "gemini_response = gemini.chat.completions.create(\n",
+    "    model=\"gemini-2.0-flash\",\n",
+    "    messages=[\n",
+    "        {\"role\": \"system\", \"content\": system_prompt},\n",
+    "        {\"role\": \"user\", \"content\": question}\n",
+    "    ]\n",
+    ")\n",
+    "\n",
+    "new_answer = gemini_response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(\"### Gemini-2.0-Flash New Answer with Suggested System Prompt\"))\n",
+    "display(Markdown(new_answer))\n",
+    "\n",
+    "comparison_prompt = f\"\"\"You are an expert LLM evaluator. Compare the following two answers to the same question, where the only difference is that the second answer was generated using a system prompt suggested by you (GPT-5) after evaluating the first answer.\n",
+    "\n",
+    "Original Answer (from {top_competitor_name}):\n",
+    "{top_competitor_response}\n",
+    "\n",
+    "New Answer (from {top_competitor_name} with your system prompt):\n",
+    "{new_answer}\n",
+    "\n",
+    "System Prompt Used for New Answer:\n",
+    "{system_prompt}\n",
+    "\n",
+    "Please analyze:\n",
+    "- What are the key differences between the two answers?\n",
+    "- What aspects of the system prompt likely contributed to these differences?\n",
+    "- Did the system prompt improve the quality, accuracy, or style of the answer? How?\n",
+    "- Any remaining limitations or further suggestions.\n",
+    "\n",
+    "Provide a detailed, structured analysis.\n",
+    "\"\"\"\n",
+    "\n",
+    "gpt5_comparison_response = gpt5.chat.completions.create(\n",
+    "    model=\"gpt-5\",\n",
+    "    messages=[\n",
+    "        {\"role\": \"system\", \"content\": \"You are an expert LLM evaluator.\"},\n",
+    "        {\"role\": \"user\", \"content\": comparison_prompt}\n",
+    "    ]\n",
+    ")\n",
+    "\n",
+    "comparison_analysis = gpt5_comparison_response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(\"### GPT-5 Analysis: Impact of System Prompt on Gemini-2.0-Flash's Answer\"))\n",
+    "display(Markdown(comparison_analysis))\n",
+    "\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/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.7"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}