Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,6 @@ 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/amirna2_contributions/personal-ai/me/resume.pdf filter=lfs diff=lfs merge=lfs -text
+community_contributions/jongkook/me/Jongkook[[:space:]]Kim[[:space:]]-[[:space:]]Resume.pdf filter=lfs diff=lfs merge=lfs -text

.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,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
+}

2_lab2.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
+}

3_lab3.ipynb

@@ -0,0 +1,819 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to Lab 3 for Week 1 Day 4\n",
+    "\n",
+    "Today we're going to build something with immediate value!\n",
+    "\n",
+    "In the folder `me` I've put a single file `linkedin.pdf` - it's a PDF download of my LinkedIn profile.\n",
+    "\n",
+    "Please replace it with yours!\n",
+    "\n",
+    "I've also made a file called `summary.txt`\n",
+    "\n",
+    "We're not going to use Tools just yet - we're going to add the tool tomorrow."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<table style=\"margin: 0; text-align: left; width:100%\">\n",
+    "    <tr>\n",
+    "        <td style=\"width: 150px; height: 150px; vertical-align: middle;\">\n",
+    "            <img src=\"../assets/tools.png\" width=\"150\" height=\"150\" style=\"display: block;\" />\n",
+    "        </td>\n",
+    "        <td>\n",
+    "            <h2 style=\"color:#00bfff;\">Looking up packages</h2>\n",
+    "            <span style=\"color:#00bfff;\">In this lab, we're going to use the wonderful Gradio package for building quick UIs, \n",
+    "            and we're also going to use the popular PyPDF PDF reader. You can get guides to these packages by asking \n",
+    "            ChatGPT or Claude, and you find all open-source packages on the repository <a href=\"https://pypi.org\">https://pypi.org</a>.\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# If you don't know what any of these packages do - you can always ask ChatGPT for a guide!\n",
+    "\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI\n",
+    "from pypdf import PdfReader\n",
+    "import gradio as gr"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reader = PdfReader(\"me/linkedin.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": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "   \n",
+      "Contact\n",
+      "ed.donner@gmail.com\n",
+      "www.linkedin.com/in/eddonner\n",
+      "(LinkedIn)\n",
+      "edwarddonner.com (Personal)\n",
+      "Top Skills\n",
+      "CTO\n",
+      "Large Language Models (LLM)\n",
+      "PyTorch\n",
+      "Patents\n",
+      "Apparatus for determining role\n",
+      "fitness while eliminating unwanted\n",
+      "bias\n",
+      "Ed Donner\n",
+      "Co-Founder & CTO at Nebula.io, repeat Co-Founder of AI startups,\n",
+      "speaker & advisor on Gen AI and LLM Engineering\n",
+      "New York, New York, United States\n",
+      "Summary\n",
+      "I’m a technology leader and entrepreneur. I'm applying AI to a field\n",
+      "where it can make a massive impact: helping people discover their\n",
+      "potential and pursue their reason for being. But at my core, I’m a\n",
+      "software engineer and a scientist. I learned how to code aged 8 and\n",
+      "still spend weekends experimenting with Large Language Models\n",
+      "and writing code (rather badly). If you’d like to join us to show me\n",
+      "how it’s done.. message me!\n",
+      "As a work-hobby, I absolutely love giving talks about Gen AI and\n",
+      "LLMs. I'm the author of a best-selling, top-rated Udemy course\n",
+      "on LLM Engineering, and I speak at O'Reilly Live Events and\n",
+      "ODSC workshops. It brings me great joy to help others unlock the\n",
+      "astonishing power of LLMs.\n",
+      "I spent most of my career at JPMorgan building software for financial\n",
+      "markets. I worked in London, Tokyo and New York. I became an MD\n",
+      "running a global organization of 300. Then I left to start my own AI\n",
+      "business, untapt, to solve the problem that had plagued me at JPM -\n",
+      "why is so hard to hire engineers?\n",
+      "At untapt we worked with GQR, one of the world's fastest growing\n",
+      "recruitment firms. We collaborated on a patented invention in AI\n",
+      "and talent. Our skills were perfectly complementary - AI leaders vs\n",
+      "recruitment leaders - so much so, that we decided to join forces. In\n",
+      "2020, untapt was acquired by GQR’s parent company and Nebula\n",
+      "was born.\n",
+      "I’m now Co-Founder and CTO for Nebula, responsible for software\n",
+      "engineering and data science.  Our stack is Python/Flask, React,\n",
+      "Mongo, ElasticSearch, with Kubernetes on GCP. Our 'secret sauce'\n",
+      "is our use of Gen AI and proprietary LLMs. If any of this sounds\n",
+      "interesting - we should talk!\n",
+      "  Page 1 of 5   \n",
+      "Experience\n",
+      "Nebula.io\n",
+      "Co-Founder & CTO\n",
+      "June 2021 - Present (3 years 10 months)\n",
+      "New York, New York, United States\n",
+      "I’m the co-founder and CTO of Nebula.io. We help recruiters source,\n",
+      "understand, engage and manage talent, using Generative AI / proprietary\n",
+      "LLMs. Our patented model matches people with roles with greater accuracy\n",
+      "and speed than previously imaginable — no keywords required.\n",
+      "Our long term goal is to help people discover their potential and pursue their\n",
+      "reason for being, motivated by a concept called Ikigai. We help people find\n",
+      "roles where they will be most fulfilled and successful; as a result, we will raise\n",
+      "the level of human prosperity. It sounds grandiose, but since 77% of people\n",
+      "don’t consider themselves inspired or engaged at work, it’s completely within\n",
+      "our reach.\n",
+      "Simplified.Travel\n",
+      "AI Advisor\n",
+      "February 2025 - Present (2 months)\n",
+      "Simplified Travel is empowering destinations to deliver unforgettable, data-\n",
+      "driven journeys at scale.\n",
+      "I'm giving AI advice to enable highly personalized itinerary solutions for DMOs,\n",
+      "hotels and tourism organizations, enhancing traveler experiences.\n",
+      "GQR Global Markets\n",
+      "Chief Technology Officer\n",
+      "January 2020 - Present (5 years 3 months)\n",
+      "New York, New York, United States\n",
+      "As CTO of parent company Wynden Stark, I'm also responsible for innovation\n",
+      "initiatives at GQR.\n",
+      "Wynden Stark\n",
+      "Chief Technology Officer\n",
+      "January 2020 - Present (5 years 3 months)\n",
+      "New York, New York, United States\n",
+      "With the acquisition of untapt, I transitioned to Chief Technology Officer for the\n",
+      "Wynden Stark Group, responsible for Data Science and Engineering.\n",
+      "  Page 2 of 5   \n",
+      "untapt\n",
+      "6 years 4 months\n",
+      "Founder, CTO\n",
+      "May 2019 - January 2020 (9 months)\n",
+      "Greater New York City Area\n",
+      "I founded untapt in October 2013; emerged from stealth in 2014 and went\n",
+      "into production with first product in 2015. In May 2019, I handed over CEO\n",
+      "responsibilities to Gareth Moody, previously the Chief Revenue Officer, shifting\n",
+      "my focus to the technology and product.\n",
+      "Our core invention is an Artificial Neural Network that uses Deep Learning /\n",
+      "NLP to understand the fit between candidates and roles.\n",
+      "Our SaaS products are used in the Recruitment Industry to connect people\n",
+      "with jobs in a highly scalable way. Our products are also used by Corporations\n",
+      "for internal and external hiring at high volume. We have strong SaaS metrics\n",
+      "and trends, and a growing number of bellwether clients.\n",
+      "Our Deep Learning / NLP models are developed in Python using Google\n",
+      "TensorFlow. Our tech stack is React / Redux and Angular HTML5 front-end\n",
+      "with Python / Flask back-end and MongoDB database. We are deployed on\n",
+      "the Google Cloud Platform using Kubernetes container orchestration.\n",
+      "Interview at NASDAQ: https://www.pscp.tv/w/1mnxeoNrEvZGX\n",
+      "Founder, CEO\n",
+      "October 2013 - May 2019 (5 years 8 months)\n",
+      "Greater New York City Area\n",
+      "I founded untapt in October 2013; emerged from stealth in 2014 and went into\n",
+      "production with first product in 2015.\n",
+      "Our core invention is an Artificial Neural Network that uses Deep Learning /\n",
+      "NLP to understand the fit between candidates and roles.\n",
+      "Our SaaS products are used in the Recruitment Industry to connect people\n",
+      "with jobs in a highly scalable way. Our products are also used by Corporations\n",
+      "for internal and external hiring at high volume. We have strong SaaS metrics\n",
+      "and trends, and a growing number of bellwether clients.\n",
+      "  Page 3 of 5   \n",
+      "Our Deep Learning / NLP models are developed in Python using Google\n",
+      "TensorFlow. Our tech stack is React / Redux and Angular HTML5 front-end\n",
+      "with Python / Flask back-end and MongoDB database. We are deployed on\n",
+      "the Google Cloud Platform using Kubernetes container orchestration.\n",
+      "-- Graduate of FinTech Innovation Lab\n",
+      "-- American Banker Top 20 Company To Watch\n",
+      "-- Voted AWS startup most likely to grow exponentially\n",
+      "-- Forbes contributor\n",
+      "More at https://www.untapt.com\n",
+      "Interview at NASDAQ: https://www.pscp.tv/w/1mnxeoNrEvZGX\n",
+      "In Fast Company: https://www.fastcompany.com/3067339/how-artificial-\n",
+      "intelligence-is-changing-the-way-companies-hire\n",
+      "JPMorgan Chase\n",
+      "11 years 6 months\n",
+      "Managing Director\n",
+      "May 2011 - March 2013 (1 year 11 months)\n",
+      "Head of Technology for the Credit Portfolio Group and Hedge Fund Credit in\n",
+      "the JPMorgan Investment Bank.\n",
+      "Led a team of 300 Java and Python software developers across NY, Houston,\n",
+      "London, Glasgow and India. Responsible for counterparty exposure, CVA\n",
+      "and risk management platforms, including simulation engines in Python that\n",
+      "calculate counterparty credit risk for the firm's Derivatives portfolio.\n",
+      "Managed the electronic trading limits initiative, and the Credit Stress program\n",
+      "which calculates risk information under stressed conditions. Jointly responsible\n",
+      "for Market Data and batch infrastructure across Risk.\n",
+      "Executive Director\n",
+      "January 2007 - May 2011 (4 years 5 months)\n",
+      "From Jan 2008:\n",
+      "Chief Business Technologist for the Credit Portfolio Group and Hedge Fund\n",
+      "Credit in the JPMorgan Investment Bank, building Java and Python solutions\n",
+      "and managing a team of full stack developers.\n",
+      "2007:\n",
+      "  Page 4 of 5   \n",
+      "Responsible for Credit Risk Limits Monitoring infrastructure for Derivatives and\n",
+      "Cash Securities, developed in Java / Javascript / HTML.\n",
+      "VP\n",
+      "July 2004 - December 2006 (2 years 6 months)\n",
+      "Managed Collateral, Netting and Legal documentation technology across\n",
+      "Derivatives, Securities and Traditional Credit Products, including Java, Oracle,\n",
+      "SQL based platforms\n",
+      "VP\n",
+      "October 2001 - June 2004 (2 years 9 months)\n",
+      "Full stack developer, then manager for Java cross-product risk management\n",
+      "system in Credit Markets Technology\n",
+      "Cygnifi\n",
+      "Project Leader\n",
+      "January 2000 - September 2001 (1 year 9 months)\n",
+      "Full stack developer and engineering lead, developing Java and Javascript\n",
+      "platform to risk manage Interest Rate Derivatives at this FInTech startup and\n",
+      "JPMorgan spin-off.\n",
+      "JPMorgan\n",
+      "Associate\n",
+      "July 1997 - December 1999 (2 years 6 months)\n",
+      "Full stack developer for Exotic and Flow Interest Rate Derivatives risk\n",
+      "management system in London, New York and Tokyo\n",
+      "IBM\n",
+      "Software Developer\n",
+      "August 1995 - June 1997 (1 year 11 months)\n",
+      "Java and Smalltalk developer with IBM Global Services; taught IBM classes on\n",
+      "Smalltalk and Object Technology in the UK and around Europe\n",
+      "Education\n",
+      "University of Oxford\n",
+      "Physics  · (1992 - 1995)\n",
+      "  Page 5 of 5\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(linkedin)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with open(\"me/summary.txt\", \"r\", encoding=\"utf-8\") as f:\n",
+    "    summary = f.read()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "name = \"Ed Donner\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "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": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "\"You are acting as Ed Donner. You are answering questions on Ed Donner's website, particularly questions related to Ed Donner's career, background, skills and experience. Your responsibility is to represent Ed Donner for interactions on the website as faithfully as possible. You are given a summary of Ed Donner'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\\ned.donner@gmail.com\\nwww.linkedin.com/in/eddonner\\n(LinkedIn)\\nedwarddonner.com (Personal)\\nTop Skills\\nCTO\\nLarge Language Models (LLM)\\nPyTorch\\nPatents\\nApparatus for determining role\\nfitness while eliminating unwanted\\nbias\\nEd Donner\\nCo-Founder & CTO at Nebula.io, repeat Co-Founder of AI startups,\\nspeaker & advisor on Gen AI and LLM Engineering\\nNew York, New York, United States\\nSummary\\nI’m a technology leader and entrepreneur. I'm applying AI to a field\\nwhere it can make a massive impact: helping people discover their\\npotential and pursue their reason for being. But at my core, I’m a\\nsoftware engineer and a scientist. I learned how to code aged 8 and\\nstill spend weekends experimenting with Large Language Models\\nand writing code (rather badly). If you’d like to join us to show me\\nhow it’s done.. message me!\\nAs a work-hobby, I absolutely love giving talks about Gen AI and\\nLLMs. I'm the author of a best-selling, top-rated Udemy course\\non LLM Engineering, and I speak at O'Reilly Live Events and\\nODSC workshops. It brings me great joy to help others unlock the\\nastonishing power of LLMs.\\nI spent most of my career at JPMorgan building software for financial\\nmarkets. I worked in London, Tokyo and New York. I became an MD\\nrunning a global organization of 300. Then I left to start my own AI\\nbusiness, untapt, to solve the problem that had plagued me at JPM -\\nwhy is so hard to hire engineers?\\nAt untapt we worked with GQR, one of the world's fastest growing\\nrecruitment firms. We collaborated on a patented invention in AI\\nand talent. Our skills were perfectly complementary - AI leaders vs\\nrecruitment leaders - so much so, that we decided to join forces. In\\n2020, untapt was acquired by GQR’s parent company and Nebula\\nwas born.\\nI’m now Co-Founder and CTO for Nebula, responsible for software\\nengineering and data science.  Our stack is Python/Flask, React,\\nMongo, ElasticSearch, with Kubernetes on GCP. Our 'secret sauce'\\nis our use of Gen AI and proprietary LLMs. If any of this sounds\\ninteresting - we should talk!\\n\\xa0 Page 1 of 5\\xa0 \\xa0\\nExperience\\nNebula.io\\nCo-Founder & CTO\\nJune 2021\\xa0-\\xa0Present\\xa0(3 years 10 months)\\nNew York, New York, United States\\nI’m the co-founder and CTO of Nebula.io. We help recruiters source,\\nunderstand, engage and manage talent, using Generative AI / proprietary\\nLLMs. Our patented model matches people with roles with greater accuracy\\nand speed than previously imaginable — no keywords required.\\nOur long term goal is to help people discover their potential and pursue their\\nreason for being, motivated by a concept called Ikigai. We help people find\\nroles where they will be most fulfilled and successful; as a result, we will raise\\nthe level of human prosperity. It sounds grandiose, but since 77% of people\\ndon’t consider themselves inspired or engaged at work, it’s completely within\\nour reach.\\nSimplified.Travel\\nAI Advisor\\nFebruary 2025\\xa0-\\xa0Present\\xa0(2 months)\\nSimplified Travel is empowering destinations to deliver unforgettable, data-\\ndriven journeys at scale.\\nI'm giving AI advice to enable highly personalized itinerary solutions for DMOs,\\nhotels and tourism organizations, enhancing traveler experiences.\\nGQR Global Markets\\nChief Technology Officer\\nJanuary 2020\\xa0-\\xa0Present\\xa0(5 years 3 months)\\nNew York, New York, United States\\nAs CTO of parent company Wynden Stark, I'm also responsible for innovation\\ninitiatives at GQR.\\nWynden Stark\\nChief Technology Officer\\nJanuary 2020\\xa0-\\xa0Present\\xa0(5 years 3 months)\\nNew York, New York, United States\\nWith the acquisition of untapt, I transitioned to Chief Technology Officer for the\\nWynden Stark Group, responsible for Data Science and Engineering.\\n\\xa0 Page 2 of 5\\xa0 \\xa0\\nuntapt\\n6 years 4 months\\nFounder, CTO\\nMay 2019\\xa0-\\xa0January 2020\\xa0(9 months)\\nGreater New York City Area\\nI founded untapt in October 2013; emerged from stealth in 2014 and went\\ninto production with first product in 2015. In May 2019, I handed over CEO\\nresponsibilities to Gareth Moody, previously the Chief Revenue Officer, shifting\\nmy focus to the technology and product.\\nOur core invention is an Artificial Neural Network that uses Deep Learning /\\nNLP to understand the fit between candidates and roles.\\nOur SaaS products are used in the Recruitment Industry to connect people\\nwith jobs in a highly scalable way. Our products are also used by Corporations\\nfor internal and external hiring at high volume. We have strong SaaS metrics\\nand trends, and a growing number of bellwether clients.\\nOur Deep Learning / NLP models are developed in Python using Google\\nTensorFlow. Our tech stack is React / Redux and Angular HTML5 front-end\\nwith Python / Flask back-end and MongoDB database. We are deployed on\\nthe Google Cloud Platform using Kubernetes container orchestration.\\nInterview at NASDAQ: https://www.pscp.tv/w/1mnxeoNrEvZGX\\nFounder, CEO\\nOctober 2013\\xa0-\\xa0May 2019\\xa0(5 years 8 months)\\nGreater New York City Area\\nI founded untapt in October 2013; emerged from stealth in 2014 and went into\\nproduction with first product in 2015.\\nOur core invention is an Artificial Neural Network that uses Deep Learning /\\nNLP to understand the fit between candidates and roles.\\nOur SaaS products are used in the Recruitment Industry to connect people\\nwith jobs in a highly scalable way. Our products are also used by Corporations\\nfor internal and external hiring at high volume. We have strong SaaS metrics\\nand trends, and a growing number of bellwether clients.\\n\\xa0 Page 3 of 5\\xa0 \\xa0\\nOur Deep Learning / NLP models are developed in Python using Google\\nTensorFlow. Our tech stack is React / Redux and Angular HTML5 front-end\\nwith Python / Flask back-end and MongoDB database. We are deployed on\\nthe Google Cloud Platform using Kubernetes container orchestration.\\n-- Graduate of FinTech Innovation Lab\\n-- American Banker Top 20 Company To Watch\\n-- Voted AWS startup most likely to grow exponentially\\n-- Forbes contributor\\nMore at https://www.untapt.com\\nInterview at NASDAQ: https://www.pscp.tv/w/1mnxeoNrEvZGX\\nIn Fast Company: https://www.fastcompany.com/3067339/how-artificial-\\nintelligence-is-changing-the-way-companies-hire\\nJPMorgan Chase\\n11 years 6 months\\nManaging Director\\nMay 2011\\xa0-\\xa0March 2013\\xa0(1 year 11 months)\\nHead of Technology for the Credit Portfolio Group and Hedge Fund Credit in\\nthe JPMorgan Investment Bank.\\nLed a team of 300 Java and Python software developers across NY, Houston,\\nLondon, Glasgow and India. Responsible for counterparty exposure, CVA\\nand risk management platforms, including simulation engines in Python that\\ncalculate counterparty credit risk for the firm's Derivatives portfolio.\\nManaged the electronic trading limits initiative, and the Credit Stress program\\nwhich calculates risk information under stressed conditions. Jointly responsible\\nfor Market Data and batch infrastructure across Risk.\\nExecutive Director\\nJanuary 2007\\xa0-\\xa0May 2011\\xa0(4 years 5 months)\\nFrom Jan 2008:\\nChief Business Technologist for the Credit Portfolio Group and Hedge Fund\\nCredit in the JPMorgan Investment Bank, building Java and Python solutions\\nand managing a team of full stack developers.\\n2007:\\n\\xa0 Page 4 of 5\\xa0 \\xa0\\nResponsible for Credit Risk Limits Monitoring infrastructure for Derivatives and\\nCash Securities, developed in Java / Javascript / HTML.\\nVP\\nJuly 2004\\xa0-\\xa0December 2006\\xa0(2 years 6 months)\\nManaged Collateral, Netting and Legal documentation technology across\\nDerivatives, Securities and Traditional Credit Products, including Java, Oracle,\\nSQL based platforms\\nVP\\nOctober 2001\\xa0-\\xa0June 2004\\xa0(2 years 9 months)\\nFull stack developer, then manager for Java cross-product risk management\\nsystem in Credit Markets Technology\\nCygnifi\\nProject Leader\\nJanuary 2000\\xa0-\\xa0September 2001\\xa0(1 year 9 months)\\nFull stack developer and engineering lead, developing Java and Javascript\\nplatform to risk manage Interest Rate Derivatives at this FInTech startup and\\nJPMorgan spin-off.\\nJPMorgan\\nAssociate\\nJuly 1997\\xa0-\\xa0December 1999\\xa0(2 years 6 months)\\nFull stack developer for Exotic and Flow Interest Rate Derivatives risk\\nmanagement system in London, New York and Tokyo\\nIBM\\nSoftware Developer\\nAugust 1995\\xa0-\\xa0June 1997\\xa0(1 year 11 months)\\nJava and Smalltalk developer with IBM Global Services; taught IBM classes on\\nSmalltalk and Object Technology in the UK and around Europe\\nEducation\\nUniversity of Oxford\\nPhysics\\xa0\\xa0·\\xa0(1992\\xa0-\\xa01995)\\n\\xa0 Page 5 of 5\\n\\nWith this context, please chat with the user, always staying in character as Ed Donner.\""
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "system_prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "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": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "* Running on local URL:  http://127.0.0.1:7860\n",
+      "* To create a public link, set `share=True` in `launch()`.\n"
+     ]
+    },
+    {
+     "data": {
+      "text/html": [
+       "<div><iframe src=\"http://127.0.0.1:7860/\" 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": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "share=True\n"
+   ]
+  },
+  {
+   "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": 12,
+   "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": 13,
+   "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": 14,
+   "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": 15,
+   "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": 16,
+   "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": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'Yes, I hold a patent for an invention related to AI and talent acquisition. Specifically, it focuses on an apparatus for determining role fitness while eliminating unwanted bias. This invention was developed during my time at untapt, where we aimed to revolutionize the hiring process by using AI to ensure more accurate and equitable matches between candidates and roles. If you have more questions about the patent or its applications, feel free to ask!'"
+      ]
+     },
+     "execution_count": 17,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "reply"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "ename": "NameError",
+     "evalue": "name 'gemini' is not defined",
+     "output_type": "error",
+     "traceback": [
+      "\u001b[31m---------------------------------------------------------------------------\u001b[39m",
+      "\u001b[31mNameError\u001b[39m                                 Traceback (most recent call last)",
+      "\u001b[36mCell\u001b[39m\u001b[36m \u001b[39m\u001b[32mIn[18]\u001b[39m\u001b[32m, line 1\u001b[39m\n\u001b[32m----> \u001b[39m\u001b[32m1\u001b[39m \u001b[43mevaluate\u001b[49m\u001b[43m(\u001b[49m\u001b[43mreply\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[33;43m\"\u001b[39;49m\u001b[33;43mdo you hold a patent?\u001b[39;49m\u001b[33;43m\"\u001b[39;49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mmessages\u001b[49m\u001b[43m[\u001b[49m\u001b[43m:\u001b[49m\u001b[32;43m1\u001b[39;49m\u001b[43m]\u001b[49m\u001b[43m)\u001b[49m\n",
+      "\u001b[36mCell\u001b[39m\u001b[36m \u001b[39m\u001b[32mIn[15]\u001b[39m\u001b[32m, line 4\u001b[39m, in \u001b[36mevaluate\u001b[39m\u001b[34m(reply, message, history)\u001b[39m\n\u001b[32m      1\u001b[39m \u001b[38;5;28;01mdef\u001b[39;00m\u001b[38;5;250m \u001b[39m\u001b[34mevaluate\u001b[39m(reply, message, history) -> Evaluation:\n\u001b[32m      3\u001b[39m     messages = [{\u001b[33m\"\u001b[39m\u001b[33mrole\u001b[39m\u001b[33m\"\u001b[39m: \u001b[33m\"\u001b[39m\u001b[33msystem\u001b[39m\u001b[33m\"\u001b[39m, \u001b[33m\"\u001b[39m\u001b[33mcontent\u001b[39m\u001b[33m\"\u001b[39m: evaluator_system_prompt}] + [{\u001b[33m\"\u001b[39m\u001b[33mrole\u001b[39m\u001b[33m\"\u001b[39m: \u001b[33m\"\u001b[39m\u001b[33muser\u001b[39m\u001b[33m\"\u001b[39m, \u001b[33m\"\u001b[39m\u001b[33mcontent\u001b[39m\u001b[33m\"\u001b[39m: evaluator_user_prompt(reply, message, history)}]\n\u001b[32m----> \u001b[39m\u001b[32m4\u001b[39m     response = \u001b[43mgemini\u001b[49m.beta.chat.completions.parse(model=\u001b[33m\"\u001b[39m\u001b[33mgemini-2.0-flash\u001b[39m\u001b[33m\"\u001b[39m, messages=messages, response_format=Evaluation)\n\u001b[32m      5\u001b[39m     \u001b[38;5;28;01mreturn\u001b[39;00m response.choices[\u001b[32m0\u001b[39m].message.parsed\n",
+      "\u001b[31mNameError\u001b[39m: name 'gemini' is not defined"
+     ]
+    }
+   ],
+   "source": [
+    "evaluate(reply, \"do you hold a patent?\", messages[:1])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "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": 20,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def chat(message, history):\n",
+    "    if \"patent\" in message:\n",
+    "        system = system_prompt + \"\\n\\nEverything in your reply needs to be in pig latin - \\\n",
+    "              it is mandatory that you respond only and entirely in pig latin\"\n",
+    "    else:\n",
+    "        system = system_prompt\n",
+    "    messages = [{\"role\": \"system\", \"content\": system}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = openai.chat.completions.create(model=\"gpt-4o-mini\", messages=messages)\n",
+    "    reply =response.choices[0].message.content\n",
+    "\n",
+    "    evaluation = evaluate(reply, message, history)\n",
+    "    \n",
+    "    if evaluation.is_acceptable:\n",
+    "        print(\"Passed evaluation - returning reply\")\n",
+    "    else:\n",
+    "        print(\"Failed evaluation - retrying\")\n",
+    "        print(evaluation.feedback)\n",
+    "        reply = rerun(reply, message, history, evaluation.feedback)       \n",
+    "    return reply"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "* Running on local URL:  http://127.0.0.1:7861\n",
+      "* To create a public link, set `share=True` in `launch()`.\n"
+     ]
+    },
+    {
+     "data": {
+      "text/html": [
+       "<div><iframe src=\"http://127.0.0.1:7861/\" 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": 21,
+     "metadata": {},
+     "output_type": "execute_result"
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "Traceback (most recent call last):\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/queueing.py\", line 625, in process_events\n",
+      "    response = await route_utils.call_process_api(\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/route_utils.py\", line 322, in call_process_api\n",
+      "    output = await app.get_blocks().process_api(\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/blocks.py\", line 2220, in process_api\n",
+      "    result = await self.call_function(\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/blocks.py\", line 1729, in call_function\n",
+      "    prediction = await fn(*processed_input)\n",
+      "                 ^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/utils.py\", line 871, in async_wrapper\n",
+      "    response = await f(*args, **kwargs)\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/chat_interface.py\", line 545, in __wrapper\n",
+      "    return await submit_fn(*args, **kwargs)\n",
+      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/chat_interface.py\", line 917, in _submit_fn\n",
+      "    response = await anyio.to_thread.run_sync(\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/to_thread.py\", line 56, in run_sync\n",
+      "    return await get_async_backend().run_sync_in_worker_thread(\n",
+      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 2470, in run_sync_in_worker_thread\n",
+      "    return await future\n",
+      "           ^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 967, in run\n",
+      "    result = context.run(func, *args)\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/var/folders/3c/2tt4z3hj2gs1yqn3v3s0l6vm0000gn/T/ipykernel_9549/2688000405.py\", line 11, in chat\n",
+      "    evaluation = evaluate(reply, message, history)\n",
+      "                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/var/folders/3c/2tt4z3hj2gs1yqn3v3s0l6vm0000gn/T/ipykernel_9549/1409514652.py\", line 4, in evaluate\n",
+      "    response = gemini.beta.chat.completions.parse(model=\"gemini-2.0-flash\", messages=messages, response_format=Evaluation)\n",
+      "               ^^^^^^\n",
+      "NameError: name 'gemini' is not defined\n",
+      "Traceback (most recent call last):\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/queueing.py\", line 625, in process_events\n",
+      "    response = await route_utils.call_process_api(\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/route_utils.py\", line 322, in call_process_api\n",
+      "    output = await app.get_blocks().process_api(\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/blocks.py\", line 2220, in process_api\n",
+      "    result = await self.call_function(\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/blocks.py\", line 1729, in call_function\n",
+      "    prediction = await fn(*processed_input)\n",
+      "                 ^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/utils.py\", line 871, in async_wrapper\n",
+      "    response = await f(*args, **kwargs)\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/chat_interface.py\", line 545, in __wrapper\n",
+      "    return await submit_fn(*args, **kwargs)\n",
+      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/chat_interface.py\", line 917, in _submit_fn\n",
+      "    response = await anyio.to_thread.run_sync(\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/to_thread.py\", line 56, in run_sync\n",
+      "    return await get_async_backend().run_sync_in_worker_thread(\n",
+      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 2470, in run_sync_in_worker_thread\n",
+      "    return await future\n",
+      "           ^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 967, in run\n",
+      "    result = context.run(func, *args)\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/var/folders/3c/2tt4z3hj2gs1yqn3v3s0l6vm0000gn/T/ipykernel_9549/2688000405.py\", line 11, in chat\n",
+      "    evaluation = evaluate(reply, message, history)\n",
+      "                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/var/folders/3c/2tt4z3hj2gs1yqn3v3s0l6vm0000gn/T/ipykernel_9549/1409514652.py\", line 4, in evaluate\n",
+      "    response = gemini.beta.chat.completions.parse(model=\"gemini-2.0-flash\", messages=messages, response_format=Evaluation)\n",
+      "               ^^^^^^\n",
+      "NameError: name 'gemini' is not defined\n",
+      "Traceback (most recent call last):\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/queueing.py\", line 625, in process_events\n",
+      "    response = await route_utils.call_process_api(\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/route_utils.py\", line 322, in call_process_api\n",
+      "    output = await app.get_blocks().process_api(\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/blocks.py\", line 2220, in process_api\n",
+      "    result = await self.call_function(\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/blocks.py\", line 1729, in call_function\n",
+      "    prediction = await fn(*processed_input)\n",
+      "                 ^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/utils.py\", line 871, in async_wrapper\n",
+      "    response = await f(*args, **kwargs)\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/chat_interface.py\", line 545, in __wrapper\n",
+      "    return await submit_fn(*args, **kwargs)\n",
+      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/chat_interface.py\", line 917, in _submit_fn\n",
+      "    response = await anyio.to_thread.run_sync(\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/to_thread.py\", line 56, in run_sync\n",
+      "    return await get_async_backend().run_sync_in_worker_thread(\n",
+      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 2470, in run_sync_in_worker_thread\n",
+      "    return await future\n",
+      "           ^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 967, in run\n",
+      "    result = context.run(func, *args)\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/var/folders/3c/2tt4z3hj2gs1yqn3v3s0l6vm0000gn/T/ipykernel_9549/2688000405.py\", line 11, in chat\n",
+      "    evaluation = evaluate(reply, message, history)\n",
+      "                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/var/folders/3c/2tt4z3hj2gs1yqn3v3s0l6vm0000gn/T/ipykernel_9549/1409514652.py\", line 4, in evaluate\n",
+      "    response = gemini.beta.chat.completions.parse(model=\"gemini-2.0-flash\", messages=messages, response_format=Evaluation)\n",
+      "               ^^^^^^\n",
+      "NameError: name 'gemini' is not defined\n",
+      "Traceback (most recent call last):\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/queueing.py\", line 625, in process_events\n",
+      "    response = await route_utils.call_process_api(\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/route_utils.py\", line 322, in call_process_api\n",
+      "    output = await app.get_blocks().process_api(\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/blocks.py\", line 2220, in process_api\n",
+      "    result = await self.call_function(\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/blocks.py\", line 1729, in call_function\n",
+      "    prediction = await fn(*processed_input)\n",
+      "                 ^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/utils.py\", line 871, in async_wrapper\n",
+      "    response = await f(*args, **kwargs)\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/chat_interface.py\", line 545, in __wrapper\n",
+      "    return await submit_fn(*args, **kwargs)\n",
+      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/gradio/chat_interface.py\", line 917, in _submit_fn\n",
+      "    response = await anyio.to_thread.run_sync(\n",
+      "               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/to_thread.py\", line 56, in run_sync\n",
+      "    return await get_async_backend().run_sync_in_worker_thread(\n",
+      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 2470, in run_sync_in_worker_thread\n",
+      "    return await future\n",
+      "           ^^^^^^^^^^^^\n",
+      "  File \"/Users/kristinazukova/project/agents/.venv/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 967, in run\n",
+      "    result = context.run(func, *args)\n",
+      "             ^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/var/folders/3c/2tt4z3hj2gs1yqn3v3s0l6vm0000gn/T/ipykernel_9549/2688000405.py\", line 11, in chat\n",
+      "    evaluation = evaluate(reply, message, history)\n",
+      "                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
+      "  File \"/var/folders/3c/2tt4z3hj2gs1yqn3v3s0l6vm0000gn/T/ipykernel_9549/1409514652.py\", line 4, in evaluate\n",
+      "    response = gemini.beta.chat.completions.parse(model=\"gemini-2.0-flash\", messages=messages, response_format=Evaluation)\n",
+      "               ^^^^^^\n",
+      "NameError: name 'gemini' is not defined\n"
+     ]
+    }
+   ],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "share=True\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
+}

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` 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.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

README.md

@@ -1,12 +1,6 @@
 ---
-title: About Me
-emoji: 🦀
-colorFrom: indigo
-colorTo: purple
-sdk: gradio
-sdk_version: 5.49.1
+title: about_me
 app_file: app.py
-pinned: false
+sdk: gradio
+sdk_version: 5.34.2
 ---
-
-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 = "Mikhail Zhukov"
+        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_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_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_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_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_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/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-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_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
+}

community_contributions/2_lab2_exercise.ipynb

@@ -0,0 +1,336 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# From Judging to Synthesizing — Evolving Multi-Agent Patterns\n",
+    "\n",
+    "In the original 2_lab2.ipynb, we explored a powerful agentic design pattern: sending the same question to multiple large language models (LLMs), then using a separate “judge” agent to evaluate and rank their responses. This approach is valuable for identifying the single best answer among many, leveraging the strengths of ensemble reasoning and critical evaluation.\n",
+    "\n",
+    "However, selecting just one “winner” can leave valuable insights from other models untapped. To address this, I am shifting to a new agentic pattern in this notebook: the synthesizer/improver pattern. Instead of merely ranking responses, we will prompt a dedicated LLM to review all answers, extract the most compelling ideas from each, and synthesize them into a single, improved response. \n",
+    "\n",
+    "This approach aims to combine the collective intelligence of multiple models, producing an answer that is richer, more nuanced, and more robust than any individual response.\n"
+   ]
+  },
+  {
+   "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)"
+   ]
+  },
+  {
+   "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": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Please come up with a challenging, nuanced question that I can ask a number of LLMs to evaluate their collective 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": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "teammates = []\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",
+    "teammates.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",
+    "teammates.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",
+    "teammates.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",
+    "teammates.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",
+    "teammates.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# So where are we?\n",
+    "\n",
+    "print(teammates)\n",
+    "print(answers)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# It's nice to know how to use \"zip\"\n",
+    "for teammate, answer in zip(teammates, answers):\n",
+    "    print(f\"Teammate: {teammate}\\n\\n{answer}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "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 teammate {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": 36,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "formatter = f\"\"\"You are taking the nost interesting ideas fron  {len(teammates)} teammates.\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, select the most relevant ideas and make a report, including a title, subtitles to separate sections, and quoting the LLM providing the idea.\n",
+    "From that, you will create a new improved answer.\"\"\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(formatter)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 38,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "formatter_messages = [{\"role\": \"user\", \"content\": formatter}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"o3-mini\",\n",
+    "    messages=formatter_messages,\n",
+    ")\n",
+    "results = response.choices[0].message.content\n",
+    "display(Markdown(results))"
+   ]
+  },
+  {
+   "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.7"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_exercise_BrettSanders_ChainOfThought.ipynb

@@ -0,0 +1,241 @@
+{
+ "cells": [
+  {
+   "cell_type": "raw",
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
+   "source": [
+    "# Lab 2 Exercise - Extending the Patterns\n",
+    "\n",
+    "This notebook extends the original lab by adding the Chain of Thought pattern to enhance the evaluation process.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Import required packages\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\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Load environment variables\n",
+    "load_dotenv(override=True)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Initialize API clients\n",
+    "openai = OpenAI()\n",
+    "claude = Anthropic()\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Original question generation\n",
+    "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}]\n",
+    "\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": [
+    "# Get responses from multiple models\n",
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]\n",
+    "\n",
+    "# OpenAI\n",
+    "response = openai.chat.completions.create(model=\"gpt-4o-mini\", messages=messages)\n",
+    "answer = response.choices[0].message.content\n",
+    "competitors.append(\"gpt-4o-mini\")\n",
+    "answers.append(answer)\n",
+    "display(Markdown(answer))\n",
+    "\n",
+    "# Claude\n",
+    "response = claude.messages.create(model=\"claude-3-7-sonnet-latest\", messages=messages, max_tokens=1000)\n",
+    "answer = response.content[0].text\n",
+    "competitors.append(\"claude-3-7-sonnet-latest\")\n",
+    "answers.append(answer)\n",
+    "display(Markdown(answer))\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# NEW: Chain of Thought Evaluation\n",
+    "# First, let's create a detailed evaluation prompt that encourages step-by-step reasoning\n",
+    "\n",
+    "evaluation_prompt = f\"\"\"You are an expert evaluator of AI responses. Your task is to analyze and rank the following responses to this question:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Please follow these steps in your evaluation:\n",
+    "\n",
+    "1. For each response:\n",
+    "   - Identify the main arguments presented\n",
+    "   - Evaluate the clarity and coherence of the reasoning\n",
+    "   - Assess the depth and breadth of the analysis\n",
+    "   - Note any unique insights or perspectives\n",
+    "\n",
+    "2. Compare the responses:\n",
+    "   - How do they differ in their approach?\n",
+    "   - Which response demonstrates the most sophisticated understanding?\n",
+    "   - Which response provides the most practical and actionable insights?\n",
+    "\n",
+    "3. Provide your final ranking with detailed justification for each position.\n",
+    "\n",
+    "Here are the responses:\n",
+    "\n",
+    "{'\\\\n\\\\n'.join([f'Response {i+1} ({competitors[i]}):\\\\n{answer}' for i, answer in enumerate(answers)])}\n",
+    "\n",
+    "Please provide your evaluation in JSON format with the following structure:\n",
+    "{{\n",
+    "    \"detailed_analysis\": [\n",
+    "        {{\"competitor\": \"name\", \"strengths\": [], \"weaknesses\": [], \"unique_aspects\": []}},\n",
+    "        ...\n",
+    "    ],\n",
+    "    \"comparative_analysis\": \"detailed comparison of responses\",\n",
+    "    \"final_ranking\": [\"ranked competitor numbers\"],\n",
+    "    \"justification\": \"detailed explanation of the ranking\"\n",
+    "}}\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Get the detailed evaluation\n",
+    "evaluation_messages = [{\"role\": \"user\", \"content\": evaluation_prompt}]\n",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=evaluation_messages,\n",
+    ")\n",
+    "detailed_evaluation = response.choices[0].message.content\n",
+    "print(detailed_evaluation)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Parse and display the results in a more readable format\n",
+    "\n",
+    "# Clean up the JSON string by removing markdown code block markers\n",
+    "json_str = detailed_evaluation.replace(\"```json\", \"\").replace(\"```\", \"\").strip()\n",
+    "\n",
+    "evaluation_dict = json.loads(json_str)\n",
+    "\n",
+    "print(\"Detailed Analysis:\")\n",
+    "for analysis in evaluation_dict[\"detailed_analysis\"]:\n",
+    "    print(f\"\\nCompetitor: {analysis['competitor']}\")\n",
+    "    print(\"Strengths:\")\n",
+    "    for strength in analysis['strengths']:\n",
+    "        print(f\"- {strength}\")\n",
+    "    print(\"\\nWeaknesses:\")\n",
+    "    for weakness in analysis['weaknesses']:\n",
+    "        print(f\"- {weakness}\")\n",
+    "    print(\"\\nUnique Aspects:\")\n",
+    "    for aspect in analysis['unique_aspects']:\n",
+    "        print(f\"- {aspect}\")\n",
+    "\n",
+    "print(\"\\nComparative Analysis:\")\n",
+    "print(evaluation_dict[\"comparative_analysis\"])\n",
+    "\n",
+    "print(\"\\nFinal Ranking:\")\n",
+    "for i, rank in enumerate(evaluation_dict[\"final_ranking\"]):\n",
+    "    print(f\"{i+1}. {competitors[int(rank)-1]}\")\n",
+    "\n",
+    "print(\"\\nJustification:\")\n",
+    "print(evaluation_dict[\"justification\"])\n"
+   ]
+  },
+  {
+   "cell_type": "raw",
+   "metadata": {
+    "vscode": {
+     "languageId": "raw"
+    }
+   },
+   "source": [
+    "## Pattern Analysis\n",
+    "\n",
+    "This enhanced version uses several agentic design patterns:\n",
+    "\n",
+    "1. **Multi-agent Collaboration**: Sending the same question to multiple LLMs\n",
+    "2. **Evaluation/Judgment Pattern**: Using one LLM to evaluate responses from others\n",
+    "3. **Parallel Processing**: Running multiple models simultaneously\n",
+    "4. **Chain of Thought**: Added a structured, step-by-step evaluation process that breaks down the analysis into clear stages\n",
+    "\n",
+    "The Chain of Thought pattern is particularly valuable here because it:\n",
+    "- Forces the evaluator to consider multiple aspects of each response\n",
+    "- Provides more detailed and structured feedback\n",
+    "- Makes the evaluation process more transparent and explainable\n",
+    "- Helps identify specific strengths and weaknesses in each response\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.7"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_llm_reviewer.ipynb

@@ -0,0 +1,627 @@
+{
+ "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 notebook extends the original by adding a reviewer pattern to evaluate the impact on model performance.\n",
+    "\n",
+    "In the new workflow, each model's answer is provided to a \"reviewer LLM\" who is prompted to \"Evaluate the response for clarity and strength of argument, and provide constructive suggestions for improving the answer.\" Each model is then given the chance to revise its answer based on the feedback but is also told, \"You are not required to take any of the feedback into account, but you want to win the competition.\"\n",
+    "\n",
+    "<table>\n",
+    "  <caption style=\"font-size: 1.2em; margin-bottom: 10px;\"><strong>Results for Representative Run</strong></caption>\n",
+    "  <thead>\n",
+    "    <tr>\n",
+    "      <th>Model</th>\n",
+    "      <th>Original Rank</th>\n",
+    "      <th>Exclusive Feedback</th>\n",
+    "      <th>With Feedback (all models)</th>\n",
+    "    </tr>\n",
+    "  </thead>\n",
+    "  <tbody>\n",
+    "    <tr>\n",
+    "      <td>gpt-4o-mini</td>\n",
+    "      <td>2</td>\n",
+    "      <td>3</td>\n",
+    "      <td>4</td>\n",
+    "    </tr>\n",
+    "    <tr>\n",
+    "      <td>claude-3-7-sonnet-latest</td>\n",
+    "      <td>6</td>\n",
+    "      <td>1</td>\n",
+    "      <td>1</td>\n",
+    "    </tr>\n",
+    "    <tr>\n",
+    "      <td>gemini-2.0-flash</td>\n",
+    "      <td>1</td>\n",
+    "      <td>1</td>\n",
+    "      <td>2</td>\n",
+    "    </tr>\n",
+    "    <tr>\n",
+    "      <td>deepseek-chat</td>\n",
+    "      <td>3</td>\n",
+    "      <td>2</td>\n",
+    "      <td>3</td>\n",
+    "    </tr>\n",
+    "    <tr>\n",
+    "      <td>llama-3.3-70b-versatile</td>\n",
+    "      <td>4</td>\n",
+    "      <td>3</td>\n",
+    "      <td>5</td>\n",
+    "    </tr>\n",
+    "    <tr>\n",
+    "      <td>llama3.2</td>\n",
+    "      <td>5</td>\n",
+    "      <td>4</td>\n",
+    "      <td>6</td>\n",
+    "    </tr>\n",
+    "  </tbody>\n",
+    "</table>\n",
+    "\n",
+    "The workflow is obviously non-deterministic and the results can vary greatly from run to run, but the introduction of a reviewer appeared to have a generaly positive impact on performance.  The table above shows the results for a representative run. It compares each model's rank versus the other models when it exclusively received feedback.  The table also shows the ranking when ALL models received feedback.  Exclusive use of feedback improved a model's ranking for five out of six models and decreased it for one model.\n",
+    "\n",
+    "Inspired by some other contributions, this worksheet also makes LLM calls asyncrhonously to reduce wait time."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Start with imports - ask ChatGPT to explain any package that you don't know\n",
+    "#!uv add prettytable\n",
+    "\n",
+    "import os\n",
+    "import asyncio\n",
+    "import json\n",
+    "from dotenv import load_dotenv\n",
+    "from openai import OpenAI, AsyncOpenAI\n",
+    "from anthropic import AsyncAnthropic\n",
+    "from IPython.display import display\n",
+    "from pydantic import BaseModel, Field\n",
+    "from string import Template\n",
+    "from prettytable import PrettyTable\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class LLMResult(BaseModel):\n",
+    "    model: str\n",
+    "    answer: str\n",
+    "    feedback: str | None =Field(\n",
+    "        default = None, \n",
+    "        description=\"Mutable field.  This will be set by the reviewer.\")\n",
+    "    revised_answer: str | None =Field(\n",
+    "        default = None, \n",
+    "        description=\"Mutable field.  This will be set by the answerer after the reviewer has provided feedback.\")\n",
+    "    original_rank: int | None =Field(\n",
+    "        default = None, \n",
+    "        description=\"Mutable field.  Rank when no feedback is used by any models.\")\n",
+    "    exclusive_feedback: str | None =Field(\n",
+    "        default = None, \n",
+    "        description=\"Mutable field.  Rank when only this model used feedback.\")\n",
+    "    revised_rank: int | None =Field(\n",
+    "        default = None, \n",
+    "        description=\"Mutable field.  Rank when all models used feedback.\")\n",
+    "\n",
+    "results : list[LLMResult] = []\n"
+   ]
+  },
+  {
+   "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": 27,
+   "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": 30,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The API we know well\n",
+    "\n",
+    "async def openai_answer(messages: list[dict[str, str]], model_name : str) -> str:\n",
+    "    openai = AsyncOpenAI()\n",
+    "    response = await openai.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    print(f\"{model_name} answer: {answer[:50]}...\")\n",
+    "    return answer\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Anthropic has a slightly different API, and Max Tokens is required\n",
+    "\n",
+    "async def claude_anthropic_answer(messages: list[dict[str, str]], model_name : str) -> str:\n",
+    "    claude = AsyncAnthropic()\n",
+    "    response = await claude.messages.create(model=model_name, messages=messages, max_tokens=1000)\n",
+    "    answer = response.content[0].text\n",
+    "    print(f\"{model_name} answer: {answer[:50]}...\")\n",
+    "    return answer\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def gemini_google_answer(messages: list[dict[str, str]], model_name : str) -> str:     \n",
+    "    gemini = AsyncOpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\")\n",
+    "    response = await gemini.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content.strip()\n",
+    "    print(f\"{model_name} answer: {answer[:50]}...\")\n",
+    "    return answer\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 34,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def deepseek_answer(messages: list[dict[str, str]], model_name : str) -> str:\n",
+    "    deepseek = AsyncOpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\")\n",
+    "    response = await deepseek.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    print(f\"{model_name} answer: {answer[:50]}...\")\n",
+    "    return answer\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 35,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def groq_answer(messages: list[dict[str, str]], model_name : str) -> str:\n",
+    "    groq = AsyncOpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\")\n",
+    "    response = await groq.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    print(f\"{model_name} answer: {answer[:50]}...\")\n",
+    "    return 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": 36,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "async def ollama_answer(messages: list[dict[str, str]], model_name : str) -> str:\n",
+    "    ollama = AsyncOpenAI(base_url='http://localhost:11434/v1', api_key='ollama')\n",
+    "    response = await ollama.chat.completions.create(model=model_name, messages=messages)\n",
+    "    answer = response.choices[0].message.content\n",
+    "    print(f\"{model_name} answer: {answer[:50]}...\")\n",
+    "    return answer\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "answerers  = [openai_answer, claude_anthropic_answer, gemini_google_answer, deepseek_answer, groq_answer, ollama_answer]\n",
+    "models = [\"gpt-4o-mini\", \"claude-3-7-sonnet-latest\", \"gemini-2.0-flash\", \"deepseek-chat\", \"llama-3.3-70b-versatile\", \"llama3.2\"]\n",
+    "\n",
+    "tasks = [ answerer(messages, model) for answerer, model in zip(answerers, models)]\n",
+    "answers : list[str] = await asyncio.gather(*tasks)\n",
+    "results : list[LLMResult] = [LLMResult(model=model, answer=answer) for model, answer in zip(models, answers)]\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "answers "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 40,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reviewer = f\"\"\"You are reviewing a submission for a writing competition.  The particpant has been given this question to answer:\n",
+    "\n",
+    "{question}\n",
+    "\n",
+    "Your job is to evaluate the response for clarity and strength of argument, and provide constructive suggestions for improving the answer.\n",
+    "Limit your feedback to 200 words.\n",
+    "\n",
+    "Here is the particpant's answer:\n",
+    "{{answer}}\n",
+    "\"\"\"\n",
+    "\n",
+    "async def review_answer(answer : str) -> str:\n",
+    "    openai = AsyncOpenAI()\n",
+    "    reviewer_messages = [{\"role\": \"user\", \"content\": reviewer.format(answer=answer)}]\n",
+    "    reviewer_response = await openai.chat.completions.create(\n",
+    "        model=\"gpt-4o-mini\",\n",
+    "        messages=reviewer_messages,\n",
+    "    )\n",
+    "    feedback = reviewer_response.choices[0].message.content\n",
+    "    print(f\"feedback: {feedback[:50]}...\")\n",
+    "    return feedback"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import asyncio\n",
+    "\n",
+    "tasks = [review_answer(answer) for answer in answers]\n",
+    "feedback = await asyncio.gather(*tasks)\n",
+    "\n",
+    "for result, feedback in zip(results, feedback):\n",
+    "    result.feedback = feedback\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 42,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "revision_prompt = f\"\"\"You are revising a submission you wrote for a writing competition based on feedback from a reviewer.\n",
+    "\n",
+    "You are not required to take any of the feedback into account but you want to win the competition.\n",
+    "\n",
+    "The question was: \n",
+    "{question}\n",
+    "\n",
+    "The feedback was:\n",
+    "{{feedback}}\n",
+    "\n",
+    "And your original answer was:\n",
+    "{{answer}}\n",
+    "\n",
+    "Please return your revised answer and nothing else.\n",
+    "\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "messages = [{\"role\": \"user\", \"content\": revision_prompt.format(answer=answer, feedback=feedback)} for answer, feedback in zip(answers, feedback)]\n",
+    "tasks = [ answerer(messages, model) for answerer, model in zip(answerers, models)]\n",
+    "revised_answers = await asyncio.gather(*tasks)\n",
+    "\n",
+    "for revised_answer, result in zip(revised_answers, results):\n",
+    "    result.revised_answer = revised_answer\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 44,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# need to use Template because we are making a later substitution for \"together\"\n",
+    "judge = Template(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",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 45,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 46,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def come_together(results : list[LLMResult], revised_entry : int | None ) -> list[dict[str, str]]:\n",
+    "    # include revised results for \"revised_entry\" or all entries if revise_entrys is None\n",
+    "    together = \"\"\n",
+    "    for index, result in enumerate(results):\n",
+    "        together += f\"# Response from competitor {index}\\n\\n\"\n",
+    "        together += result.answer if (index != revised_entry and revised_entry is not None) else result.revised_answer + \"\\n\\n\"\n",
+    "    return [{\"role\": \"user\", \"content\": judge.substitute(together=together)}]\n",
+    "\n",
+    "\n",
+    "# Judgement time!\n",
+    "async def judgement_time(results : list[LLMResult], revised_entry : int ) -> str:\n",
+    "    judge_messages = come_together(results, revised_entry)\n",
+    "\n",
+    "    openai = AsyncOpenAI()\n",
+    "    response = await openai.chat.completions.create(\n",
+    "        model=\"o3-mini\",\n",
+    "        messages=judge_messages,\n",
+    "    )\n",
+    "    results = response.choices[0].message.content\n",
+    "    results_dict = json.loads(results)\n",
+    "    results = {  int(model) : int(rank) +1 for rank, model in enumerate(results_dict[\"results\"]) }\n",
+    "    return results\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 47,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#evaluate the impact of feedback on model performance\n",
+    "\n",
+    "no_feedback = await judgement_time(results, -1)\n",
+    "with_feedback = await judgement_time(results, None)\n",
+    "\n",
+    "tasks = [ judgement_time(results, i) for i in range(len(results))]\n",
+    "model_spefic_feedback = await asyncio.gather(*tasks)\n",
+    "\n",
+    "for index, result in enumerate(results):\n",
+    "    result.original_rank = no_feedback[index]\n",
+    "    result.exclusive_feedback = model_spefic_feedback[index][index]\n",
+    "    result.revised_rank = with_feedback[index]\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "table = PrettyTable()\n",
+    "table.field_names = [\"Model\", \"Original Rank\", \"Exclusive Feedback\", \"With Feedback (all models)\"]\n",
+    "\n",
+    "for result in results:\n",
+    "    table.add_row([result.model, result.original_rank, result.exclusive_feedback, result.revised_rank])\n",
+    "\n",
+    "print(table)\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;\">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_moneek.ipynb

@@ -0,0 +1,173 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Week 1, Day 3\n",
+    "\n",
+    "This program uses Evaluator Optimizer pattern to enhance generator's response in creating marketing content for smart keyboard."
+   ]
+  },
+  {
+   "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",
+    "\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)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Provide a short marketing content for XYZ keyboard. \"\n",
+    "request += \"It should be eagaging and talks about innovative features.\"\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",
+    "\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "marketing_statement= response.choices[0].message.content\n",
+    "print(marketing_statement)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge = f\"\"\"### Instruction ###\n",
+    "You are an expert tech gadget analyst. Your task is to evaluate a marketing material based on several criteria.\n",
+    "Please be brief.\n",
+    "\n",
+    "### Ad to Evaluate ###\n",
+    "{marketing_statement}\n",
+    "\n",
+    "### Evaluation Criteria ###\n",
+    "Evaluate the statement based on how engaging it is.\n",
+    "\n",
+    "### Expected Output Format ###\n",
+    "Respond with JSON, and only JSON, with the following format:\n",
+    "{{\"results\": {{\"statement\": \"{marketing_statement}\", \"engagability\": \"Comment on whether the content is engaging\", \"critique\": \"Offer a specific critique and suggest at least one way the recipe could be improved\", \"verdict\": \"This should have a value either 'accepted' or 'rejected' based on whether the statement requires improvement\"}}}}\n",
+    "\"\"\"\n",
+    "\n",
+    "print(judge)\n",
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]\n",
+    "\n",
+    "model_name = \"claude-3-7-sonnet-latest\"\n",
+    "claude = Anthropic()\n",
+    "response = claude.messages.create(model=model_name, messages=judge_messages, max_tokens=1000)\n",
+    "marketing_statement_feedback = response.content[0].text\n",
+    "\n",
+    "print(marketing_statement_feedback)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "results_dict = json.loads(marketing_statement_feedback)\n",
+    "feedback = results_dict[\"results\"]\n",
+    "print(feedback)\n",
+    "print(\"\\n\\n\")\n",
+    "display(Markdown(marketing_statement_feedback))\n",
+    "\n",
+    "print(f\"Marketing statement:\\n{feedback[\"statement\"]}\")\n",
+    "for key in feedback:\n",
+    "    if key == \"verdict\":\n",
+    "        if feedback[key] == \"accepted\":\n",
+    "            print(\"Marketing statement was accepted.\")\n",
+    "            break\n",
+    "        else:\n",
+    "            print(\"Marketing statement was rejected and requires revision. Please iterate over to call Generator and Evaluator for improvement\")"
+   ]
+  }
+ ],
+ "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_multi-evaluation-criteria.ipynb

@@ -0,0 +1,506 @@
+{
+ "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-sonnet-4-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\"\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": [
+    "for competitor, answer in zip(competitors, answers):\n",
+    "    display(Markdown(f\"# Competitor: {competitor}\\n\\n{answer}\"))"
+   ]
+  },
+  {
+   "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": [
+    "evaluation_criteria = [\"Effectiveness in resolving the conflict\", \"Clarity of argument\", \"Creativity of solution\", \"Strength of argument\", \"conciseness\", \"applicability to a business context\"]\n",
+    "\n",
+    "judgements = []\n",
+    "\n",
+    "for evaluation_criterion in evaluation_criteria:\n",
+    "\n",
+    "  judgements.append (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 {evaluation_criterion}, 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(judgements[1])\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "judge_messages = []\n",
+    "for judgement in judgements:\n",
+    "    judge_messages.append ([{\"role\": \"user\", \"content\": judgement}])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "results = []\n",
+    "# Judgement time!\n",
+    "for judge_message in judge_messages:\n",
+    "  openai = OpenAI()\n",
+    "  response = openai.chat.completions.create(\n",
+    "    model=\"o3-mini\",\n",
+    "    messages=judge_message,\n",
+    "  )\n",
+    "  results.append (response.choices[0].message.content)\n",
+    "  print(results[0])\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "for result in results:\n",
+    "  print(result)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# OK let's turn this into results!\n",
+    "\n",
+    "for result, evaluation_criterion in zip(results, evaluation_criteria):\n",
+    "    results_dict = json.loads(result)\n",
+    "    ranks = results_dict[\"results\"]\n",
+    "    display(Markdown(f\"### {evaluation_criterion}\"))\n",
+    "    for index, result in enumerate(ranks):\n",
+    "        competitor = competitors[int(result)-1]    \n",
+    "        display(Markdown(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.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_perplexity_support.ipynb

@@ -0,0 +1,497 @@
+{
+ "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",
+    "perplexity_api_key = os.getenv('PERPLEXITY_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)\")\n",
+    "\n",
+    "if perplexity_api_key:\n",
+    "    print(f\"Perplexity API Key exists and begins {perplexity_api_key[:4]}\")\n",
+    "else:\n",
+    "    print(\"Perplexity 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": 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": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "perplexity = OpenAI(api_key=perplexity_api_key, base_url=\"https://api.perplexity.ai\")\n",
+    "model_name = \"sonar\"\n",
+    "\n",
+    "response = perplexity.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": "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.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_reflection_pattern.ipynb

@@ -0,0 +1,311 @@
+{
+ "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": [
+    "This version adds Reflection pattern where we ask each model to critique and improve its own answer."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "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": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "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": 14,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "competitors = []\n",
+    "answers = []\n",
+    "messages = [{\"role\": \"user\", \"content\": question}]"
+   ]
+  },
+  {
+   "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": [
+    "<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": 33,
+   "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": 36,
+   "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": 38,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "judge_messages = [{\"role\": \"user\", \"content\": judge}]"
+   ]
+  },
+  {
+   "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": [
+    "1. Ensemble (Model Competition) Pattern\n",
+    "Description: The same prompt/question is sent to multiple different LLMs (OpenAI, Anthropic, Ollama, etc.).\n",
+    "Purpose: To compare the quality, style, and content of responses from different models.\n",
+    "Where in notebook:\n",
+    "The code sends the same question to several models and collects their answers in the competitors and answers lists.\n",
+    "\n",
+    "2. Judging/Evaluator Pattern\n",
+    "Description: After collecting responses from all models, another LLM is used as a “judge” to evaluate and rank the responses.\n",
+    "Purpose: To automate the assessment of which model gave the best answer, based on clarity and strength of argument.\n",
+    "Where in notebook:\n",
+    "The judge prompt is constructed, and an LLM is asked to rank the responses in JSON format.\n",
+    "\n",
+    "3. Self-Improvement/Meta-Reasoning Pattern\n",
+    "Description: The system not only generates answers but also reflects on and evaluates its own outputs (or those of its peers).\n",
+    "Purpose: To iteratively improve or select the best output, often used in advanced agentic systems.\n",
+    "Where in notebook:\n",
+    "The “judge” LLM is an example of meta-reasoning, as it reasons about the quality of other LLMs’ outputs.\n",
+    "\n",
+    "4. Chain-of-Thought/Decomposition Pattern (to a lesser extent)\n",
+    "Description: Breaking down a complex task into subtasks (e.g., generate question → get answers → evaluate answers).\n",
+    "Purpose: To improve reliability and interpretability by structuring the workflow.\n",
+    "Where in notebook:\n",
+    "The workflow is decomposed into:\n",
+    "Generating a challenging question\n",
+    "Getting answers from multiple models\n",
+    "Judging the answers\n",
+    "\n",
+    "In short:\n",
+    "This notebook uses the Ensemble/Competition, Judging/Evaluator, and Meta-Reasoning agentic patterns, and also demonstrates a simple form of Decomposition by structuring the workflow into clear stages.\n",
+    "If you want to add more agentic patterns, you could try things like:\n",
+    "Reflexion (let models critique and revise their own answers)\n",
+    "Tool Use (let models call external tools or APIs)\n",
+    "Planning (let a model plan the steps before answering)"
+   ]
+  },
+  {
+   "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.8"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/2_lab2_reflection_pattern2.ipynb

@@ -0,0 +1,999 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Welcome to the Second Lab - Exercise: Advanced Agentic Design Patterns\n",
+    "\n",
+    "This notebook extends the previous lab by adding the **Reflection Pattern** to improve response quality.\n",
+    "\n",
+    "### Patterns used in the original lab:\n",
+    "1. **Multi-Model Comparison Pattern** - Comparing multiple models\n",
+    "2. **Judge/Evaluator Pattern** - Evaluation by a judge model\n",
+    "\n",
+    "### New pattern added:\n",
+    "3. **Reflection Pattern** - Self-improvement of responses"
+   ]
+  },
+  {
+   "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;\">New Pattern: Reflection</h2>\n",
+    "            <span style=\"color:#ff7800;\">The Reflection Pattern allows a model to critique and improve its own response. This is particularly useful for complex tasks requiring nuance and precision.</span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "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\n",
+    "\n",
+    "# Always remember to do this!\n",
+    "load_dotenv(override=True)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "OpenAI API Key exists and begins sk-1kYcH\n",
+      "Anthropic API Key exists and begins sk-ant-\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": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 1: Generate Initial Question (Multi-Model Pattern)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Generated Question:\n",
+      "A wealthy philanthropist has developed a new drug that can cure a rare but fatal disease affecting a small population. However, the drug is expensive to produce and the philanthropist only has enough resources to manufacture a limited supply. At the same time, a competing pharmaceutical company has discovered the cure but plans to charge exorbitant prices, making it inaccessible for most patients. \n",
+      "\n",
+      "The philanthropist learns that if they invest their resources into manufacturing the drug, it can be distributed at a lower cost but only to a select few who are already on a waiting list, prioritizing those who are most likely to recover. Alternatively, the philanthropist could sell the formula to the competing company for a substantial profit, ensuring that a broader population can access the cure, albeit at high prices that many cannot afford.\n",
+      "\n",
+      "The dilemma: Should the philanthropist prioritize the immediate health of a few individuals by providing the cure at a lower cost, or should they consider the greater good by allowing the competitive company to distribute the cure to a wider audience at a higher price?\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Generate a challenging question for the models to answer\n",
+    "\n",
+    "request = \"Please come up with a challenging ethical dilemma that requires careful moral reasoning and consideration of multiple perspectives. \"\n",
+    "request += \"The dilemma should involve conflicting values and have no clear-cut answer. Answer only with the dilemma, no explanation.\"\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]\n",
+    "\n",
+    "openai = OpenAI()\n",
+    "response = openai.chat.completions.create(\n",
+    "    model=\"gpt-4o-mini\",\n",
+    "    messages=messages,\n",
+    ")\n",
+    "\n",
+    "question = response.choices[0].message.content\n",
+    "print(\"Generated Question:\")\n",
+    "print(question)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 2: Get Initial Responses from Multiple Models"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_initial_response(client, model_name, question, is_anthropic=False):\n",
+    "    \"\"\"Get initial response from a model\"\"\"\n",
+    "    messages = [{\"role\": \"user\", \"content\": question}]\n",
+    "    \n",
+    "    if is_anthropic:\n",
+    "        response = client.messages.create(\n",
+    "            model=model_name, \n",
+    "            messages=messages, \n",
+    "            max_tokens=1000\n",
+    "        )\n",
+    "        return response.content[0].text\n",
+    "    else:\n",
+    "        response = client.chat.completions.create(\n",
+    "            model=model_name, \n",
+    "            messages=messages\n",
+    "        )\n",
+    "        return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Configure clients\n",
+    "openai_client = OpenAI()\n",
+    "claude_client = Anthropic() if anthropic_api_key else None\n",
+    "gemini_client = OpenAI(api_key=google_api_key, base_url=\"https://generativelanguage.googleapis.com/v1beta/openai/\") if google_api_key else None\n",
+    "deepseek_client = OpenAI(api_key=deepseek_api_key, base_url=\"https://api.deepseek.com/v1\") if deepseek_api_key else None\n",
+    "groq_client = OpenAI(api_key=groq_api_key, base_url=\"https://api.groq.com/openai/v1\") if groq_api_key else None"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "=== INITIAL RESPONSES ===\n",
+      "\n",
+      "**gpt-4o-mini:**\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "This ethical dilemma presents a challenging decision for the philanthropist, who must weigh the immediate health needs of a few individuals against the broader societal implications of drug distribution and access.\n",
+       "\n",
+       "### Option 1: Prioritizing Immediate Health\n",
+       "\n",
+       "If the philanthropist chooses to manufacture the drug and distribute it at a lower cost to those on the waiting list, they are directly addressing the pressing health needs of a select few individuals who are already vulnerable. This action prioritizes compassion and the moral obligation to help those who are suffering. By ensuring that the drug is available to those with the highest likelihood of recovery, the philanthropist demonstrates an ethical commitment to saving lives and reducing suffering in the short term.\n",
+       "\n",
+       "However, this approach has limitations. By distributing the drug to only a small number of patients, the philanthropist may overlook other individuals who could benefit from the cure. Additionally, this solution does not address the systemic issue of access to healthcare and affordable medications for the larger population suffering from the disease.\n",
+       "\n",
+       "### Option 2: Considering the Greater Good\n",
+       "\n",
+       "On the other hand, selling the formula to the competing pharmaceutical company for a substantial profit could lead to a wider distribution of the drug, although at a higher price point that may make it inaccessible to many patients. In this scenario, the philanthropist uses their financial gain to potentially invest in other healthcare initiatives or research, thus contributing to the long-term improvement of medical care or addressing related health issues.\n",
+       "\n",
+       "This choice raises ethical concerns regarding the prioritization of profit over compassion and the risk that many individuals will remain unable to afford the life-saving treatment. It also creates a tension between the ideals of philanthropy and the realities of the pharmaceutical industry, which often operates on profit motives rather than altruistic goals.\n",
+       "\n",
+       "### Balancing the Two Options\n",
+       "\n",
+       "A possible compromise could be for the philanthropist to negotiate a deal with the pharmaceutical company that ensures a tiered pricing structure, where those who can afford the drug pay more while discounts or alternative funding are provided for low-income patients. This could help bridge the gap between immediate health needs and wider access.\n",
+       "\n",
+       "Ultimately, the decision comes down to the philanthropist's values and vision for their impact on public health. Do they prioritize saving a few lives in the short term or seek a more sustainable, albeit imperfect, solution that aims at broader access over a longer timeframe? The complexity of the dilemma emphasizes the need for thoughtful deliberation on how best to serve both individual health needs and the greater public good."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "==================================================\n",
+      "\n",
+      "**claude-3-7-sonnet-latest:**\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "# The Philanthropist's Dilemma\n",
+       "\n",
+       "This is a complex ethical dilemma that involves several important considerations:\n",
+       "\n",
+       "## Key Ethical Tensions\n",
+       "\n",
+       "- **Limited access at affordable prices** vs. **wider access at unaffordable prices**\n",
+       "- **Immediate relief for a few** vs. **potential long-term access for many**\n",
+       "- **Direct control over distribution** vs. **surrendering control to profit-motivated actors**\n",
+       "\n",
+       "## Considerations for Manufacturing the Drug Directly\n",
+       "\n",
+       "**Benefits:**\n",
+       "- Ensures the most vulnerable patients receive treatment based on medical need rather than ability to pay\n",
+       "- Maintains the philanthropist's ethical vision and control over distribution\n",
+       "- Sets a precedent for compassionate drug pricing\n",
+       "\n",
+       "**Drawbacks:**\n",
+       "- Limited overall reach due to resource constraints\n",
+       "- Potentially slower scaling of production\n",
+       "- Many patients may receive no treatment at all\n",
+       "\n",
+       "## Considerations for Selling to the Pharmaceutical Company\n",
+       "\n",
+       "**Benefits:**\n",
+       "- Potentially greater production capacity and distribution reach\n",
+       "- The philanthropist could use profits to subsidize costs for those who cannot afford it\n",
+       "- Might accelerate further research and development\n",
+       "\n",
+       "**Drawbacks:**\n",
+       "- Many patients would be excluded based on financial means\n",
+       "- Surrenders control over an essential medicine to profit-motivated decision-making\n",
+       "- Could establish a problematic precedent for pricing life-saving medications\n",
+       "\n",
+       "This dilemma reflects broader tensions in healthcare ethics between utilitarian approaches (helping the most people) and justice-based approaches (ensuring fair access based on need rather than wealth).\n",
+       "\n",
+       "There might be creative third options worth exploring, such as licensing agreements with price caps, creating a non-profit manufacturing entity, or partnering with governments to ensure broader affordable access."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "==================================================\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Collect initial responses\n",
+    "initial_responses = {}\n",
+    "competitors = []\n",
+    "\n",
+    "models = [\n",
+    "    (\"gpt-4o-mini\", openai_client, False),\n",
+    "    (\"claude-3-7-sonnet-latest\", claude_client, True),\n",
+    "    (\"gemini-2.0-flash\", gemini_client, False),\n",
+    "    (\"deepseek-chat\", deepseek_client, False),\n",
+    "    (\"llama-3.3-70b-versatile\", groq_client, False),\n",
+    "]\n",
+    "\n",
+    "print(\"\\n=== INITIAL RESPONSES ===\\n\")\n",
+    "\n",
+    "for model_name, client, is_anthropic in models:\n",
+    "    if client:\n",
+    "        try:\n",
+    "            response = get_initial_response(client, model_name, question, is_anthropic)\n",
+    "            initial_responses[model_name] = response\n",
+    "            competitors.append(model_name)\n",
+    "            \n",
+    "            print(f\"**{model_name}:**\")\n",
+    "            display(Markdown(response))\n",
+    "            print(\"\\n\" + \"=\"*50 + \"\\n\")\n",
+    "        except Exception as e:\n",
+    "            print(f\"Error with {model_name}: {e}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 3: NEW PATTERN - Reflection Pattern"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def apply_reflection_pattern(client, model_name, original_question, initial_response, is_anthropic=False):\n",
+    "    \"\"\"Apply the Reflection Pattern to improve a response\"\"\"\n",
+    "    \n",
+    "    reflection_prompt = f\"\"\"\n",
+    "You previously received this question:\n",
+    "{original_question}\n",
+    "\n",
+    "Here was your initial response:\n",
+    "{initial_response}\n",
+    "\n",
+    "Now, as a critical expert, analyze your own response:\n",
+    "1. What are the strengths of this response?\n",
+    "2. What important perspectives are missing?\n",
+    "3. Are there any biases or blind spots in the analysis?\n",
+    "4. How could you improve this response?\n",
+    "\n",
+    "After this self-critique, provide an IMPROVED response that takes into account your observations.\n",
+    "\n",
+    "Response format:\n",
+    "## Self-Critique\n",
+    "[Your critical analysis of the initial response]\n",
+    "\n",
+    "## Improved Response\n",
+    "[Your revised and improved response]\n",
+    "\"\"\"\n",
+    "    \n",
+    "    messages = [{\"role\": \"user\", \"content\": reflection_prompt}]\n",
+    "    \n",
+    "    if is_anthropic:\n",
+    "        response = client.messages.create(\n",
+    "            model=model_name, \n",
+    "            messages=messages, \n",
+    "            max_tokens=1500\n",
+    "        )\n",
+    "        return response.content[0].text\n",
+    "    else:\n",
+    "        response = client.chat.completions.create(\n",
+    "            model=model_name, \n",
+    "            messages=messages\n",
+    "        )\n",
+    "        return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "=== RESPONSES AFTER REFLECTION ===\n",
+      "\n",
+      "**gpt-4o-mini - After Reflection:**\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "## Self-Critique\n",
+       "1. **Strengths of this Response:**\n",
+       "   - The response thoroughly outlines both options available to the philanthropist, providing a balanced view of the ethical implications of each choice.\n",
+       "   - It acknowledges the immediate health needs of affected individuals as well as the broader societal implications of drug distribution.\n",
+       "   - It introduces a potential compromise solution, which adds depth to the analysis and suggests a more nuanced approach to the dilemma.\n",
+       "\n",
+       "2. **Important Perspectives Missing:**\n",
+       "   - The response does not adequately consider the potential operational and logistical challenges in manufacturing and distributing the drug at a lower cost, including regulatory hurdles and the scalability of production.\n",
+       "   - There is limited discussion on the emotional impact of the decision on the patients and their families, which could influence the philanthropist's considerations.\n",
+       "   - The perspective of other stakeholders, such as healthcare providers and ethicists, is not introduced.\n",
+       "\n",
+       "3. **Biases or Blind Spots in the Analysis:**\n",
+       "   - The response may lean towards prioritizing compassion over economic pragmatism, possibly downplaying the complexities involved in pharmaceutical economics and the realities that arise from selling to a corporation with profit motives.\n",
+       "   - It assumes a binary choice rather than considering other stakeholder impacts and longer-term systemic solutions.\n",
+       "\n",
+       "4. **How to Improve This Response:**\n",
+       "   - Include more contextual factors that might affect the decision, such as regulatory considerations, patient demographics, and healthcare infrastructure.\n",
+       "   - Expand on the emotional and psychological aspects of the decision-making process for both the philanthropist and the patients involved.\n",
+       "   - Address the potential for future societal implications if the competing company monopolizes the market after acquiring the formula.\n",
+       "\n",
+       "## Improved Response\n",
+       "This ethical dilemma presents the philanthropist with a complex decision regarding how best to utilize limited resources to maximize the benefit for individuals suffering from a rare but fatal disease. The two primary options – providing a low-cost supply to a select few or selling the formula for broader but costly distribution – both highlight significant ethical considerations.\n",
+       "\n",
+       "### Option 1: Prioritizing Immediate Health\n",
+       "By choosing to manufacture the drug at a lower cost for those on the waiting list, the philanthropist opts to directly address the urgent health needs of vulnerable individuals. This approach reflects a moral obligation to alleviate suffering and save lives in the short term. Prioritizing individuals with the highest likelihood of recovery can lead to tangible, immediate outcomes for those patients and their families.\n",
+       "\n",
+       "However, there are operational challenges associated with this choice. Limited production capabilities may mean that only a fraction of those in need can actually receive the drug, leaving many others without hope. Additionally, this decision doesn't resolve the systemic issues within healthcare, such as overall treatment accessibility and drug pricing, which may persist if not tackled holistically.\n",
+       "\n",
+       "### Option 2: Considering the Greater Good\n",
+       "Alternatively, selling the formula to the competing pharmaceutical company could result in wider distribution of the drug and potentially more patients benefiting from the cure, albeit at higher prices. This choice could finance further philanthropic efforts or investments in healthcare that might ultimately lead to broader long-term improvements in public health.\n",
+       "\n",
+       "However, ethical concerns arise when considering the high pricing of the cure. The decision may disproportionately disadvantage lower-income patients, perpetuating healthcare inequities. Furthermore, there is the risk that this choice could enable the pharmaceutical company to monopolize treatment options, further exploitation in the industry.\n",
+       "\n",
+       "### A Balanced Approach\n",
+       "To navigate this complex dilemma more thoughtfully, the philanthropist could explore a compromise by negotiating with the pharmaceutical company to establish a tiered pricing structure. This could create a system where the drug is offered at a reduced price for low-income patients, while ensuring sustainability for the company through higher prices for those who can afford them. Additionally, the philanthropist might advocate for a commitment from the company to invest in generics or alternative distribution methods to enhance accessibility.\n",
+       "\n",
+       "### Conclusion\n",
+       "The choice ultimately hinges on the philanthropist's values and vision for their impact on public health. This decision requires careful consideration of immediate health benefits, long-term accessibility, and the emotional ramifications for affected individuals. By weighing the implications of each option and considering collaborative solutions, the philanthropist can work towards an outcome that promotes both individual care and broader societal well-being."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "==================================================\n",
+      "\n",
+      "**claude-3-7-sonnet-latest - After Reflection:**\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "## Self-Critique\n",
+       "\n",
+       "### Strengths of the initial response:\n",
+       "- Well-structured analysis that clearly outlines the ethical tensions\n",
+       "- Presents balanced considerations for both options\n",
+       "- Mentions potential third options beyond the binary choice\n",
+       "- Identifies the broader ethical frameworks at play (utilitarian vs. justice-based approaches)\n",
+       "\n",
+       "### Missing perspectives:\n",
+       "1. **Stakeholder analysis**: The response lacks a thorough examination of all affected parties (patients, healthcare systems, future patients, etc.)\n",
+       "2. **Timeline considerations**: No discussion of short-term vs. long-term consequences beyond immediate access\n",
+       "3. **Public health impact**: Limited analysis of how each option affects overall public health outcomes\n",
+       "4. **Precedent-setting effects**: Inadequate exploration of how this decision might influence future pharmaceutical development and pricing\n",
+       "5. **Regulatory context**: No mention of potential government intervention, price controls, or other regulatory factors\n",
+       "6. **Global justice perspective**: No consideration of how this decision affects different regions/countries\n",
+       "\n",
+       "### Biases and blind spots:\n",
+       "1. **False dichotomy**: Despite mentioning \"third options,\" the analysis primarily treats this as a binary choice\n",
+       "2. **Western/developed-world bias**: Assumes a market-based healthcare system without considering different global contexts\n",
+       "3. **Individual-focused ethics**: Overemphasizes individual choice rather than institutional or systemic responsibilities\n",
+       "4. **Overly abstract**: The analysis lacks concrete examples or case studies that might inform the decision\n",
+       "5. **Neglect of power dynamics**: Doesn't address the power imbalance between corporations, individuals, and patients\n",
+       "\n",
+       "### Improvement opportunities:\n",
+       "1. Provide a more nuanced spectrum of options beyond the binary choice\n",
+       "2. Include more stakeholder perspectives, particularly patient voices\n",
+       "3. Consider real-world case studies of similar pharmaceutical dilemmas\n",
+       "4. Address systemic issues in drug development and pharmaceutical pricing\n",
+       "5. Explore collaborative approaches that leverage multiple institutions\n",
+       "6. Discuss intellectual property rights and their ethical implications\n",
+       "\n",
+       "## Improved Response\n",
+       "\n",
+       "# The Philanthropist's Dilemma: A Multidimensional Ethical Analysis\n",
+       "\n",
+       "This scenario presents not simply a binary choice but a complex ethical landscape involving multiple stakeholders, systemic factors, and competing values.\n",
+       "\n",
+       "## Stakeholder Analysis\n",
+       "\n",
+       "**Patients and families:**\n",
+       "- Those currently suffering need immediate access regardless of mechanism\n",
+       "- Future patients have interests in sustainable development of treatments\n",
+       "- Economic diversity among patients means affordability affects different groups unequally\n",
+       "\n",
+       "**Healthcare systems:**\n",
+       "- Must allocate limited resources across competing priorities\n",
+       "- High-priced drugs can strain budgets and force difficult coverage decisions\n",
+       "- Precedents set now affect future negotiations with pharmaceutical companies\n",
+       "\n",
+       "**Research community:**\n",
+       "- Incentives for developing treatments for rare diseases are influenced by such cases\n",
+       "- How intellectual property is handled affects future research priorities\n",
+       "\n",
+       "## Ethical Frameworks Worth Considering\n",
+       "\n",
+       "1. **Distributive justice**: Who should receive limited resources? What constitutes fair allocation?\n",
+       "2. **Rights-based approach**: Do patients have a right to life-saving medication regardless of cost?\n",
+       "3. **Consequentialist assessment**: Which option produces the best outcomes for the most people over time?\n",
+       "4. **Virtue ethics**: What would a virtuous philanthropist do in this situation?\n",
+       "5. **Global justice**: How does this decision affect healthcare equity across different regions?\n",
+       "\n",
+       "## Spectrum of Options\n",
+       "\n",
+       "Rather than two mutually exclusive choices, consider a spectrum of possibilities:\n",
+       "\n",
+       "1. **Direct manufacturing with tiered pricing**: Manufacture independently but implement income-based pricing to maximize access while maintaining sustainability\n",
+       "\n",
+       "2. **Conditional licensing**: License the formula with contractual price controls, distribution requirements, and accessibility guarantees\n",
+       "\n",
+       "3. **Public-private partnership**: Collaborate with governments, NGOs, and selected pharmaceutical partners to ensure broad, affordable access\n",
+       "\n",
+       "4. **Open-source approach**: Release the formula publicly with certain patent protections waived, while establishing a foundation to support manufacturing\n",
+       "\n",
+       "5. **Hybrid distribution model**: Manufacture for highest-need populations while licensing to reach others, using licensing revenues to subsidize direct manufacturing\n",
+       "\n",
+       "## Case Study Context\n",
+       "\n",
+       "Similar dilemmas have occurred with treatments for HIV/AIDS, hepatitis C, and rare genetic disorders. The outcomes suggest:\n",
+       "\n",
+       "- Maintaining some control over intellectual property while ensuring broad access often yields better public health outcomes than either extreme option\n",
+       "- Patient advocacy can significantly influence corporate behavior and pricing\n",
+       "- International differences in pricing and patent enforcement create complex dynamics\n",
+       "- Government intervention through negotiation, compulsory licensing, or regulation often becomes necessary\n",
+       "\n",
+       "## Systems-Level Considerations\n",
+       "\n",
+       "This dilemma exists within broader systemic issues:\n",
+       "\n",
+       "- The current pharmaceutical development model creates inherent tensions between innovation, access, and affordability\n",
+       "- Rare disease treatments highlight market failures in drug development\n",
+       "- Healthcare financing systems vary globally, affecting how we should evaluate \"accessibility\"\n",
+       "- Intellectual property regimes may require reform to better balance innovation incentives with public health needs\n",
+       "\n",
+       "## Recommended Approach\n",
+       "\n",
+       "The philanthropist should pursue a hybrid strategy that:\n",
+       "\n",
+       "1. Maintains sufficient control to ensure the most vulnerable patients receive treatment regardless of ability to pay\n",
+       "\n",
+       "2. Leverages partnerships with multiple entities (pharmaceutical companies, governments, NGOs) to maximize production scale and geographic reach\n",
+       "\n",
+       "3. Implements contractual safeguards on pricing, with particular attention to low and middle-income regions\n",
+       "\n",
+       "4. Establishes a patient assistance foundation using a portion of any licensing revenues\n",
+       "\n",
+       "5. Advocates for systemic reforms that would prevent such dilemmas in the future\n",
+       "\n",
+       "This approach recognizes that the philanthropist's responsibility extends beyond the immediate distribution decision to include consideration of precedent-setting effects, stakeholder equity, and systemic change—balancing immediate needs with long-term public health impact."
+      ],
+      "text/plain": [
+       "<IPython.core.display.Markdown object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "==================================================\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Apply Reflection Pattern\n",
+    "reflected_responses = {}\n",
+    "\n",
+    "print(\"\\n=== RESPONSES AFTER REFLECTION ===\\n\")\n",
+    "\n",
+    "for model_name, client, is_anthropic in models:\n",
+    "    if client and model_name in initial_responses:\n",
+    "        try:\n",
+    "            reflected = apply_reflection_pattern(\n",
+    "                client, model_name, question, \n",
+    "                initial_responses[model_name], is_anthropic\n",
+    "            )\n",
+    "            reflected_responses[model_name] = reflected\n",
+    "            \n",
+    "            print(f\"**{model_name} - After Reflection:**\")\n",
+    "            display(Markdown(reflected))\n",
+    "            print(\"\\n\" + \"=\"*50 + \"\\n\")\n",
+    "        except Exception as e:\n",
+    "            print(f\"Error with reflection for {model_name}: {e}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Step 4: Comparative Evaluation (Extended Judge Pattern)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def create_comparative_evaluation(question, initial_responses, reflected_responses):\n",
+    "    \"\"\"Create a comparative evaluation of responses before/after reflection\"\"\"\n",
+    "    \n",
+    "    evaluation_prompt = f\"\"\"\n",
+    "You are evaluating the effectiveness of the \"Reflection Pattern\" on the following question:\n",
+    "{question}\n",
+    "\n",
+    "For each model, you have:\n",
+    "1. An initial response\n",
+    "2. A response after self-reflection\n",
+    "\n",
+    "Analyze and compare:\n",
+    "- Depth of analysis\n",
+    "- Consideration of multiple perspectives\n",
+    "- Nuance and sophistication of reasoning\n",
+    "- Improvement brought by reflection\n",
+    "\n",
+    "MODELS TO EVALUATE:\n",
+    "\"\"\"\n",
+    "    \n",
+    "    for model_name in initial_responses:\n",
+    "        if model_name in reflected_responses:\n",
+    "            evaluation_prompt += f\"\"\"\n",
+    "## {model_name}\n",
+    "\n",
+    "### Initial response:\n",
+    "{initial_responses[model_name][:500]}...\n",
+    "\n",
+    "### Response after reflection:\n",
+    "{reflected_responses[model_name][:800]}...\n",
+    "\n",
+    "\"\"\"\n",
+    "    \n",
+    "    evaluation_prompt += \"\"\"\n",
+    "Respond with structured JSON:\n",
+    "{\n",
+    "    \"general_analysis\": \"Your analysis of the Reflection Pattern's effectiveness\",\n",
+    "    \"initial_ranking\": [\"best initially ranked model\", \"second\", \"third\"],\n",
+    "    \"post_reflection_ranking\": [\"best ranked model after reflection\", \"second\", \"third\"],\n",
+    "    \"most_improved\": \"Which model improved the most\",\n",
+    "    \"insights\": \"Insights about the usefulness of the Reflection Pattern\"\n",
+    "}\n",
+    "\"\"\"\n",
+    "    \n",
+    "    return evaluation_prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "=== FINAL EVALUATION ===\n",
+      "\n",
+      "```json\n",
+      "{\n",
+      "    \"general_analysis\": \"The Reflection Pattern effectively enhanced the depth of analysis and consideration of multiple perspectives in both models. However, the results differ in terms of sophistication and detail. The GPT-4 model provided initial observations that were relatively shallow but improved by incorporating logistical challenges and suggesting compromises during reflection. In contrast, Claude-3's initial response was more structured and sophisticated, covering a broader range of ethical frameworks, but still showed room for improvement regarding stakeholder analysis and long-term impacts.\",\n",
+      "    \"initial_ranking\": [\"claude-3-7-sonnet-latest\", \"gpt-4o-mini\"],\n",
+      "    \"post_reflection_ranking\": [\"claude-3-7-sonnet-latest\", \"gpt-4o-mini\"],\n",
+      "    \"most_improved\": \"gpt-4o-mini\",\n",
+      "    \"insights\": \"The Reflection Pattern revealed significant gaps in both models' initial analyses, encouraging deeper engagement with ethical implications and stakeholder considerations. It highlighted the importance of reflecting on logistical realities and the real-world impacts of decisions, marking it as a worthwhile practice for ethical dilemmas.\"\n",
+      "}\n",
+      "```\n",
+      "Could not parse JSON, raw output shown above\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Final evaluation\n",
+    "if initial_responses and reflected_responses:\n",
+    "    evaluation_prompt = create_comparative_evaluation(question, initial_responses, reflected_responses)\n",
+    "    \n",
+    "    judge_messages = [{\"role\": \"user\", \"content\": evaluation_prompt}]\n",
+    "    \n",
+    "    try:\n",
+    "        judge_response = openai_client.chat.completions.create(\n",
+    "            model=\"gpt-4o-mini\",\n",
+    "            messages=judge_messages,\n",
+    "        )\n",
+    "        \n",
+    "        evaluation_result = judge_response.choices[0].message.content\n",
+    "        print(\"\\n=== FINAL EVALUATION ===\\n\")\n",
+    "        print(evaluation_result)\n",
+    "        \n",
+    "        # Try to parse JSON for structured display\n",
+    "        try:\n",
+    "            eval_json = json.loads(evaluation_result)\n",
+    "            print(\"\\n=== STRUCTURED RESULTS ===\\n\")\n",
+    "            for key, value in eval_json.items():\n",
+    "                print(f\"{key.replace('_', ' ').title()}: {value}\")\n",
+    "        except:\n",
+    "            print(\"Could not parse JSON, raw output shown above\")\n",
+    "            \n",
+    "    except Exception as e:\n",
+    "        print(f\"Error during final evaluation: {e}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Simple Before/After Comparison"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "=== BEFORE vs AFTER COMPARISON ===\n",
+      "\n",
+      "\n",
+      "==================== GPT-4O-MINI ====================\n",
+      "\n",
+      "BEFORE REFLECTION:\n",
+      "--------------------------------------------------\n",
+      "This ethical dilemma presents a challenging decision for the philanthropist, who must weigh the immediate health needs of a few individuals against the broader societal implications of drug distribution and access.\n",
+      "\n",
+      "### Option 1: Prioritizing Immediate Health\n",
+      "\n",
+      "If the philanthropist chooses to manufa...\n",
+      "\n",
+      "AFTER REFLECTION:\n",
+      "--------------------------------------------------\n",
+      "This ethical dilemma presents the philanthropist with a complex decision regarding how best to utilize limited resources to maximize the benefit for individuals suffering from a rare but fatal disease. The two primary options – providing a low-cost supply to a select few or selling the formula for broader but costly distribution – both highlight significant ethical considerations.\n",
+      "\n",
+      "### Option 1: P...\n",
+      "\n",
+      "======================================================================\n",
+      "\n",
+      "\n",
+      "==================== CLAUDE-3-7-SONNET-LATEST ====================\n",
+      "\n",
+      "BEFORE REFLECTION:\n",
+      "--------------------------------------------------\n",
+      "# The Philanthropist's Dilemma\n",
+      "\n",
+      "This is a complex ethical dilemma that involves several important considerations:\n",
+      "\n",
+      "## Key Ethical Tensions\n",
+      "\n",
+      "- **Limited access at affordable prices** vs. **wider access at unaffordable prices**\n",
+      "- **Immediate relief for a few** vs. **potential long-term access for many...\n",
+      "\n",
+      "AFTER REFLECTION:\n",
+      "--------------------------------------------------\n",
+      "# The Philanthropist's Dilemma: A Multidimensional Ethical Analysis\n",
+      "\n",
+      "This scenario presents not simply a binary choice but a complex ethical landscape involving multiple stakeholders, systemic factors, and competing values.\n",
+      "\n",
+      "## Stakeholder Analysis\n",
+      "\n",
+      "**Patients and families:**\n",
+      "- Those currently suffering need immediate access regardless of mechanism\n",
+      "- Future patients have interests in sustainable d...\n",
+      "\n",
+      "======================================================================\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Display side-by-side comparison for each model\n",
+    "print(\"\\n=== BEFORE vs AFTER COMPARISON ===\\n\")\n",
+    "\n",
+    "for model_name in initial_responses:\n",
+    "    if model_name in reflected_responses:\n",
+    "        print(f\"\\n{'='*20} {model_name.upper()} {'='*20}\\n\")\n",
+    "        \n",
+    "        print(\"BEFORE REFLECTION:\")\n",
+    "        print(\"-\" * 50)\n",
+    "        print(initial_responses[model_name][:300] + \"...\")\n",
+    "        \n",
+    "        print(\"\\nAFTER REFLECTION:\")\n",
+    "        print(\"-\" * 50)\n",
+    "        # Extract just the \"Improved Response\" section if it exists\n",
+    "        reflected = reflected_responses[model_name]\n",
+    "        if \"## Improved Response\" in reflected:\n",
+    "            improved_section = reflected.split(\"## Improved Response\")[1].strip()\n",
+    "            print(improved_section[:400] + \"...\")\n",
+    "        else:\n",
+    "            print(reflected[:400] + \"...\")\n",
+    "        \n",
+    "        print(\"\\n\" + \"=\"*70 + \"\\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;\">Pattern Analysis</h2>\n",
+    "            <span style=\"color:#ff7800;\">\n",
+    "            <b>Patterns used:</b><br/>\n",
+    "            1. <b>Multi-Model Comparison:</b> Comparing multiple models on the same task<br/>\n",
+    "            2. <b>Judge/Evaluator:</b> Using a model to evaluate performances<br/>\n",
+    "            3. <b>Reflection (NEW):</b> Self-critique and improvement of responses<br/><br/>\n",
+    "            <b>Possible experiments:</b><br/>\n",
+    "            - Iterate the Reflection Pattern multiple times<br/>\n",
+    "            - Add a \"Debate Pattern\" between models<br/>\n",
+    "            - Implement a \"Consensus 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 Applications</h2>\n",
+    "            <span style=\"color:#00bfff;\">\n",
+    "            The <b>Reflection Pattern</b> is particularly valuable for:<br/>\n",
+    "            • Improving quality of complex analyses<br/>\n",
+    "            • Reducing bias in AI recommendations<br/>\n",
+    "            • Creating self-improving systems<br/>\n",
+    "            • Developing more robust AI for critical decisions<br/><br/>\n",
+    "            Use cases: Strategic consulting, risk analysis, ethical evaluation, medical diagnosis\n",
+    "            </span>\n",
+    "        </td>\n",
+    "    </tr>\n",
+    "</table>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Additional Pattern Ideas for Future Implementation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Exercise completed! Analyze the results to see the impact of the Reflection Pattern.\n"
+     ]
+    }
+   ],
+   "source": [
+    "# 1. Chain of Thought Pattern\n",
+    "\"\"\"\n",
+    "Add a pattern that asks models to show their reasoning step by step:\n",
+    "\n",
+    "def apply_chain_of_thought_pattern(client, question):\n",
+    "    prompt = f\\\"\n",
+    "    Question: {question}\n",
+    "    \n",
+    "    Please think through this step by step:\n",
+    "    Step 1: [Identify the key issues]\n",
+    "    Step 2: [Consider different perspectives]\n",
+    "    Step 3: [Evaluate potential consequences]\n",
+    "    Step 4: [Provide reasoned conclusion]\n",
+    "    \\\"\n",
+    "    return get_response(client, prompt)\n",
+    "\"\"\"\n",
+    "\n",
+    "# 2. Iterative Refinement Pattern\n",
+    "\"\"\"\n",
+    "Create a loop that progressively improves the response over multiple iterations:\n",
+    "\n",
+    "def iterative_refinement(client, question, iterations=3):\n",
+    "    response = get_initial_response(client, question)\n",
+    "    for i in range(iterations):\n",
+    "        critique_prompt = f\\\"Improve this response: {response}\\\"\n",
+    "        response = get_response(client, critique_prompt)\n",
+    "    return response\n",
+    "\"\"\"\n",
+    "\n",
+    "# 3. Debate Pattern\n",
+    "\"\"\"\n",
+    "Make two models debate their respective responses:\n",
+    "\n",
+    "def create_debate(client1, client2, question):\n",
+    "    response1 = get_response(client1, question)\n",
+    "    response2 = get_response(client2, question)\n",
+    "    \n",
+    "    debate_prompt1 = f\\\"Argue against this position: {response2}\\\"\n",
+    "    debate_prompt2 = f\\\"Argue against this position: {response1}\\\"\n",
+    "    \n",
+    "    counter1 = get_response(client1, debate_prompt1)\n",
+    "    counter2 = get_response(client2, debate_prompt2)\n",
+    "    \n",
+    "    return counter1, counter2\n",
+    "\"\"\"\n",
+    "\n",
+    "# 4. Consensus Building Pattern\n",
+    "\"\"\"\n",
+    "Attempt to create a consensus response based on all individual responses:\n",
+    "\n",
+    "def build_consensus(all_responses, question):\n",
+    "    consensus_prompt = f\\\"\n",
+    "    Original question: {question}\n",
+    "    \n",
+    "    Here are multiple expert responses:\n",
+    "    {all_responses}\n",
+    "    \n",
+    "    Create a consensus response that incorporates the best insights from all responses\n",
+    "    while resolving contradictions.\n",
+    "    \\\"\n",
+    "    return get_response(openai_client, consensus_prompt)\n",
+    "\"\"\"\n",
+    "\n",
+    "print(\"Exercise completed! Analyze the results to see the impact of the Reflection Pattern.\")"
+   ]
+  }
+ ],
+ "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": 4
+}

community_contributions/2_lab2_six-thinking-hats-simulator.ipynb

@@ -0,0 +1,457 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Six Thinking Hats Simulator\n",
+    "\n",
+    "## Objective\n",
+    "This notebook implements a simulator of the Six Thinking Hats technique to evaluate and improve technological solutions. The simulator will:\n",
+    "\n",
+    "1. Use an LLM to generate an initial technological solution idea for a specific daily task in a company.\n",
+    "2. Apply the Six Thinking Hats methodology to analyze and improve the proposed solution.\n",
+    "3. Provide a comprehensive evaluation from different perspectives.\n",
+    "\n",
+    "## About the Six Thinking Hats Technique\n",
+    "\n",
+    "The Six Thinking Hats is a powerful technique developed by Edward de Bono that helps people look at problems and decisions from different perspectives. Each \"hat\" represents a different thinking approach:\n",
+    "\n",
+    "- **White Hat (Facts):** Focuses on available information, facts, and data.\n",
+    "- **Red Hat (Feelings):** Represents emotions, intuition, and gut feelings.\n",
+    "- **Black Hat (Critical):** Identifies potential problems, risks, and negative aspects.\n",
+    "- **Yellow Hat (Positive):** Looks for benefits, opportunities, and positive aspects.\n",
+    "- **Green Hat (Creative):** Encourages new ideas, alternatives, and possibilities.\n",
+    "- **Blue Hat (Process):** Manages the thinking process and ensures all perspectives are considered.\n",
+    "\n",
+    "In this simulator, we'll use these different perspectives to thoroughly evaluate and improve technological solutions proposed by an LLM."
+   ]
+  },
+  {
+   "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)"
+   ]
+  },
+  {
+   "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\")\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\")\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\")\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\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "request = \"Generate a technological solution to solve a specific workplace challenge. Choose an employee role, in a specific industry, and identify a time-consuming or error-prone daily task they face. Then, create an innovative yet practical technological solution that addresses this challenge. Include what technologies it uses (AI, automation, etc.), how it integrates with existing systems, its key benefits, and basic implementation requirements. Keep your solution realistic with current technology. \"\n",
+    "request += \"Answer only with the question, no explanation.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": request}]\n",
+    "\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",
+    "print(question)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "validation_prompt = f\"\"\"Validate and improve the following technological solution. For each iteration, check if the solution meets these criteria:\n",
+    "\n",
+    "1. Clarity:\n",
+    "   - Is the problem clearly defined?\n",
+    "   - Is the solution clearly explained?\n",
+    "   - Are the technical components well-described?\n",
+    "\n",
+    "2. Specificity:\n",
+    "   - Are there specific examples or use cases?\n",
+    "   - Are the technologies and tools specifically named?\n",
+    "   - Are the implementation steps detailed?\n",
+    "\n",
+    "3. Context:\n",
+    "   - Is the industry/company context clear?\n",
+    "   - Are the user roles and needs well-defined?\n",
+    "   - Is the current workflow/problem well-described?\n",
+    "\n",
+    "4. Constraints:\n",
+    "   - Are there clear technical limitations?\n",
+    "   - Are there budget/time constraints mentioned?\n",
+    "   - Are there integration requirements specified?\n",
+    "\n",
+    "If any of these criteria are not met, improve the solution by:\n",
+    "1. Adding missing details\n",
+    "2. Clarifying ambiguous points\n",
+    "3. Providing more specific examples\n",
+    "4. Including relevant constraints\n",
+    "\n",
+    "Here is the technological solution to validate and improve:\n",
+    "{question} \n",
+    "Provide an improved version that addresses any missing or unclear aspects. If this is the 5th iteration, return the final improved version without further changes.\n",
+    "\n",
+    "Response only with the Improved Solution:\n",
+    "[Your improved solution here]\"\"\"\n",
+    "\n",
+    "messages = [{\"role\": \"user\", \"content\": validation_prompt}]\n",
+    "\n",
+    "response = openai.chat.completions.create(model=\"gpt-4o\", messages=messages)\n",
+    "question = response.choices[0].message.content\n",
+    "\n",
+    "display(Markdown(question))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "In this section, we will ask each AI model to analyze a technological solution using the Six Thinking Hats methodology. Each model will:\n",
+    "\n",
+    "1. First generate a technological solution for a workplace challenge\n",
+    "2. Then analyze that solution using each of the Six Thinking Hats\n",
+    "\n",
+    "Each model will provide:\n",
+    "1. An initial technological solution\n",
+    "2. A structured analysis using all six thinking hats\n",
+    "3. A final recommendation based on the comprehensive analysis\n",
+    "\n",
+    "This approach will allow us to:\n",
+    "- Compare how different models apply the Six Thinking Hats methodology\n",
+    "- Identify patterns and differences in their analytical approaches\n",
+    "- Gather diverse perspectives on the same solution\n",
+    "- Create a rich, multi-faceted evaluation of each proposed technological solution\n",
+    "\n",
+    "The responses will be collected and displayed below, showing how each model applies the Six Thinking Hats methodology to evaluate and improve the proposed solutions."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "models = []\n",
+    "answers = []\n",
+    "combined_question = f\" Analyze the technological solution prposed in {question} using the Six Thinking Hats methodology. For each hat, provide a detailed analysis. Finally, provide a comprehensive recommendation based on all the above analyses.\"\n",
+    "messages = [{\"role\": \"user\", \"content\": combined_question}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# GPT thinking process\n",
+    "\n",
+    "model_name = \"gpt-4o\"\n",
+    "\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",
+    "models.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Claude thinking process\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",
+    "models.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Gemini thinking process\n",
+    "\n",
+    "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",
+    "models.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Deepseek thinking process\n",
+    "\n",
+    "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",
+    "models.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Groq thinking process\n",
+    "\n",
+    "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",
+    "models.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!ollama pull llama3.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Ollama thinking process\n",
+    "\n",
+    "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",
+    "models.append(model_name)\n",
+    "answers.append(answer)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "for model, answer in zip(models, answers):\n",
+    "    print(f\"Model: {model}\\n\\n{answer}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Next Step: Solution Synthesis and Enhancement\n",
+    "\n",
+    "**Best Recommendation Selection and Extended Solution Development**\n",
+    "\n",
+    "After applying the Six Thinking Hats analysis to evaluate the initial technological solution from multiple perspectives, the simulator will:\n",
+    "\n",
+    "1. **Synthesize Analysis Results**: Compile insights from all six thinking perspectives (White, Red, Black, Yellow, Green, and Blue hats) to identify the most compelling recommendations and improvements.\n",
+    "\n",
+    "2. **Select Optimal Recommendation**: Using a weighted evaluation system that considers feasibility, impact, and alignment with organizational goals, the simulator will identify and present the single best recommendation that emerged from the Six Thinking Hats analysis.\n",
+    "\n",
+    "3. **Generate Extended Solution**: Building upon the selected best recommendation, the simulator will create a comprehensive, enhanced version of the original technological solution that incorporates:\n",
+    "  - Key insights from the critical analysis (Black Hat)\n",
+    "  - Positive opportunities identified (Yellow Hat)\n",
+    "  - Creative alternatives and innovations (Green Hat)\n",
+    "  - Factual considerations and data requirements (White Hat)\n",
+    "  - User experience and emotional factors (Red Hat)\n",
+    "\n",
+    "4. **Multi-Model Enhancement**: To further strengthen the solution, the simulator will leverage additional AI models or perspectives to provide supplementary recommendations that complement the Six Thinking Hats analysis, offering a more robust and well-rounded final technological solution.\n",
+    "\n",
+    "This step transforms the analytical insights into actionable improvements, delivering a refined solution that has been thoroughly evaluated and enhanced through structured critical thinking."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "together = \"\"\n",
+    "for index, answer in enumerate(answers):\n",
+    "    together += f\"# Response from model {index+1}\\n\\n\"\n",
+    "    together += answer + \"\\n\\n\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import Markdown, display\n",
+    "import re\n",
+    "\n",
+    "print(f\"Each model has been given this technological solution to analyze: {question}\")\n",
+    "\n",
+    "# First, get the best individual response\n",
+    "judge_prompt = f\"\"\"\n",
+    "    You are judging the quality of {len(models)} responses.\n",
+    "    Evaluate each response based on:\n",
+    "    1. Clarity and coherence\n",
+    "    2. Depth of analysis\n",
+    "    3. Practicality of recommendations\n",
+    "    4. Originality of insights\n",
+    "    \n",
+    "    Rank the responses from best to worst.\n",
+    "    Respond with the model index of the best response, nothing else.\n",
+    "    \n",
+    "    Here are the responses:\n",
+    "    {answers}\n",
+    "    \"\"\"\n",
+    "    \n",
+    "# Get the best response\n",
+    "judge_response = openai.chat.completions.create(\n",
+    "    model=\"o3-mini\",\n",
+    "    messages=[{\"role\": \"user\", \"content\": judge_prompt}]\n",
+    ")\n",
+    "best_response = judge_response.choices[0].message.content\n",
+    "\n",
+    "print(f\"Best Response's Model: {models[int(best_response)]}\")\n",
+    "\n",
+    "synthesis_prompt = f\"\"\"\n",
+    "    Here is the best response's model index from the judge:\n",
+    "\n",
+    "    {best_response}\n",
+    "\n",
+    "    And here are the responses from all the models:\n",
+    "\n",
+    "    {together}\n",
+    "\n",
+    "    Synthesize the responses from the non-best models into one comprehensive answer that:\n",
+    "    1. Captures the best insights from each response that could add value to the best response from the judge\n",
+    "    2. Resolves any contradictions between responses before extending the best response\n",
+    "    3. Presents a clear and coherent final answer that is a comprehensive extension of the best response from the judge\n",
+    "    4. Maintains the same format as the original best response from the judge\n",
+    "    5. Compiles all additional recommendations mentioned by all models\n",
+    "\n",
+    "    Show the best response {answers[int(best_response)]} and then your synthesized response specifying which are additional recommendations to the best response:\n",
+    "    \"\"\"\n",
+    "\n",
+    "# Get the synthesized response\n",
+    "synthesis_response = claude.messages.create(\n",
+    "    model=\"claude-3-7-sonnet-latest\",\n",
+    "    messages=[{\"role\": \"user\", \"content\": synthesis_prompt}],\n",
+    "    max_tokens=10000\n",
+    ")\n",
+    "synthesized_answer = synthesis_response.content[0].text\n",
+    "\n",
+    "converted_answer = re.sub(r'\\\\[\\[\\]]', '$$', synthesized_answer)\n",
+    "display(Markdown(converted_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.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/3_lab3_groq_llama_generator_gemini_evaluator.ipynb

@@ -0,0 +1,286 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Chat app with LinkedIn Profile Information - Groq LLama as Generator and Gemini as evaluator\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 58,
+   "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",
+    "from groq import Groq\n",
+    "import gradio as gr"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 59,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "load_dotenv(override=True)\n",
+    "groq = Groq()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 60,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "reader = PdfReader(\"me/My_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": 61,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with open(\"me/summary.txt\", \"r\", encoding=\"utf-8\") as f:\n",
+    "    summary = f.read()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 62,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "name = \"Maalaiappan Subramanian\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 63,
+   "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": 65,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def chat(message, history):\n",
+    "    # Below line is to remove the metadata and options from the history\n",
+    "    history = [{k: v for k, v in item.items() if k not in ('metadata', 'options')} for item in history]\n",
+    "    messages = [{\"role\": \"system\", \"content\": system_prompt}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = groq.chat.completions.create(model=\"llama-3.3-70b-versatile\", messages=messages)\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "gr.ChatInterface(chat, type=\"messages\").launch()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 67,
+   "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": 69,
+   "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": 70,
+   "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 += f\"Please evaluate the response, replying with whether it is acceptable and your feedback.\"\n",
+    "    return user_prompt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 71,
+   "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": 72,
+   "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": 73,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def rerun(reply, message, history, feedback):\n",
+    "    # Below line is to remove the metadata and options from the history\n",
+    "    history = [{k: v for k, v in item.items() if k not in ('metadata', 'options')} for item in history]\n",
+    "    updated_system_prompt = system_prompt + f\"\\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 = groq.chat.completions.create(model=\"llama-3.3-70b-versatile\", messages=messages)\n",
+    "    return response.choices[0].message.content"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 74,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def chat(message, history):\n",
+    "    if \"personal\" in message:\n",
+    "        system = system_prompt + \"\\n\\nEverything in your reply needs to be in Gen Z language - \\\n",
+    "              it is mandatory that you respond only and entirely in Gen Z language\"\n",
+    "    else:\n",
+    "        system = system_prompt\n",
+    "    # Below line is to remove the metadata and options from the history\n",
+    "    history = [{k: v for k, v in item.items() if k not in ('metadata', 'options')} for item in history]\n",
+    "    messages = [{\"role\": \"system\", \"content\": system}] + history + [{\"role\": \"user\", \"content\": message}]\n",
+    "    response = groq.chat.completions.create(model=\"llama-3.3-70b-versatile\", 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.10"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/4_lab4_slack.ipynb

@@ -0,0 +1,469 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## The first big project - Professionally You!\n",
+    "\n",
+    "### And, Tool use.\n",
+    "\n",
+    "### But first: introducing Slack\n",
+    "\n",
+    "Slack 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://api.slack.com and sign up for a free account, and create your new workspace and app.\n",
+    "\n",
+    "1. Create a Slack App:\n",
+    "- Go to the [Slack API portal](https://api.slack.com/apps) and click Create New App.\n",
+    "- Choose From scratch, provide an App Name (e.g., \"CustomerNotifier\"), and select the Slack workspace where you want to - install the app.\n",
+    "- Click Create App.\n",
+    "\n",
+    "2. Add Required Permissions (Scopes):\n",
+    "- Navigate to OAuth & Permissions in the left sidebar of your app’s management page.\n",
+    "- Under Bot Token Scopes, add the chat:write scope to allow your app to post messages. If you need to send direct messages (DMs) to users, also add im:write and users:read to fetch user IDs.\n",
+    "- If you plan to post to specific channels, ensure the app has permissions like channels:write or groups:write for public or private channels, respectively.\n",
+    "\n",
+    "3. Install the App to Your Workspace:\n",
+    "- In the OAuth & Permissions section, click Install to Workspace.\n",
+    "- Authorize the app, selecting the channel where it will post messages (if using incoming webhooks) or granting the necessary permissions.\n",
+    "- After installation, you’ll receive a Bot User OAuth Token (starts with xoxb-). Copy this token, as it will be used for - API authentication. Keep it secure and avoid hardcoding it in your source code.\n",
+    "\n",
+    "(This is so you could choose to organize your push notifications into different apps in the future.)\n",
+    "\n",
+    "4. Create a new private channel in slack App\n",
+    "- Opt to use Private Access\n",
+    "- After creating the private channel, type \"@<your bot name in step 1>\" to allow slack default bot to invite the bot into your chat\n",
+    "- Go to \"About\" of your private chat. Copy the channel Id at the bottom\n",
+    "\n",
+    "5. Install slack_sdk==3.35.0 into your env\n",
+    "```\n",
+    "uv pip install slack_sdk==3.35.0\n",
+    "```\n",
+    "\n",
+    "Add to your `.env` file:\n",
+    "```\n",
+    "SLACK_AGENT_CHANNEL_ID=put_your_user_token_here\n",
+    "SLACK_BOT_AGENT_OAUTH_TOKEN=put_the_oidc_token_here\n",
+    "```\n",
+    "\n",
+    "And install the Slack app on your phone."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "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\n",
+    "from slack_sdk import WebClient\n",
+    "from slack_sdk.errors import SlackApiError"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The usual start\n",
+    "\n",
+    "load_dotenv(override=True)\n",
+    "openai = OpenAI()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# For slack\n",
+    "\n",
+    "slack_channel_id:str = str(os.getenv(\"SLACK_AGENT_CHANNEL_ID\"))\n",
+    "slack_oauth_token = os.getenv(\"SLACK_BOT_AGENT_OAUTH_TOKEN\")\n",
+    "slack_client = WebClient(token=slack_oauth_token)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def push(message):\n",
+    "    print(f\"Push: {message}\")\n",
+    "    response = slack_client.chat_postMessage(\n",
+    "                    channel=slack_channel_id,\n",
+    "                    text=message\n",
+    "                )"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "push(\"HEY!!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "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": 15,
+   "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": 16,
+   "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": 17,
+   "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": 18,
+   "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": 20,
+   "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": 22,
+   "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": 23,
+   "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": 24,
+   "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": 25,
+   "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. Thank you student Robert M for improving these instructions.\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!  \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.\n",
+    "3. Take this token and add it to your .env file: `HF_TOKEN=hf_xxx` and see note below if this token doesn't seem to get picked up during deployment  \n",
+    "4. From the 1_foundations folder, enter: `uv run gradio deploy` and if for some reason this still wants you to enter your HF token, then interrupt it with ctrl+c and run this instead: `uv run dotenv -f ../.env run -- uv run gradio deploy` which forces your keys to all be set as environment variables   \n",
+    "5. 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",
+    "#### Extra note about the HuggingFace token\n",
+    "\n",
+    "A couple of students have mentioned the HuggingFace doesn't detect their token, even though it's in the .env file. Here are things to try:   \n",
+    "1. Restart Cursor   \n",
+    "2. Rerun load_dotenv(override=True) and use a new terminal (the + button on the top right of the Terminal)   \n",
+    "3. In the Terminal, run this before the gradio deploy: `$env:HF_TOKEN = \"hf_XXXX\"`  \n",
+    "Thank you James and Martins for these tips.  \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, delete the space, etc.\n",
+    "\n",
+    "#### And now you should be deployed!\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.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/4_lab4_spotify.ipynb

@@ -0,0 +1,829 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Adding a Spotify Tool - Musically You!\n",
+    "\n",
+    "This version of the notebook introduces a Spotify tool that can query your listening history from Spotify to extend the domain of questions the chatbot can answer to include your musical tastes.\n",
+    "\n",
+    "Unfortunately, it's a bit of PITA to get acess and refresh tokens for Spotify.  The process requires connecting to an authentication end point while logged in to Spotify and then processing a callback.  To make this easier, instructions along with a small app that can be deployed to HuggingFace Spaces using Gradio are included at the end of this notebook. "
+   ]
+  },
+  {
+   "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": 23,
+   "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": 24,
+   "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": 26,
+   "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": 27,
+   "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": 28,
+   "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": [
+    "# For Spotify access token and refresh token\n",
+    "import base64\n",
+    "import time\n",
+    "import hashlib\n",
+    "import secrets\n",
+    "import urllib.parse\n",
+    "\n",
+    "spotify_client_id = os.getenv(\"SPOTIFY_CLIENT_ID\")\n",
+    "spotify_client_secret = os.getenv(\"SPOTIFY_CLIENT_SECRET\")\n",
+    "\n",
+    "if spotify_client_id:\n",
+    "    print(f\"Spotify client ID found and starts with {spotify_client_id[:4]}\")\n",
+    "else:\n",
+    "    print(\"Spotify client ID not found\")\n",
+    "\n",
+    "if spotify_client_secret:\n",
+    "    print(f\"Spotify client secret found and starts with {spotify_client_secret[:4]}\")\n",
+    "else:\n",
+    "    print(\"Spotify client secret not found\")\n",
+    "\n",
+    "spotify_access_token = os.getenv(\"SPOTIFY_ACCESS_TOKEN\")\n",
+    "spotify_refresh_token = os.getenv(\"SPOTIFY_REFRESH_TOKEN\")\n",
+    "\n",
+    "if spotify_access_token and spotify_refresh_token:\n",
+    "    # Set expiry to past to force refresh on first use\n",
+    "    spotify_token_expiry = time.time() - 60\n",
+    "    print(\"Spotify tokens loaded from environment!\")\n",
+    "    print(f\"Access token preview: {spotify_access_token[:20]}...\")\n",
+    "    print(f\"Refresh token preview: {spotify_refresh_token[:20]}...\")\n",
+    "else:\n",
+    "    print(\"No Spotify tokens found in environment. Run spotify_flask_auth.py to get them.\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_spotify_access_token():\n",
+    "    global spotify_access_token, spotify_refresh_token, spotify_token_expiry\n",
+    "    \n",
+    "    # Check if we have a valid cached token\n",
+    "    if spotify_access_token and time.time() < spotify_token_expiry:\n",
+    "        return spotify_access_token\n",
+    "    \n",
+    "\n",
+    "    auth_url = \"https://accounts.spotify.com/api/token\"\n",
+    "    \n",
+    "    credentials = f\"{spotify_client_id}:{spotify_client_secret}\"\n",
+    "    encoded_credentials = base64.b64encode(credentials.encode()).decode()\n",
+    "    \n",
+    "    headers = {\n",
+    "        \"Authorization\": f\"Basic {encoded_credentials}\",\n",
+    "        \"Content-Type\": \"application/x-www-form-urlencoded\"\n",
+    "    }\n",
+    "    \n",
+    "    data = {\n",
+    "        \"grant_type\": \"refresh_token\",\n",
+    "        \"refresh_token\": spotify_refresh_token\n",
+    "    }\n",
+    "    \n",
+    "    response = requests.post(auth_url, headers=headers, data=data)\n",
+    "    \n",
+    "    if response.status_code == 200:\n",
+    "        token_data = response.json()\n",
+    "        spotify_access_token = token_data[\"access_token\"]\n",
+    "        # Update refresh token if a new one is provided\n",
+    "        if \"refresh_token\" in token_data:\n",
+    "            spotify_refresh_token = token_data[\"refresh_token\"]\n",
+    "        # Set expiry time with a buffer\n",
+    "        spotify_token_expiry = time.time() + token_data[\"expires_in\"] - 300\n",
+    "        return spotify_access_token\n",
+    "    else:\n",
+    "        print(f\"Failed to refresh Spotify access token: {response.status_code}\")\n",
+    "        print(f\"Response: {response.text}\")\n",
+    "        return None\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_user_top_items(item_type=\"artists\", time_range=\"medium_term\", limit=10):\n",
+    "    \"\"\"\n",
+    "    Get the user's top artists or tracks from Spotify.\n",
+    "    \n",
+    "    Args:\n",
+    "        item_type: 'artists' or 'tracks'\n",
+    "        time_range: 'short_term' (4 weeks), 'medium_term' (6 months), 'long_term' (several years)\n",
+    "        limit: Number of items to return (1-50)\n",
+    "    \n",
+    "    Returns:\n",
+    "        Dictionary with top items data\n",
+    "    \"\"\"\n",
+    "    token = get_spotify_access_token()\n",
+    "    if not token:\n",
+    "        return {\"error\": \"Failed to get Spotify access token\"}\n",
+    "    \n",
+    "    # Make API request\n",
+    "    url = f\"https://api.spotify.com/v1/me/top/{item_type}\"\n",
+    "    headers = {\n",
+    "        \"Authorization\": f\"Bearer {token}\"\n",
+    "    }\n",
+    "    params = {\n",
+    "        \"time_range\": time_range,\n",
+    "        \"limit\": limit\n",
+    "    }\n",
+    "    \n",
+    "    response = requests.get(url, headers=headers, params=params)\n",
+    "    \n",
+    "    if response.status_code == 200:\n",
+    "        data = response.json()\n",
+    "        \n",
+    "        formatted_items = []\n",
+    "        for idx, item in enumerate(data.get(\"items\", []), 1):\n",
+    "            if item_type == \"artists\":\n",
+    "                formatted_items.append({\n",
+    "                    \"rank\": idx,\n",
+    "                    \"name\": item[\"name\"],\n",
+    "                    \"genres\": item.get(\"genres\", []),\n",
+    "                    \"popularity\": item.get(\"popularity\", 0),\n",
+    "                    \"spotify_url\": item[\"external_urls\"][\"spotify\"]\n",
+    "                })\n",
+    "            else:  # tracks\n",
+    "                formatted_items.append({\n",
+    "                    \"rank\": idx,\n",
+    "                    \"name\": item[\"name\"],\n",
+    "                    \"artist\": item[\"artists\"][0][\"name\"] if item.get(\"artists\") else \"Unknown\",\n",
+    "                    \"album\": item[\"album\"][\"name\"] if item.get(\"album\") else \"Unknown\",\n",
+    "                    \"popularity\": item.get(\"popularity\", 0),\n",
+    "                    \"spotify_url\": item[\"external_urls\"][\"spotify\"]\n",
+    "                })\n",
+    "        \n",
+    "        return {\n",
+    "            \"item_type\": item_type,\n",
+    "            \"time_range\": time_range,\n",
+    "            \"count\": len(formatted_items),\n",
+    "            \"items\": formatted_items\n",
+    "        }\n",
+    "    else:\n",
+    "        return {\"error\": f\"Failed to get top items: {response.status_code} - {response.text}\"}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# lets test the tool\n",
+    "get_user_top_items(item_type=\"artists\", time_range=\"medium_term\", limit=3)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "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": 34,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "get_user_top_items_json = {\n",
+    "    \"name\": \"get_user_top_items\",\n",
+    "    \"description\": \"Get the user's top artists or tracks from Spotify based on their listening history\",\n",
+    "    \"parameters\": {\n",
+    "        \"type\": \"object\",\n",
+    "        \"properties\": {\n",
+    "            \"item_type\": {\n",
+    "                \"type\": \"string\",\n",
+    "                \"description\": \"Type of items to retrieve: 'artists' or 'tracks'\",\n",
+    "                \"enum\": [\"artists\", \"tracks\"]\n",
+    "            },\n",
+    "            \"time_range\": {\n",
+    "                \"type\": \"string\", \n",
+    "                \"description\": \"Time range for the data: 'short_term' (4 weeks), 'medium_term' (6 months), or 'long_term' (several years)\",\n",
+    "                \"enum\": [\"short_term\", \"medium_term\", \"long_term\"]\n",
+    "            },\n",
+    "            \"limit\": {\n",
+    "                \"type\": \"integer\",\n",
+    "                \"description\": \"Number of items to return (1-50)\",\n",
+    "                \"minimum\": 1,\n",
+    "                \"maximum\": 50\n",
+    "            }\n",
+    "        },\n",
+    "        \"required\": [\"item_type\", \"time_range\", \"limit\"],\n",
+    "        \"additionalProperties\": False\n",
+    "    }\n",
+    "}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 35,
+   "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": 36,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tools = [{\"type\": \"function\", \"function\": record_user_details_json},\n",
+    "        {\"type\": \"function\", \"function\": record_unknown_question_json},\n",
+    "        {\"type\": \"function\", \"function\": get_user_top_items_json}]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tools"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 38,
+   "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",
+    "        elif tool_name == \"get_user_top_items\":\n",
+    "            result = get_user_top_items(**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": 40,
+   "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": 41,
+   "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": 42,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# We've added a \"If they ask you about your tastes in music you can use your get_user_top_items tool...\" \n",
+    "\n",
+    "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 they ask you about your tastes in music you can use your get_user_top_items tool to get information about your top artists and tracks. \\\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": 43,
+   "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` 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": [
+    "## Spotify API Setup Instructions\n",
+    "\n",
+    "To use the Spotify tool in this notebook, you need will need to undergo a one-time setup process to obtain access and refresh tokens from Spotify.  This involve the following steps:\n",
+    "\n",
+    "1. **Create a Spotify App**:\n",
+    "   - Go to https://developer.spotify.com/dashboard\n",
+    "   - Click \"Create app\"\n",
+    "   - Fill in the app details\n",
+    "   - Set Redirect URI to: `https://your-username-your-space-name.hf.space/callback` (replace with your actual HuggingFace Space URL)\n",
+    "   - Save your Client ID and Client Secret\n",
+    "\n",
+    "2. **Add to your `.env` file**:\n",
+    "   ```\n",
+    "   SPOTIFY_CLIENT_ID=your_client_id_here\n",
+    "   SPOTIFY_CLIENT_SECRET=your_client_secret_here\n",
+    "   ```\n",
+    "\n",
+    "3. **Deploy and authenticate**:\n",
+    "   - Deploy the authentication app from the **Flask Authentication App for Spotify** cell below to HuggingFace Spaces\n",
+    "   - Visit your deployed app and click \"Authorize with Spotify\"\n",
+    "   - After authorizing, copy the tokens displayed\n",
+    "   - ONCE YOU HAVE HAVE OBTAINED YOUR ACCESS AND REFRESH TOKESNS YOU CAN DELETE THIS DEPLOYMENT\n",
+    "\n",
+    "4. **Add tokens to .env and reload**:\n",
+    "   ```\n",
+    "   SPOTIFY_ACCESS_TOKEN=your_access_token\n",
+    "   SPOTIFY_REFRESH_TOKEN=your_refresh_token\n",
+    "   ```\n",
+    "   Then run `load_dotenv(override=True)`\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Flask Authentication App for Spotify\n",
+    "\n",
+    "Deploy this code as `spotify_flask_auth.py` to HuggingFace Spaces using Gradio following the steps as above fro\n",
+    "app.py.  You need the following:\n",
+    "1. SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET defined in your environment\n",
+    "2. Need a requirements.txt with Flask listed as a dependency (no other dependencies are needed)\n",
+    "\n",
+    "```python\n",
+    "from flask import Flask, request, redirect, render_template_string\n",
+    "import requests\n",
+    "import base64\n",
+    "import os\n",
+    "from dotenv import load_dotenv\n",
+    "import urllib.parse\n",
+    "import secrets\n",
+    "import string\n",
+    "\n",
+    "load_dotenv(override=True)\n",
+    "\n",
+    "app = Flask(__name__)\n",
+    "app.secret_key = ''.join(secrets.choice(string.ascii_letters + string.digits) for _ in range(32))\n",
+    "\n",
+    "CLIENT_ID = os.getenv(\"SPOTIFY_CLIENT_ID\")\n",
+    "CLIENT_SECRET = os.getenv(\"SPOTIFY_CLIENT_SECRET\")\n",
+    "\n",
+    "REDIRECT_URI = f\"https://{os.getenv('SPACE_HOST')}/callback\"\n",
+    "SCOPE = \"user-top-read\"\n",
+    "tokens = {}\n",
+    "\n",
+    "# HTML template for the home page\n",
+    "HOME_TEMPLATE = \"\"\"\n",
+    "<!DOCTYPE html>\n",
+    "<html>\n",
+    "<head>\n",
+    "    <title>Spotify OAuth Helper</title>\n",
+    "</head>\n",
+    "<body>\n",
+    "    {% if has_credentials %}\n",
+    "        <div style=\"margin-bottom: 20px;\">\n",
+    "            <p>Make sure to add this redirect URI to your Spotify app settings:</p>\n",
+    "            <code>{{ redirect_uri }}</code>\n",
+    "        </div>\n",
+    "        <button onclick=\"window.open('https://accounts.spotify.com/authorize?client_id={{ client_id }}&response_type=code&redirect_uri={{ redirect_uri | urlencode }}&scope={{ scope | urlencode }}&show_dialog=true', '_blank')\">Authorize with Spotify</button>\n",
+    "    {% else %}\n",
+    "        <div>Missing Spotify credentials in .env file</div>\n",
+    "    {% endif %}\n",
+    "</body>\n",
+    "</html>\n",
+    "\"\"\"\n",
+    "\n",
+    "SUCCESS_TEMPLATE = \"\"\"\n",
+    "<!DOCTYPE html>\n",
+    "<html>\n",
+    "<head>\n",
+    "    <title>Spotify OAuth - Success!</title>\n",
+    "</head>\n",
+    "<body>\n",
+    "    <p>Authorization Complete</p>\n",
+    "    <h3>Add to your .env file:</h3>\n",
+    "    <pre>SPOTIFY_ACCESS_TOKEN={{ access_token }}\n",
+    "SPOTIFY_REFRESH_TOKEN={{ refresh_token }}</pre>\n",
+    "</body>\n",
+    "</html>\n",
+    "\"\"\"\n",
+    "\n",
+    "@app.route('/')\n",
+    "def home():\n",
+    "    error = request.args.get('error')\n",
+    "    has_credentials = CLIENT_ID and CLIENT_SECRET\n",
+    "    return render_template_string(HOME_TEMPLATE, error=error, has_credentials=has_credentials, redirect_uri=REDIRECT_URI, client_id=CLIENT_ID, scope=SCOPE)\n",
+    "\n",
+    "@app.route('/authorize')\n",
+    "def authorize():\n",
+    "    \"\"\"Redirect to Spotify authorization\"\"\"\n",
+    "    if not CLIENT_ID:\n",
+    "        return redirect('/?error=Missing SPOTIFY_CLIENT_ID')\n",
+    "    \n",
+    "    auth_url = \"https://accounts.spotify.com/authorize\"\n",
+    "    params = {\n",
+    "        \"client_id\": CLIENT_ID,\n",
+    "        \"response_type\": \"code\",\n",
+    "        \"redirect_uri\": REDIRECT_URI,\n",
+    "        \"scope\": SCOPE,\n",
+    "        \"show_dialog\": \"true\"\n",
+    "    }\n",
+    "    \n",
+    "    url = f\"{auth_url}?{urllib.parse.urlencode(params)}\"\n",
+    "    return redirect(url)\n",
+    "\n",
+    "@app.route('/callback')\n",
+    "def callback():\n",
+    "    \"\"\"Handle the OAuth callback\"\"\"\n",
+    "    error = request.args.get('error')\n",
+    "    if error:\n",
+    "        return redirect(f'/?error=Authorization failed: {error}')\n",
+    "    \n",
+    "    code = request.args.get('code')\n",
+    "    if not code:\n",
+    "        return redirect('/?error=No authorization code received')\n",
+    "    \n",
+    "    # Exchange code for tokens\n",
+    "    token_url = \"https://accounts.spotify.com/api/token\"\n",
+    "    \n",
+    "    credentials = f\"{CLIENT_ID}:{CLIENT_SECRET}\"\n",
+    "    encoded_credentials = base64.b64encode(credentials.encode()).decode()\n",
+    "    \n",
+    "    headers = {\n",
+    "        \"Authorization\": f\"Basic {encoded_credentials}\",\n",
+    "        \"Content-Type\": \"application/x-www-form-urlencoded\"\n",
+    "    }\n",
+    "    \n",
+    "    data = {\n",
+    "        \"grant_type\": \"authorization_code\",\n",
+    "        \"code\": code,\n",
+    "        \"redirect_uri\": REDIRECT_URI\n",
+    "    }\n",
+    "    \n",
+    "    response = requests.post(token_url, headers=headers, data=data)\n",
+    "    \n",
+    "    if response.status_code == 200:\n",
+    "        token_data = response.json()\n",
+    "        tokens['access_token'] = token_data['access_token']\n",
+    "        tokens['refresh_token'] = token_data['refresh_token']\n",
+    "        \n",
+    "        return render_template_string(\n",
+    "            SUCCESS_TEMPLATE,\n",
+    "            access_token=token_data['access_token'],\n",
+    "            refresh_token=token_data['refresh_token']\n",
+    "        )\n",
+    "    else:\n",
+    "        error_msg = response.json().get('error_description', 'Unknown error')\n",
+    "        return redirect(f'/?error=Token exchange failed: {error_msg}')\n",
+    "\n",
+    "if __name__ == '__main__':\n",
+    "    app.run(host='0.0.0.0', port=7860)\n",
+    "```\n",
+    "\n",
+    "**Deployment Instructions:**\n",
+    "1. You will need to provide `SPOTIFY_CLIENT_ID` and `SPOTIFY_CLIENT_SECRET` as secrets in HuggingFace Spaces\n",
+    "2. Create a `requirements.txt` file with a single entry: `Flask`\n",
+    "3. Deploy to HuggingFace Spaces using the instructions in the deployment section below"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "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;\">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.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/4_lab4_with_telegram.ipynb

@@ -0,0 +1,422 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Contributed by Faisal Alkheraiji\n",
+    "\n",
+    "LinkedIn: https://www.linkedin.com/in/faisalalkheraiji/\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## The first big project - Professionally You!\n",
+    "\n",
+    "### And, Tool use.\n",
+    "\n",
+    "### But first: introducing Telegram\n",
+    "\n",
+    "We need to do the following to get out Telegram chatbot working:\n",
+    "\n",
+    "1. Create new telegram bot using @BotFather.\n",
+    "2. Get our bot token.\n",
+    "3. Get your chat ID.\n",
+    "\n",
+    "For easy and quick tutorial, follow this great tutorial from our friend:\n",
+    "\n",
+    "https://chatgpt.com/share/686eccf4-34b0-8000-8f34-a3d9269e0578\n",
+    "\n",
+    "Then add 2 lines to your `.env` file:\n",
+    "\n",
+    "TELEGRAM*BOT_TOKEN=\\_your bot token*\n",
+    "\n",
+    "TELEGRAM*CHAT_ID=\\_your chat ID*\n"
+   ]
+  },
+  {
+   "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": [
+    "# Getting the Telegram bot token and chat ID from environment variables\n",
+    "# You can also replace these with your actual values directly\n",
+    "\n",
+    "TELEGRAM_BOT_TOKEN = os.getenv(\"TELEGRAM_BOT_TOKEN\", \"your_bot_token_here\")\n",
+    "TELEGRAM_CHAT_ID = os.getenv(\"TELEGRAM_CHAT_ID\", \"your_chat_id_here\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def send_telegram_message(text):\n",
+    "    url = f\"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage\"\n",
+    "    payload = {\"chat_id\": TELEGRAM_CHAT_ID, \"text\": text}\n",
+    "\n",
+    "    response = requests.post(url, data=payload)\n",
+    "\n",
+    "    if response.status_code == 200:\n",
+    "        # print(\"Message sent successfully!\")\n",
+    "        return {\"status\": \"success\", \"message\": text}\n",
+    "    else:\n",
+    "        # print(f\"Failed to send message. Status code: {response.status_code}\")\n",
+    "        # print(response.text)\n",
+    "        return {\"status\": \"error\", \"message\": response.text}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Example usage\n",
+    "send_telegram_message(\"Hello from python notebook !!\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def record_user_details(email, name=\"Name not provided\", notes=\"not provided\"):\n",
+    "    send_telegram_message(\n",
+    "        f\"Recording interest from {name} with email {email} and notes {notes}\"\n",
+    "    )\n",
+    "    return {\"recorded\": \"ok\"}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def record_unknown_question(question):\n",
+    "    send_telegram_message(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",
+    "            \"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 = [\n",
+    "    {\"type\": \"function\", \"function\": record_user_details_json},\n",
+    "    {\"type\": \"function\", \"function\": record_unknown_question_json},\n",
+    "]"
+   ]
+  },
+  {
+   "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",
+    "\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(\n",
+    "            {\n",
+    "                \"role\": \"tool\",\n",
+    "                \"content\": json.dumps(result),\n",
+    "                \"tool_call_id\": tool_call.id,\n",
+    "            }\n",
+    "        )\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",
+    "\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(\n",
+    "            {\n",
+    "                \"role\": \"tool\",\n",
+    "                \"content\": json.dumps(result),\n",
+    "                \"tool_call_id\": tool_call.id,\n",
+    "            }\n",
+    "        )\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 = (\n",
+    "        [{\"role\": \"system\", \"content\": system_prompt}]\n",
+    "        + history\n",
+    "        + [{\"role\": \"user\", \"content\": message}]\n",
+    "    )\n",
+    "    done = False\n",
+    "    while not done:\n",
+    "        # This is the call to the LLM - see that we pass in the tools json\n",
+    "\n",
+    "        response = openai.chat.completions.create(\n",
+    "            model=\"gpt-4o-mini\", messages=messages, tools=tools\n",
+    "        )\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(inbrowser=True)"
+   ]
+  },
+  {
+   "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>\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;\">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>\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.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/Business_Idea.ipynb

@@ -0,0 +1,388 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Business idea generator and evaluator \n",
+    "\n"
+   ]
+  },
+  {
+   "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 = (\n",
+    "    \"Please generate three innovative business ideas aligned with the latest global trends. \"\n",
+    "    \"For each idea, include a brief description (2–3 sentences).\"\n",
+    ")\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": [
+    "\n",
+    "openai = OpenAI()\n",
+    "'''\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": 9,
+   "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": "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": 14,
+   "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 was asked to generate three innovative business ideas aligned with the latest global trends.\n",
+    "\n",
+    "Your job is to evaluate the likelihood of success for each idea on a scale from 0 to 100 percent. For each competitor, list the three percentages in the same order as their ideas.\n",
+    "\n",
+    "Respond only with JSON in this format:\n",
+    "{{\"results\": [\n",
+    "    {{\"competitor\": 1, \"success_chances\": [perc1, perc2, perc3]}},\n",
+    "    {{\"competitor\": 2, \"success_chances\": [perc1, perc2, perc3]}},\n",
+    "    ...\n",
+    "]}}\n",
+    "\n",
+    "Here are the ideas from each competitor:\n",
+    "\n",
+    "{together}\n",
+    "\n",
+    "Now respond with only the JSON, nothing else.\"\"\"\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(judge)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "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": [
+    "# Parse judge results JSON and display success probabilities\n",
+    "results_dict = json.loads(results)\n",
+    "for entry in results_dict[\"results\"]:\n",
+    "    comp_num = entry[\"competitor\"]\n",
+    "    comp_name = competitors[comp_num - 1]\n",
+    "    chances = entry[\"success_chances\"]\n",
+    "    print(f\"{comp_name}:\")\n",
+    "    for idx, perc in enumerate(chances, start=1):\n",
+    "        print(f\"  Idea {idx}: {perc}% chance of success\")\n",
+    "    print()\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.7"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

community_contributions/ChatBot_with_evaluator_and_notifier/README.md

@@ -0,0 +1,97 @@
+# Smart RAG Chatbot
+
+A conversational AI that answers questions from your documents first, then falls back to general knowledge when needed. Plus, it keeps you in the loop with smart notifications.
+
+## What it does
+
+Think of it as your personal AI assistant that:
+- **Knows your stuff** - Searches your documents first to answer questions
+- **Stays helpful** - Uses general AI knowledge when your docs don't have the answer  
+- **Keeps you informed** - Sends notifications when it goes beyond your knowledge base
+- **Remembers conversations** - Maintains chat history and user details
+
+## How it works
+
+1. User asks a question
+2. System searches your documents in `knowledge_base/`
+3. **Found answer?** → Uses your docs and responds
+4. **No answer?** → Uses general AI knowledge + sends you a notification
+5. **Small talk?** → Quick friendly response
+
+## Architecture
+
+```
+User Question → Search Your Docs → ChatGPT Response → Gemini Quality Check
+                     ↓                                        ↓
+              If no relevant docs                    If using general knowledge
+                     ↓                                        ↓
+              General AI Knowledge ← ← ← ← ← ← ← ← Pushover Notification
+```
+
+**Components:**
+- **ChromaDB + LangChain**: Stores and searches your documents
+- **ChatGPT**: Generates responses
+- **Gemini**: Checks response quality  
+- **Pushover**: Sends notifications
+- **Gradio**: Simple web interface
+
+## Quick Setup
+
+1. **Install dependencies:**
+```bash
+pip install -r requirements.txt
+```
+
+2. **Create `.env` file with your API keys:**
+```bash
+OPENAI_API_KEY=your_openai_key
+GOOGLE_API_KEY=your_gemini_key
+PUSHOVER_USER=your_pushover_user  # optional
+PUSHOVER_TOKEN=your_pushover_token  # optional
+```
+
+3. **Add your documents:**
+Drop your `.txt`, `.md`, or `.markdown` files into the `knowledge_base/` folder
+
+4. **Launch:**
+```bash
+python app.py
+```
+
+That's it! The web interface opens automatically.
+
+## Key Features
+
+- **Smart fallback**: Uses your docs first, general knowledge second
+- **Quality control**: Built-in evaluator ensures good responses
+- **Conversation memory**: Remembers chat history and user details
+- **Smart notifications**: Only alerts when using general knowledge
+- **Simple setup**: Just API keys and documents
+
+## File Structure
+
+```
+├── app.py              # Web interface
+├── controller.py       # Main logic
+├── rag.py             # Document search
+├── evaluator.py       # Quality checking
+├── tools.py           # Notifications
+├── knowledge_base/    # Your documents
+└── .env               # API keys
+```
+
+## Example Usage
+
+**Question about your docs:**
+```
+User: "What's our return policy?"
+Bot: [Searches your docs] → [Finds policy] → [Answers from your content]
+```
+
+**General question:**
+```
+User: "What is machine learning?"
+Bot: [No docs found] → [Uses AI knowledge] → [Sends notification] → [Helpful explanation]
+```
+
+Built with ChromaDB, LangChain, OpenAI, Gemini, and Gradio.

community_contributions/ChatBot_with_evaluator_and_notifier/app.py

@@ -0,0 +1,30 @@
+import gradio as gr
+from controller import ChatbotController
+
+controller = ChatbotController()
+
+def respond(user_msg, history, recorded_emails_state):
+    history.append({"role": "user", "content": user_msg})
+    reply, emails = controller.get_response(
+        message=user_msg,
+        history=history,
+        name=None,
+        email=None,
+        recorded_emails=set(recorded_emails_state or []),
+    )
+    history.append({"role": "assistant", "content": reply})
+    return history, history, list(emails)
+
+with gr.Blocks(title="RAG Chat") as demo:
+    chat = gr.Chatbot(type="messages", min_height=600, label="Assistant")
+    msg = gr.Textbox(label="Your message", placeholder="Type here…")
+    history_state = gr.State([])
+    processed_emails_state = gr.State([])
+    msg.submit(
+        respond,
+        inputs=[msg, history_state, processed_emails_state],
+        outputs=[chat, history_state, processed_emails_state],
+    )
+    msg.submit(lambda: "", None, msg)
+
+demo.launch(inbrowser=True)

community_contributions/ChatBot_with_evaluator_and_notifier/career_db/6aee01b9-a616-491d-a196-c857cd862793/data_level0.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ea9ac6972cb4666769a17755f17c5727f676f11a742e9553bf3a21119ab54394
+size 167600

community_contributions/ChatBot_with_evaluator_and_notifier/career_db/6aee01b9-a616-491d-a196-c857cd862793/header.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a0e81c3b22454233bc12d0762f06dcca48261a75231cf87c79b75e69a6c00150
+size 100

community_contributions/ChatBot_with_evaluator_and_notifier/career_db/6aee01b9-a616-491d-a196-c857cd862793/length.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7a12e561363385e9dfeeab326368731c030ed4b374e7f5897ac819159d2884c5
+size 400

community_contributions/ChatBot_with_evaluator_and_notifier/career_db/chroma.sqlite3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:460534870e395f01413300a55f0ee89062d0ffa8102796eb6365b15c8c2b0063
+size 1597440

community_contributions/ChatBot_with_evaluator_and_notifier/chat.py

@@ -0,0 +1,45 @@
+import os
+import json
+from typing import List, Dict, Any
+from openai import OpenAI
+from dotenv import load_dotenv
+
+
+load_dotenv(override=True)
+
+MODEL = "gpt-4o-mini"
+
+
+class ChatGPTLLM:
+    def __init__(self, model: str = MODEL):
+        load_dotenv(override=True)
+        self.model = model
+        self.client = OpenAI()
+
+    def format_context_prompt(self, query: str, context: List[str]) -> str:
+        joined = "\n\n".join(context) if context else "(no context)"
+        return (
+            "You are a careful, concise assistant. Use ONLY the Context below.\n"
+            "If the answer is not present in the Context, reply exactly: I don't know.\n"
+            "Do not add external knowledge or speculate.\n\n"
+            f"Context:\n{joined}\n\n"
+            f"Question: {query}\n"
+            "Answer succinctly in 1-3 sentences."
+        )
+
+    def generate_response(self, query: str, context: List[str]) -> Dict[str, Any]:
+        try:
+            prompt = self.format_context_prompt(query, context)
+            messages = [
+                {"role": "system", "content": "Answer only from provided Context."},
+                {"role": "user", "content": prompt},
+            ]
+            resp = self.client.chat.completions.create(
+                model=self.model,
+                messages=messages
+            )
+            content = resp.choices[0].message.content
+            return {"text": content or "", "raw": json.loads(resp.model_dump_json())}
+        except Exception as e:
+            print(f"[llm1] error: {e}")
+            return {"error": str(e), "text": ""}