data_generation/5 Levels Of Summarization - Novice To Expert.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "fded102b",
   "metadata": {},
   "source": [
    "# 5 Levels Of Summarization: Novice to Expert"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "fab8b2cf",
   "metadata": {},
   "source": [
    "Summarization is a fundamental building block of many LLM tasks. You'll frequently run into use cases where you would like to distill a large body of text into a succinct set of points.\n",
    "\n",
    "Depending on the length of the text you'd like to summarize, you have different summarization methods to choose from.\n",
    "\n",
    "We're going to run through 5 methods for summarization that start with Novice and end up expert. These aren't the only options, feel free to make up your own. If you find another one you like please share it with the community.\n",
    "\n",
    "**5 Levels Of Summarization:**\n",
    "1. **Summarize a couple sentences** - Basic Prompt\n",
    "2. **Summarize a couple paragraphs** - Prompt Templates\n",
    "3. **Summarize a couple pages** - Map Reduce\n",
    "4. **Summarize an entire book** - Best Representation Vectors\n",
    "5. **Summarize an unknown amount of text** - Agents\n",
    "\n",
    "First let's import our OpenAI API Key (best practice is to have this as an environment variable but showing it here for clarity)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "4033ee5a",
   "metadata": {},
   "outputs": [],
   "source": [
    "openai_api_key = 'YourAPIKey'"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "342796d0",
   "metadata": {},
   "source": [
    "## Level 1: Basic Prompt - Summarize a couple sentences\n",
    "\n",
    "If you just have a few sentences you want to one-off summarize you can use a simple prompt and copy and paste your text.\n",
    "\n",
    "This method isn't scalable and only practical for a few use cases...the perfect level #1!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "8a6ea241",
   "metadata": {},
   "outputs": [],
   "source": [
    "from langchain import OpenAI"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "538ded7c",
   "metadata": {},
   "outputs": [],
   "source": [
    "llm = OpenAI(temperature=0, openai_api_key=openai_api_key)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b18ca4b1",
   "metadata": {},
   "source": [
    "The important part is to provide instructions for the LLM to know what to do. In thise case I'm telling the model I want a summary of the text below"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "67146e99",
   "metadata": {},
   "outputs": [],
   "source": [
    "prompt = \"\"\"\n",
    "Please provide a summary of the following text\n",
    "\n",
    "TEXT:\n",
    "Philosophy (from Greek: φιλοσοφία, philosophia, 'love of wisdom') \\\n",
    "is the systematized study of general and fundamental questions, \\\n",
    "such as those about existence, reason, knowledge, values, mind, and language. \\\n",
    "Some sources claim the term was coined by Pythagoras (c. 570 – c. 495 BCE), \\\n",
    "although this theory is disputed by some. Philosophical methods include questioning, \\\n",
    "critical discussion, rational argument, and systematic presentation.\n",
    "\"\"\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "id": "c3bd4858",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Our prompt has 121 tokens\n"
     ]
    }
   ],
   "source": [
    "num_tokens = llm.get_num_tokens(prompt)\n",
    "print (f\"Our prompt has {num_tokens} tokens\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "id": "61522722",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Philosophy is a systematized study of general and fundamental questions about existence, reason, knowledge, values, mind, and language. It is believed to have been coined by Pythagoras, and its methods include questioning, critical discussion, rational argument, and systematic presentation.\n"
     ]
    }
   ],
   "source": [
    "output = llm(prompt)\n",
    "print (output)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "133d1b40",
   "metadata": {},
   "source": [
    "Woof 🐶, that summary is still hard to understand. Let me add to my instructions so that the output is easier to understand. I'll tell it to explain it to me like a 5 year old."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "id": "ece0c069",
   "metadata": {},
   "outputs": [],
   "source": [
    "prompt = \"\"\"\n",
    "Please provide a summary of the following text.\n",
    "Please provide your output in a manner that a 5 year old would understand\n",
    "\n",
    "TEXT:\n",
    "Philosophy (from Greek: φιλοσοφία, philosophia, 'love of wisdom') \\\n",
    "is the systematized study of general and fundamental questions, \\\n",
    "such as those about existence, reason, knowledge, values, mind, and language. \\\n",
    "Some sources claim the term was coined by Pythagoras (c. 570 – c. 495 BCE), \\\n",
    "although this theory is disputed by some. Philosophical methods include questioning, \\\n",
    "critical discussion, rational argument, and systematic presentation.\n",
    "\"\"\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "id": "5b66351e",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Our prompt has 137 tokens\n"
     ]
    }
   ],
   "source": [
    "num_tokens = llm.get_num_tokens(prompt)\n",
    "print (f\"Our prompt has {num_tokens} tokens\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "id": "68f9b501",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Philosophy is about asking questions and trying to figure out the answers. It is about thinking about things like existence, knowledge, and values. People have been doing this for a very long time, and it is still done today.\n"
     ]
    }
   ],
   "source": [
    "output = llm(prompt)\n",
    "print (output)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6f294999",
   "metadata": {},
   "source": [
    "Nice! That's much better, but let's look at something we can automate a bit more"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "13f1cf66",
   "metadata": {},
   "source": [
    "## Level 2: Prompt Templates - Summarize a couple paragraphs\n",
    "\n",
    "Prompt templates are a great way to dynamically place text within your prompts. They are like [python f-strings](https://realpython.com/python-f-strings/) but specialized for working with language models.\n",
    "\n",
    "We're going to look at 2 short Paul Graham essays"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "id": "712acb03",
   "metadata": {},
   "outputs": [],
   "source": [
    "from langchain import OpenAI\n",
    "from langchain import PromptTemplate\n",
    "import os"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "id": "b326aaeb",
   "metadata": {},
   "outputs": [],
   "source": [
    "paul_graham_essays = ['../data/PaulGrahamEssaySmall/getideas.txt', '../data/PaulGrahamEssaySmall/noob.txt']\n",
    "\n",
    "essays = []\n",
    "\n",
    "for file_name in paul_graham_essays:\n",
    "    with open(file_name, 'r') as file:\n",
    "        essays.append(file.read())"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "529ad7c1",
   "metadata": {},
   "source": [
    "Let's print out a preview of the essays to see what they look like"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "id": "d7d93873",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Essay #1: January 2023(Someone fed my essays into GPT to make something that could answer\n",
      "questions based on them, then asked it where good ideas come from.  The\n",
      "answer was ok, but not what I would have said. This is what I would have said.)The way to get new ideas is to notice anomalies: what seems strange,\n",
      "\n",
      "\n",
      "Essay #2: January 2020When I was young, I thought old people had everything figured out.\n",
      "Now that I'm old, I know this isn't true.I constantly feel like a noob. It seems like I'm always talking to\n",
      "some startup working in a new field I know nothing about, or reading\n",
      "a book about a topic I don't understand well\n",
      "\n"
     ]
    }
   ],
   "source": [
    "for i, essay in enumerate(essays):\n",
    "    print (f\"Essay #{i+1}: {essay[:300]}\\n\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8e70a48e",
   "metadata": {},
   "source": [
    "Next let's create a prompt template which will hold our instructions and a placeholder for the essay. In this example I only want a 1 sentence summary to come back"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "id": "946c379a",
   "metadata": {},
   "outputs": [],
   "source": [
    "template = \"\"\"\n",
    "Please write a one sentence summary of the following text:\n",
    "\n",
    "{essay}\n",
    "\"\"\"\n",
    "\n",
    "prompt = PromptTemplate(\n",
    "    input_variables=[\"essay\"],\n",
    "    template=template\n",
    ")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "51b2611b",
   "metadata": {},
   "source": [
    "Then let's loop through the 2 essays and pass them to our LLM. I'm applying .strip() on the summaries to remove the white space on the front and back of the output"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "id": "f2038feb",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "This prompt + essay has 205 tokens\n",
      "Summary: Exploring anomalies at the frontiers of knowledge is the best way to generate new ideas.\n",
      "\n",
      "\n",
      "This prompt + essay has 500 tokens\n",
      "Summary: This text explores the idea that feeling like a \"noob\" is actually beneficial, as it is inversely correlated with actual ignorance and encourages us to discover new things.\n",
      "\n",
      "\n"
     ]
    }
   ],
   "source": [
    "for essay in essays:\n",
    "    summary_prompt = prompt.format(essay=essay)\n",
    "    \n",
    "    num_tokens = llm.get_num_tokens(summary_prompt)\n",
    "    print (f\"This prompt + essay has {num_tokens} tokens\")\n",
    "    \n",
    "    summary = llm(summary_prompt)\n",
    "    \n",
    "    print (f\"Summary: {summary.strip()}\")\n",
    "    print (\"\\n\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "49ae9a41",
   "metadata": {},
   "source": [
    "## Level 3: Map Reduce - Summarize a couple pages multiple pages\n",
    "\n",
    "If you have multiple pages you'd like to summarize, you'll likely run into a token limit. Token limits won't always be a problem, but it is good to know how to handle them if you run into the issue.\n",
    "\n",
    "The chain type \"Map Reduce\" is a method that helps with this. You first generate a summary of smaller chunks (that fit within the token limit) and then you get a summary of the summaries.\\\n",
    "\n",
    "Check out [this video](https://www.youtube.com/watch?v=f9_BWhCI4Zo) for more information on how chain types work"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "id": "c2ce6270",
   "metadata": {},
   "outputs": [],
   "source": [
    "from langchain import OpenAI\n",
    "from langchain.chains.summarize import load_summarize_chain\n",
    "from langchain.text_splitter import RecursiveCharacterTextSplitter"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "id": "c70352ae",
   "metadata": {},
   "outputs": [],
   "source": [
    "paul_graham_essay = '../data/PaulGrahamEssays/startupideas.txt'\n",
    "\n",
    "with open(paul_graham_essay, 'r') as file:\n",
    "    essay = file.read()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "bb6de34d",
   "metadata": {},
   "source": [
    "Let's see how many tokens are in this essay"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "id": "b133938a",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "9565"
      ]
     },
     "execution_count": 21,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "llm.get_num_tokens(essay)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "dc8ec39d",
   "metadata": {},
   "source": [
    "That's too many, let's split our text up into chunks so they fit into the prompt limit. I'm going a chunk size of 10,000 characters. \n",
    "\n",
    "> You can think of tokens as pieces of words used for natural language processing. For English text, **1 token is approximately 4 characters** or 0.75 words. As a point of reference, the collected works of Shakespeare are about 900,000 words or 1.2M tokens.\n",
    "\n",
    "This means the number of tokens we should expect is 10,000 / 4 = ~2,500 token chunks. But this will vary, each body of text/code will be different"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "id": "2e7c372b",
   "metadata": {},
   "outputs": [],
   "source": [
    "text_splitter = RecursiveCharacterTextSplitter(separators=[\"\\n\\n\", \"\\n\"], chunk_size=10000, chunk_overlap=500)\n",
    "\n",
    "docs = text_splitter.create_documents([essay])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "id": "f66569f0",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Now we have 5 documents and the first one has 2086 tokens\n"
     ]
    }
   ],
   "source": [
    "num_docs = len(docs)\n",
    "\n",
    "num_tokens_first_doc = llm.get_num_tokens(docs[0].page_content)\n",
    "\n",
    "print (f\"Now we have {num_docs} documents and the first one has {num_tokens_first_doc} tokens\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b61d49f5",
   "metadata": {},
   "source": [
    "Great, assuming that number of tokens is consistent in the other docs we should be good to go. Let's use LangChain's [load_summarize_chain](https://python.langchain.com/en/latest/use_cases/summarization.html) to do the `map_reducing` for us. We first need to initialize our chain"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "id": "b3b08c54",
   "metadata": {},
   "outputs": [],
   "source": [
    "summary_chain = load_summarize_chain(llm=llm, chain_type='map_reduce',\n",
    "#                                      verbose=True # Set verbose=True if you want to see the prompts being used\n",
    "                                    )"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "78c45721",
   "metadata": {},
   "source": [
    "Now actually run it"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "id": "ba73121e",
   "metadata": {},
   "outputs": [],
   "source": [
    "output = summary_chain.run(docs)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "id": "693acf9d",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "' Y Combinator explains that the best startup ideas come from looking for problems, preferably ones that the founders have themselves. It suggests looking in areas of expertise, talking to people about their needs, and looking for waves and gaps in the market. It also looks at how the space of careers has dangerous local maxima, and how the web was seen as a big deal by programmers in 1995. It suggests taking time to come up with an idea and that colleges should leave their students alone in the right way to help them start startups.'"
      ]
     },
     "execution_count": 26,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "output"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "3bc3a71e",
   "metadata": {},
   "source": [
    "This summary is a great start, but I'm more of a bullet point person. I want to get my final output in bullet point form.\n",
    "\n",
    "In order to do this I'm going to use custom promopts (like we did above) to instruct the model on what I want.\n",
    "\n",
    "The map_prompt is going to stay the same (just showing it for clarity), but I'll edit the combine_prompt."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "id": "7442e889",
   "metadata": {},
   "outputs": [],
   "source": [
    "map_prompt = \"\"\"\n",
    "Write a concise summary of the following:\n",
    "\"{text}\"\n",
    "CONCISE SUMMARY:\n",
    "\"\"\"\n",
    "map_prompt_template = PromptTemplate(template=map_prompt, input_variables=[\"text\"])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "id": "6f42deb5",
   "metadata": {},
   "outputs": [],
   "source": [
    "combine_prompt = \"\"\"\n",
    "Write a concise summary of the following text delimited by triple backquotes.\n",
    "Return your response in bullet points which covers the key points of the text.\n",
    "```{text}```\n",
    "BULLET POINT SUMMARY:\n",
    "\"\"\"\n",
    "combine_prompt_template = PromptTemplate(template=combine_prompt, input_variables=[\"text\"])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "id": "e2051818",
   "metadata": {},
   "outputs": [],
   "source": [
    "summary_chain = load_summarize_chain(llm=llm,\n",
    "                                     chain_type='map_reduce',\n",
    "                                     map_prompt=map_prompt_template,\n",
    "                                     combine_prompt=combine_prompt_template,\n",
    "#                                      verbose=True\n",
    "                                    )"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "id": "c986230f",
   "metadata": {},
   "outputs": [],
   "source": [
    "output = summary_chain.run(docs)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "id": "e90a8582",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "- Y Combinator suggests that the best startup ideas come from looking for problems, preferably ones that the founders have themselves.\n",
      "- Good ideas should appeal to a small number of people who need it urgently.\n",
      "- To find startup ideas, one should look for things that seem to be missing and be prepared to question the status quo.\n",
      "- College students should use their college experience to prepare themselves for the future and build things with other students.\n",
      "- Tricks for coming up with startup ideas on demand include looking in areas of expertise, talking to people about their needs, and looking for waves and gaps in the market.\n",
      "- Sam Altman points out that taking the time to come up with an idea is a better strategy than most founders are willing to put in the time for.\n",
      "- Paul Buchheit suggests that trying to sell something bad can lead to better ideas.\n"
     ]
    }
   ],
   "source": [
    "print (output)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "59a6da87",
   "metadata": {},
   "source": [
    "## Level 4: Best Representation Vectors - Summarize an entire book\n",
    "\n",
    "In the above method we pass the entire document (all 9.5K tokens of it) to the LLM. But what if you have more tokens than that?\n",
    "\n",
    "What if you had a book you wanted to summarize? Let's load one up, we're going to load [Into Thin Air](https://www.amazon.com/Into-Thin-Air-Personal-Disaster/dp/0385494785) about the 1996 Everest Disaster"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "id": "f6ed1dcb",
   "metadata": {},
   "outputs": [],
   "source": [
    "from langchain.document_loaders import PyPDFLoader\n",
    "\n",
    "# Load the book\n",
    "loader = PyPDFLoader(\"../data/IntoThinAirBook.pdf\")\n",
    "pages = loader.load()\n",
    "\n",
    "# Cut out the open and closing parts\n",
    "pages = pages[26:277]\n",
    "\n",
    "# Combine the pages, and replace the tabs with spaces\n",
    "text = \"\"\n",
    "\n",
    "for page in pages:\n",
    "    text += page.page_content\n",
    "    \n",
    "text = text.replace('\\t', ' ')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "id": "6db88712",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "This book has 139472 tokens in it\n"
     ]
    }
   ],
   "source": [
    "num_tokens = llm.get_num_tokens(text)\n",
    "\n",
    "print (f\"This book has {num_tokens} tokens in it\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "4bedfe55",
   "metadata": {},
   "source": [
    "Wow, that's over 100K tokens, even [GPT 32K](https://help.openai.com/en/articles/7127966-what-is-the-difference-between-the-gpt-4-models) wouldn't be able to handle that in one go. At [0.03 per 1K prompt tokens](https://help.openai.com/en/articles/7127956-how-much-does-gpt-4-cost), this would cost us $4.17 just for the prompt alone.\n",
    "\n",
    "So how do we do this without going through all the tokens? Pick random chunks? Pick equally spaced chunks?\n",
    "\n",
    "I kicked off a [twitter thread](https://twitter.com/GregKamradt/status/1653060004226924544) with a proposed solution to see if I was off base. I'm calling it the Best Representation Vectors method (not sure if a name already exists for it).\n",
    "\n",
    "**Goal:** Chunk your book then get embeddings of the chunks. Pick a subset of chunks which represent a wholistic but diverse view of the book. Or another way, is there a way to pick the top 10 passages that describe the book the best?\n",
    "\n",
    "Once we have our chunks that represent the book then we can summarize those chunks and hopefully get a pretty good summary.\n",
    "\n",
    "Keep in mind there are tools that would likely do this for you, and with token limits increasing this won't be a problem for long. But if you want to do it from scratch this might help.\n",
    "\n",
    "This is most definitely not the optimal answer, but it's my take on it for now! If the [clustering](https://scikit-learn.org/stable/modules/clustering.html) experts wanna help improve it that would be awesome.\n",
    "\n",
    "**The BRV Steps:**\n",
    "1. Load your book into a single text file\n",
    "2. Split your text into large-ish chunks\n",
    "3. Embed your chunks to get vectors\n",
    "4. Cluster the vectors to see which are similar to each other and likely talk about the same parts of the book\n",
    "5. Pick embeddings that represent the cluster the most (method: closest to each cluster centroid)\n",
    "6. Summarize the documents that these embeddings represent\n",
    "\n",
    "Another way to phrase this process, \"Which ~10 documents from this book represent most of the meaning? I want to build a summary off those.\"\n",
    "\n",
    "Note: There will be a bit of information loss, but show me a summary of a whole book that doesn't have information loss ;)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "id": "e0e930b3",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Loaders\n",
    "from langchain.schema import Document\n",
    "\n",
    "# Splitters\n",
    "from langchain.text_splitter import RecursiveCharacterTextSplitter\n",
    "\n",
    "# Model\n",
    "from langchain.chat_models import ChatOpenAI\n",
    "\n",
    "# Embedding Support\n",
    "from langchain.vectorstores import FAISS\n",
    "from langchain.embeddings import OpenAIEmbeddings\n",
    "\n",
    "# Summarizer we'll use for Map Reduce\n",
    "from langchain.chains.summarize import load_summarize_chain\n",
    "\n",
    "# Data Science\n",
    "import numpy as np\n",
    "from sklearn.cluster import KMeans"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "0e5cdbd2",
   "metadata": {},
   "source": [
    "I'm going to initialize two models, gpt-3.5 and gpt4. I'll use gpt 3.5 for the first set of summaries to reduce cost and then gpt4 for the final pass which should hopefully increase the quality."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "id": "0d3d233d",
   "metadata": {},
   "outputs": [],
   "source": [
    "text_splitter = RecursiveCharacterTextSplitter(separators=[\"\\n\\n\", \"\\n\", \"\\t\"], chunk_size=10000, chunk_overlap=3000)\n",
    "\n",
    "docs = text_splitter.create_documents([text])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "id": "c1c2c701",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Now our book is split up into 78 documents\n"
     ]
    }
   ],
   "source": [
    "num_documents = len(docs)\n",
    "\n",
    "print (f\"Now our book is split up into {num_documents} documents\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8d413b2d",
   "metadata": {},
   "source": [
    "Let's get our embeddings of those 78 documents"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "id": "898fc62c",
   "metadata": {},
   "outputs": [],
   "source": [
    "embeddings = OpenAIEmbeddings(openai_api_key=openai_api_key)\n",
    "\n",
    "vectors = embeddings.embed_documents([x.page_content for x in docs])"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "726f6dee",
   "metadata": {},
   "source": [
    "Now let's cluster our embeddings. There are a ton of clustering algorithms you can chose from. Please try a few out to see what works best for you!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "id": "55c8dce0",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Assuming 'embeddings' is a list or array of 1536-dimensional embeddings\n",
    "\n",
    "# Choose the number of clusters, this can be adjusted based on the book's content.\n",
    "# I played around and found ~10 was the best.\n",
    "# Usually if you have 10 passages from a book you can tell what it's about\n",
    "num_clusters = 11\n",
    "\n",
    "# Perform K-means clustering\n",
    "kmeans = KMeans(n_clusters=num_clusters, random_state=42).fit(vectors)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "891d82cd",
   "metadata": {},
   "source": [
    "Here are the clusters that were found. It's interesting to see the progression of clusters throughout the book. This is expected because as the plot changes you'd expect different clusters to emerge due to different semantic meaning"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "id": "218dce05",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([ 2,  2,  2,  2,  2,  2,  6,  9,  9,  4,  4,  4,  4,  9,  9,  9,  9,\n",
       "        4,  4,  4,  4,  9,  9,  5,  4,  0,  0,  0,  5,  5,  5,  9,  9,  3,\n",
       "        3,  9,  3,  3,  3,  3,  3,  9,  9,  9,  3,  3,  3,  3,  7,  7,  7,\n",
       "        7,  7,  6,  6,  6,  6,  6,  6,  9,  1,  1,  3,  4,  4,  1,  1,  1,\n",
       "        1,  9, 10, 10, 10,  8,  8,  8,  8,  8], dtype=int32)"
      ]
     },
     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "kmeans.labels_"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "1d9ccd8b",
   "metadata": {},
   "source": [
    "This is sweet, but whenever you have a clustering exercise, it's hard *not* to graph them. Make sure you add colors.\n",
    "\n",
    "We also need to do dimensionality reduction to reduce the vectors from 1536 dimensions to 2 (this is sloppy data science but we are working towards the 80% solution)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 42,
   "id": "95da2509",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAj4AAAHFCAYAAADyj/PrAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8qNh9FAAAACXBIWXMAAA9hAAAPYQGoP6dpAACGcklEQVR4nO3dd3xUVfrH8c+9M5lJbySkUENvoRcBkaI0FcWCBUWw/VREl8XeYRdh7Q2xL+qq2ECsKB1FiiC9Sw0lIb3XmXt+f4REQjokUzLPe19ZyZ2TmW9ukplnzj1FU0ophBBCCCE8gO7sAEIIIYQQjiKFjxBCCCE8hhQ+QgghhPAYUvgIIYQQwmNI4SOEEEIIjyGFjxBCCCE8hhQ+QgghhPAYUvgIIYQQwmNI4SOEEEIIjyGFjxBV+PDDD9E0rcxHeHg4Q4YM4Ycffqj3x2/ZsiWXX375OX3tkCFDymUv+WjZsmWdZTxy5AiapvHiiy/W2X1WZtWqVWiaxqpVq6ptO2TIEIYMGVL6eUnODz/8sN7y1YXt27dz6623EhMTg7e3N/7+/vTs2ZPnn3+e1NTU0nZnf391be7cuS57rmrzeyDE2czODiCEO5g3bx4dOnRAKUVCQgJz5sxhzJgxfPfdd4wZM8bZ8SrVqlUrPv3003LHrVarE9I4V1RUFOvWraN169bOjlKp9957j8mTJ9O+fXseeughOnXqRFFREZs2beLtt99m3bp1fPPNNw7JMnfuXMLCwpg0aZJDHk8IR5HCR4ga6NKlC7179y79fNSoUYSEhDB//nyXLnx8fHy44IILnB3DJVitVpc+F+vWreOee+5h+PDhLFq0qExxOnz4cB544AF+/vlnJyY8f0op8vPz8fHxcXYU4cHkUpcQ58Db2xuLxYKXl1eZ46mpqUyePJkmTZpgsVho1aoVTzzxBAUFBWXa5efn89hjjxETE4PFYqFJkybce++9pKenV/vYc+fOxWw288wzz9TJ91JyOW/FihXceeedNGrUiMDAQG655RZycnJISEjguuuuIzg4mKioKB588EGKiorK3Y9hGDz77LM0b94cb29vevfuzfLly8u1++uvvxg/fjyNGzfGarXSsWNH3nzzzXLt9u7dy6hRo/D19SUsLIy7776brKyscu2UUjz//PO0aNECb29vevbsyeLFi8u1q+hS1/Tp09E0jV27dnHjjTcSFBREREQEt912GxkZGWW+Pj09ndtvv53Q0FD8/f257LLLOHToEJqmMX369NJ2SUlJ/N///R/NmjXDarUSHh7OwIEDWbZsWVU/BmbNmoWmabz77rsV9shZLBauuOKKSr++sss/FX3fhw4d4oYbbiA6Ohqr1UpERAQXX3wxW7duBYovse7atYvVq1dXeHk0MzOTBx98sMzv79SpU8nJySnz2JqmMWXKFN5++206duyI1Wrlo48+Aur+90CImpIeHyFqwG63Y7PZUEpx6tQpXnjhBXJychg/fnxpm/z8fIYOHcrBgweZMWMGXbt25bfffmP27Nls3bqVH3/8ESh+oR47dizLly/nscceY9CgQWzfvp1nnnmGdevWsW7dugpf+JRSPPTQQ7z++uu8//77Nb4EYbPZyh3TdR1dL/u+54477uDqq6/m888/Z8uWLTz++OPYbDb27dvH1Vdfzf/93/+xbNkynnvuOaKjo5k2bVqZr58zZw4tWrTg1VdfxTAMnn/+eUaPHs3q1avp378/ALt372bAgAE0b96cl156icjISH755Rfuv/9+kpOTS4u5U6dOMXjwYLy8vJg7dy4RERF8+umnTJkypdz3MmPGDGbMmMHtt9/Otddey7Fjx7jzzjux2+20b9++Rufommuu4frrr+f2229nx44dPPbYYwD897//BYqLujFjxrBp0yamT59Oz549WbduHaNGjSp3XxMmTGDz5s08++yztGvXjvT0dDZv3kxKSkqlj2+321mxYgW9evWiWbNmNcp8Pi699FLsdjvPP/88zZs3Jzk5mbVr15YW3t988w3XXnstQUFBzJ07F/j78mhubi6DBw/m+PHjPP7443Tt2pVdu3bx9NNPs2PHDpYtW4amaaWPtWjRIn777TeefvppIiMjady4cb38HghRY0oIUal58+YpoNyH1WpVc+fOLdP27bffVoD68ssvyxx/7rnnFKCWLFmilFLq559/VoB6/vnny7T74osvFKDefffd0mMtWrRQl112mcrNzVXXXHONCgoKUsuWLatR9sGDB1eYHVC33357ue/xvvvuK/P1Y8eOVYB6+eWXyxzv3r276tmzZ+nnhw8fVoCKjo5WeXl5pcczMzNVaGiouuSSS0qPjRw5UjVt2lRlZGSUuc8pU6Yob29vlZqaqpRS6pFHHlGapqmtW7eWaTd8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fsvixYv58MMPS9ud2bNx5MgRNE3jyy+/ZNCgQfj4+NCnTx/279/Pxo0b6d27N/7+/owaNYqkpKQyjzdv3jw6duyIt7c3HTp0YO7cuaW3ldzvwoULGTp0KL6+vnTr1o1169aVtjl69ChjxowhJCQEPz8/OnfuzE8//QRUfKlrwYIFdO7cGavVSsuWLXnppZfK5GnZsiWzZs3itttuIyAggObNm/Puu+9Wec5Gjx7NzJkzufrqq2tzqoUQ50EKHyFEvRk2bBjdunVj4cKFVbZ75plnePLJJ9m8eTNms5kbb7yRhx9+mNdee43ffvuNgwcP8vTTT5e2f++993jiiSd49tln2bNnD7NmzeKpp57io48+KnO/TzzxBA8++CBbt26lXbt23HjjjaW9T/feey8FBQX8+uuv7Nixg+eeew5/f/8K8/35559cd9113HDDDezYsYPp06fz1FNPlSnoAF566SV69+7Nli1bmDx5Mvfccw979+49hzMnhKg3zt4lVQjh/iZOnKiuvPLKCm+7/vrrVceOHUs/B9Q333yjlFLq8OHDClDvv/9+6e3z589XgFq+fHnpsdmzZ6v27duXft6sWTP12WeflXmcf//736p///6V3u+uXbsUoPbs2aOUUio2NlZNnz69wswlu4GnpaUppZQaP368Gj58eJk2Dz30kOrUqVPp5y1atFA333xz6eeGYajGjRurt956q8LHONuZ50UIUX+kx0cIUa+UUtWOlenatWvpvyMiIgCIjY0tcywxMRGApKQkjh07xu23346/v3/px8yZMzl48GCl9xsVFQVQej/3338/M2fOZODAgTzzzDNs37690nx79uxh4MCBZY4NHDiQv/76C7vdXuHjaZpGZGRk6eMJIVyDFD5CiHq1Z88eYmJiqmzj5eVV+u+SIunsYyWzw0r++95777F169bSj507d7J+/fpq77fk6++44w4OHTrEhAkT2LFjB7179+aNN96oMF9FxZtSqsrv4+zcQgjXIIWPEKLerFixgh07dnDNNdfU2X1GRETQpEkTDh06RJs2bcp8VFdgna1Zs2bcfffdLFy4kAceeID33nuvwnadOnVizZo1ZY6tXbuWdu3aYTKZzvl7EUI4ntnZAYQQDUNBQQEJCQnY7XZOnTrFzz//zOzZs7n88su55ZZb6vSxpk+fzv33309gYCCjR4+moKCATZs2kZaWxrRp02p0H1OnTmX06NG0a9eOtLQ0VqxYQceOHSts+8ADD9CnTx/+/e9/c/3117Nu3TrmzJlTZibZucjOzubAgQOlnx8+fJitW7cSGhpK8+bNz+u+hRAVk8JHCFEnfv75Z6KiojCbzYSEhNCtWzdef/11Jk6ciK7XbefyHXfcga+vLy+88AIPP/wwfn5+xMbGMnXq1Brfh91u59577+X48eMEBgYyatQoXnnllQrb9uzZky+//JKnn36af//730RFRfGvf/2LSZMmndf3sWnTJoYOHVr6eUnRNnHixHIzxoQQdUNTFV2oFkIIIYRogGSMjxBCCCE8hhQ+QgghhPAYUvgIIYQQwmNI4SOEEEIIjyGFjxBCCCE8hhQ+QgghhPAYUvgIIYQQwmNI4SOEEEIIjyGFjxBCCCE8hhQ+QgghhPAYUvgIIYQQwmNI4SOEEEIIj/H/Y3owjBQcwlUAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from sklearn.manifold import TSNE\n",
    "import matplotlib.pyplot as plt\n",
    "\n",
    "# Taking out the warnings\n",
    "import warnings\n",
    "from warnings import simplefilter\n",
    "\n",
    "# Filter out FutureWarnings\n",
    "simplefilter(action='ignore', category=FutureWarning)\n",
    "\n",
    "# Perform t-SNE and reduce to 2 dimensions\n",
    "tsne = TSNE(n_components=2, random_state=42)\n",
    "reduced_data_tsne = tsne.fit_transform(vectors)\n",
    "\n",
    "# Plot the reduced data\n",
    "plt.scatter(reduced_data_tsne[:, 0], reduced_data_tsne[:, 1], c=kmeans.labels_)\n",
    "plt.xlabel('Dimension 1')\n",
    "plt.ylabel('Dimension 2')\n",
    "plt.title('Book Embeddings Clustered')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6aa4314b",
   "metadata": {},
   "source": [
    "Awesome, not perfect, but pretty good directionally. Now we need to get the vectors which are closest to the cluster centroids (the center).\n",
    "\n",
    "The function below is a quick way to do that (w/ help from ChatGPT)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 43,
   "id": "55f2f664",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Find the closest embeddings to the centroids\n",
    "\n",
    "# Create an empty list that will hold your closest points\n",
    "closest_indices = []\n",
    "\n",
    "# Loop through the number of clusters you have\n",
    "for i in range(num_clusters):\n",
    "    \n",
    "    # Get the list of distances from that particular cluster center\n",
    "    distances = np.linalg.norm(vectors - kmeans.cluster_centers_[i], axis=1)\n",
    "    \n",
    "    # Find the list position of the closest one (using argmin to find the smallest distance)\n",
    "    closest_index = np.argmin(distances)\n",
    "    \n",
    "    # Append that position to your closest indices list\n",
    "    closest_indices.append(closest_index)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "f5a44596",
   "metadata": {},
   "source": [
    "Now sort them (so the chunks are processed in order)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 44,
   "id": "679297ac",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[0, 12, 26, 29, 39, 41, 51, 54, 65, 71, 75]"
      ]
     },
     "execution_count": 44,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "selected_indices = sorted(closest_indices)\n",
    "selected_indices"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "171c2b42",
   "metadata": {},
   "source": [
    "It's intersting to see which chunks pop up at most descriptive. How does your distribution look?\n",
    "\n",
    "Let's create our custom prompts. I'm going to use gpt4 (which has a bigger token limit) for the combine step so I'm asking for long summaries in the map step to reduce the information loss."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 45,
   "id": "83bc55d8",
   "metadata": {},
   "outputs": [],
   "source": [
    "llm3 = ChatOpenAI(temperature=0,\n",
    "                 openai_api_key=openai_api_key,\n",
    "                 max_tokens=1000,\n",
    "                 model='gpt-3.5-turbo'\n",
    "                )"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 46,
   "id": "5552e6d3",
   "metadata": {},
   "outputs": [],
   "source": [
    "map_prompt = \"\"\"\n",
    "You will be given a single passage of a book. This section will be enclosed in triple backticks (```)\n",
    "Your goal is to give a summary of this section so that a reader will have a full understanding of what happened.\n",
    "Your response should be at least three paragraphs and fully encompass what was said in the passage.\n",
    "\n",
    "```{text}```\n",
    "FULL SUMMARY:\n",
    "\"\"\"\n",
    "map_prompt_template = PromptTemplate(template=map_prompt, input_variables=[\"text\"])"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b568b94a",
   "metadata": {},
   "source": [
    "I kept getting a timeout errors so I'm actually going to do this map reduce manually"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 48,
   "id": "bb5eb0d9",
   "metadata": {},
   "outputs": [],
   "source": [
    "map_chain = load_summarize_chain(llm=llm3,\n",
    "                             chain_type=\"stuff\",\n",
    "                             prompt=map_prompt_template)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e4e1ec38",
   "metadata": {},
   "source": [
    "Then go get your docs which the top vectors represented."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 49,
   "id": "781a686c",
   "metadata": {},
   "outputs": [],
   "source": [
    "selected_docs = [docs[doc] for doc in selected_indices]"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "eca5fc42",
   "metadata": {},
   "source": [
    "Let's loop through our selected docs and get a good summary for each chunk. We'll store the summary in a list."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 50,
   "id": "7e2220ab",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Summary #0 (chunk #0) - Preview: The passage describes the author's experience of reaching the summit of Mount Everest on May 10, 1996, and the events that followed. The author, who was part of a New Zealand-based team, had been fantasizing about this moment for months but found him \n",
      "\n",
      "Summary #1 (chunk #12) - Preview: In this passage, the author and his team are at Lobuje, a village at 16,200 feet, preparing to move to Base Camp. They receive news that Tenzing, a Sherpa who had fallen into a crevasse, had been rescued by a team of Sherpas and was resting at Base C \n",
      "\n",
      "Summary #2 (chunk #26) - Preview: In this passage, the author describes two events that occurred on Everest. The first event involves a Sherpa named Ngawang Topche who was suffering from High Altitude Pulmonary Edema (HAPE), a potentially lethal illness caused by climbing too high to \n",
      "\n",
      "Summary #3 (chunk #29) - Preview: In this passage, the author describes the equipment and personal items they brought with them on their expedition to climb Mount Everest. They have a lot of electronic equipment, including laptops, cameras, and tape recorders, as well as climbing gea \n",
      "\n",
      "Summary #4 (chunk #39) - Preview: In this passage, the author describes his ascent up the Lhotse Face towards the South Col, the launching pad for the summit assault on Mount Everest. He struggles to pass slower climbers on the single rope and worries about the hazards of falling roc \n",
      "\n",
      "Summary #5 (chunk #41) - Preview: In this passage, the author describes their experience waiting on a ledge for over 45 minutes in subzero temperatures while waiting for the rest of their group to catch up. They observe a peculiar sight of a Sherpa, Lopsang Jangbu, towing a weak clim \n",
      "\n",
      "Summary #6 (chunk #51) - Preview: This passage describes the harrowing experience of a group of climbers on Mount Everest during a severe storm. The climbers, including guides and clients, were stranded at the lip of a 7,000-foot drop down the Kangshung Face, just 1,000 horizontal fe \n",
      "\n",
      "Summary #7 (chunk #54) - Preview: In this passage, the author recounts the events of May 10, 1996, when Scott Fischer and his team reached the summit of Mount Everest. Fischer complained of feeling unwell and took off his oxygen mask shortly after leaving the summit. Lopsang Jangbu,  \n",
      "\n",
      "Summary #8 (chunk #65) - Preview: The passage describes the aftermath of the tragic events that occurred during the 1996 Everest climbing season. The author, who was a journalist and a member of one of the expeditions, reflects on the memorial service held for the climbers who lost t \n",
      "\n",
      "Summary #9 (chunk #71) - Preview: The passage discusses the controversy surrounding Jon Krakauer's book, \"Into Thin Air,\" and its portrayal of Anatoli Boukreev, a professional climbing guide who was involved in the 1996 Mount Everest disaster. Boukreev took issue with Krakauer's acco \n",
      "\n",
      "Summary #10 (chunk #75) - Preview: In this passage, the author addresses the controversy surrounding his book, \"Into Thin Air,\" which details the tragic events of the 1996 Everest disaster. He refutes claims made by Boukreev/DeWalt that Reinhold Messner endorsed Anatoli Boukreev's act \n",
      "\n"
     ]
    }
   ],
   "source": [
    "# Make an empty list to hold your summaries\n",
    "summary_list = []\n",
    "\n",
    "# Loop through a range of the lenght of your selected docs\n",
    "for i, doc in enumerate(selected_docs):\n",
    "    \n",
    "    # Go get a summary of the chunk\n",
    "    chunk_summary = map_chain.run([doc])\n",
    "    \n",
    "    # Append that summary to your list\n",
    "    summary_list.append(chunk_summary)\n",
    "    \n",
    "    print (f\"Summary #{i} (chunk #{selected_indices[i]}) - Preview: {chunk_summary[:250]} \\n\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "7fae1a72",
   "metadata": {},
   "source": [
    "Great, now that we have our list of summaries, let's get a summary of the summaries"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 51,
   "id": "4083431d",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Your total summary has 4002 tokens\n"
     ]
    }
   ],
   "source": [
    "summaries = \"\\n\".join(summary_list)\n",
    "\n",
    "# Convert it back to a document\n",
    "summaries = Document(page_content=summaries)\n",
    "\n",
    "print (f\"Your total summary has {llm.get_num_tokens(summaries.page_content)} tokens\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 52,
   "id": "1d2e71c5",
   "metadata": {},
   "outputs": [],
   "source": [
    "llm4 = ChatOpenAI(temperature=0,\n",
    "                 openai_api_key=openai_api_key,\n",
    "                 max_tokens=3000,\n",
    "                 model='gpt-4',\n",
    "                 request_timeout=120\n",
    "                )"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 53,
   "id": "b98e7321",
   "metadata": {},
   "outputs": [],
   "source": [
    "combine_prompt = \"\"\"\n",
    "You will be given a series of summaries from a book. The summaries will be enclosed in triple backticks (```)\n",
    "Your goal is to give a verbose summary of what happened in the story.\n",
    "The reader should be able to grasp what happened in the book.\n",
    "\n",
    "```{text}```\n",
    "VERBOSE SUMMARY:\n",
    "\"\"\"\n",
    "combine_prompt_template = PromptTemplate(template=combine_prompt, input_variables=[\"text\"])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 54,
   "id": "2930c26e",
   "metadata": {},
   "outputs": [],
   "source": [
    "reduce_chain = load_summarize_chain(llm=llm4,\n",
    "                             chain_type=\"stuff\",\n",
    "                             prompt=combine_prompt_template,\n",
    "#                              verbose=True # Set this to true if you want to see the inner workings\n",
    "                                   )"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e9958142",
   "metadata": {},
   "source": [
    "Run! Note this will take a while"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 55,
   "id": "c6eda913",
   "metadata": {},
   "outputs": [],
   "source": [
    "output = reduce_chain.run([summaries])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 56,
   "id": "915628a1",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "In this story, the author recounts their experience as part of a New Zealand-based team attempting to summit Mount Everest on May 10, 1996. Despite months of anticipation, the author finds themselves unable to fully appreciate the achievement due to extreme exhaustion, lack of sleep, and the effects of high altitude. After a brief moment at the summit, the author begins their descent, encountering a traffic jam of climbers from multiple expeditions. The author's oxygen tank runs out, forcing them to navigate dangerous terrain without supplemental oxygen. Unbeknownst to the climbers, a disaster is about to unfold, resulting in the deaths of eight climbers, including two of the author's teammates.\n",
      "\n",
      "The story also highlights the challenges and dangers of high-altitude mountaineering, as well as the importance of teamwork and respect for local cultures and customs. The author and their team face various obstacles, including altitude sickness, treacherous terrain, and the reliance on Sherpas, who work incredibly hard for little pay. The author emphasizes the need to show gratitude and respect to the Sherpas, who are essential to the success of the climbers.\n",
      "\n",
      "Throughout the story, the author describes various events and challenges faced by the climbers, including medical emergencies, the importance of proper acclimatization, and the difficulties of providing medical care in a remote, high-altitude environment. The author also discusses the cultural differences between Western climbers and Sherpas, who are often reluctant to acknowledge physical infirmities due to an element of machismo in their culture.\n",
      "\n",
      "As the climbers continue their ascent, they face physical and mental challenges, as well as the individualistic nature of the climb. The author emphasizes the importance of timing and weather conditions in determining the success of a summit assault. The story also touches on the controversy surrounding the author's book, \"Into Thin Air,\" and its portrayal of Anatoli Boukreev, a professional climbing guide involved in the 1996 Everest disaster.\n",
      "\n",
      "In the aftermath of the tragedy, the author reflects on the emotional impact, including survivor's guilt and the grief of the families and loved ones of the deceased. The author also considers the role of hubris in the disaster and questions their own actions during the storm. The story highlights the complex emotions and difficult questions that arise in the wake of such a devastating event, as well as the contentious nature of reporting on a tragedy and the importance of accuracy and thorough research in journalism.\n"
     ]
    }
   ],
   "source": [
    "print (output)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "27a1db73",
   "metadata": {},
   "source": [
    "Wow that was a long process, but you get the gist, hopefully we'll see some library abstractions in the coming months that do this automatically for us! Let me know what you think on [Twitter](https://twitter.com/GregKamradt)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "5b4ae429",
   "metadata": {},
   "source": [
    "## Level 5: Agents - Summarize an unknown amount of text\n",
    "\n",
    "What if you have an unknown amount of text you need to summarize? This may be a verticalize use case (like law or medical) where more research is required as you uncover the first pieces of information.\n",
    "\n",
    "We're going to use agents below, this is still a very actively developed area and should be handled with care. Future agents will be able to handle a lot more complicated tasks."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 62,
   "id": "fd384fd2",
   "metadata": {},
   "outputs": [],
   "source": [
    "from langchain import OpenAI\n",
    "from langchain.chat_models import ChatOpenAI\n",
    "from langchain.agents import initialize_agent, Tool\n",
    "from langchain.utilities import WikipediaAPIWrapper\n",
    "\n",
    "llm = ChatOpenAI(temperature=0, model_name='gpt-4', openai_api_key=openai_api_key)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6456e70a",
   "metadata": {},
   "source": [
    "We're going to use the Wiki search tool and research multiple topics"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 63,
   "id": "6b93660c",
   "metadata": {},
   "outputs": [],
   "source": [
    "wikipedia = WikipediaAPIWrapper()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b7d26c52",
   "metadata": {},
   "source": [
    "Let's define our toolkit, in this case it's just one tool"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 64,
   "id": "aaf60c86",
   "metadata": {},
   "outputs": [],
   "source": [
    "tools = [\n",
    "    Tool(\n",
    "        name=\"Wikipedia\",\n",
    "        func=wikipedia.run,\n",
    "        description=\"Useful for when you need to get information from wikipedia about a single topic\"\n",
    "    ),\n",
    "]"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "9d0f07a5",
   "metadata": {},
   "source": [
    "Init our agent"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 68,
   "id": "baff1fce",
   "metadata": {},
   "outputs": [],
   "source": [
    "agent_executor = initialize_agent(tools, llm, agent='zero-shot-react-description', verbose=True)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "06d17afb",
   "metadata": {},
   "source": [
    "Then let's ask a question that will need multiple documents"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 69,
   "id": "dbd6e437",
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "\n",
      "\u001b[1m> Entering new AgentExecutor chain...\u001b[0m\n",
      "\u001b[32;1m\u001b[1;3mI need to find information about Napoleon Bonaparte and then about Serena Williams to identify commonalities between them.\n",
      "Action: Wikipedia\n",
      "Action Input: Napoleon Bonaparte\u001b[0m\n",
      "Observation: \u001b[36;1m\u001b[1;3mPage: Napoleon\n",
      "Summary: Napoleon Bonaparte (born Napoleone Buonaparte; 15 August 1769 – 5 May 1821), later known by his regnal name Napoleon I, was a Corsican-born French military commander and political leader who rose to prominence during the French Revolution and led successful campaigns during the Revolutionary Wars. He was the de facto leader of the French Republic as First Consul from 1799 to 1804, then Emperor of the French from 1804 until 1814 and again in 1815. Napoleon's political and cultural legacy endures to this day, as a highly celebrated and controversial leader. He initiated many liberal reforms that have persisted in society, and is considered one of the greatest military commanders in history. His campaigns are still studied at military academies worldwide. Between three and six million civilians and soldiers died in what became known as the Napoleonic Wars.Napoleon was born on the island of Corsica, not long after its annexation by France, to a native family descending from minor Italian nobility. He supported the French Revolution in 1789 while serving in the French army, and tried to spread its ideals to his native Corsica. He rose rapidly in the Army after he saved the governing French Directory by firing on royalist insurgents. In 1796, he began a military campaign against the Austrians and their Italian allies, scoring decisive victories and becoming a national hero. Two years later, he led a military expedition to Egypt that served as a springboard to political power. He engineered a coup in November 1799 and became First Consul of the Republic.\n",
      "Differences with the United Kingdom meant France faced the War of the Third Coalition by 1805. Napoleon shattered this coalition with victories in the Ulm campaign, and at the Battle of Austerlitz, which led to the dissolution of the Holy Roman Empire. In 1806, the Fourth Coalition took up arms against him. Napoleon defeated Prussia at the battles of Jena and Auerstedt, marched the Grande Armée into Eastern Europe, and defeated the Russians in June 1807 at Friedland, forcing the defeated nations of the Fourth Coalition to accept the Treaties of Tilsit. Two years later, the Austrians challenged the French again during the War of the Fifth Coalition, but Napoleon solidified his grip over Europe after triumphing at the Battle of Wagram.\n",
      "Hoping to extend the Continental System, his embargo against Britain, Napoleon invaded the Iberian Peninsula and declared his brother Joseph the King of Spain in 1808. The Spanish and the Portuguese revolted in the Peninsular War aided by a British army, culminating in defeat for Napoleon's marshals. Napoleon launched an invasion of Russia in the summer of 1812. The resulting campaign witnessed the catastrophic retreat of Napoleon's Grande Armée. In 1813, Prussia and Austria joined Russian forces in a Sixth Coalition against France, resulting in a large coalition army defeating Napoleon at the Battle of Leipzig. The coalition invaded France and captured Paris, forcing Napoleon to abdicate in April 1814. He was exiled to the island of Elba, between Corsica and Italy. In France, the Bourbons were restored to power.\n",
      "Napoleon escaped in February 1815 and took control of France. The Allies responded by forming a Seventh Coalition, which defeated Napoleon at the Battle of Waterloo in June 1815. The British exiled him to the remote island of Saint Helena in the Atlantic, where he died in 1821 at the age of 51.\n",
      "Napoleon had an extensive impact on the modern world, bringing liberal reforms to the lands he conquered, especially the regions of the Low Countries, Switzerland and parts of modern Italy and Germany. He implemented many liberal policies in France and Western Europe.\n",
      "\n",
      "Page: Napoleon III\n",
      "Summary: Napoleon III (born Charles Louis Napoléon Bonaparte; 20 April 1808 – 9 January 1873) was the first President of France (as Louis-Napoléon Bonaparte) from 1848 to 1852, and the last monarch of France as Emperor of the French from 1852 until he was deposed in absentia on 4 September 1870. A nephew of Napoleon I and cousin of the disputed Napoleon II, he was elected to the presidency of the Second Republic in 1848, and he seized power by force in 1851 when he could not constitutionally be reelected. He later proclaimed himself Emperor of the French and founded the Second Empire, reigning until the defeat of the French Army and his capture by Prussia and its allies at the Battle of Sedan in 1870. Napoleon III was a popular monarch who oversaw the modernization of the French economy and filled Paris with new boulevards and parks. He expanded the French overseas empire, made the French merchant navy the second largest in the world, and personally engaged in two wars. Maintaining leadership for 22 years, he was the longest-reigning leader of France since the fall of the Ancien Régime, though his reign would ultimately end on the battlefield.\n",
      "Napoleon III commissioned a grand reconstruction of Paris carried out by the man he appointed as prefect of the Seine, Baron Georges-Eugène Haussmann. He expanded and consolidated the railway system throughout the nation and modernized the banking system. Napoleon III promoted the building of the Suez Canal and established modern agriculture, which ended famines in France and made the country an agricultural exporter. He negotiated the 1860 Cobden–Chevalier Free Trade Agreement with Britain and similar agreements with France's other European trading partners. Social reforms included giving French workers the right to strike, the right to organize, and the right for women to be admitted to a French university.\n",
      "In foreign policy, Napoleon III aimed to reassert French influence in Europe and around the world. In Europe, he allied with Britain and defeated Russia in the Crimean War (1853–1856). His regime assisted Italian unification by defeating the Austrian Empire in the Franco-Austrian War and later annexed Savoy and Nice through the Treaty of Turin as its deferred reward. At the same time, his forces defended the Papal States against annexation by Italy. He was also favourable towards the 1859 union of the Danubian Principalities, which resulted in the establishment of the United Principalities of Moldavia and Wallachia. Napoleon III doubled the area of the French colonial empire with expansions in Asia, the Pacific, and Africa. On the other hand, the intervention in Mexico, which aimed to create a Second Mexican Empire under French protection, ended in total failure. From 1866, Napoleon III had to face the mounting power of Prussia as its Chancellor Otto von Bismarck sought German unification under Prussian leadership. In July 1870, Napoleon III reluctantly declared war on Prussia after pressure from the general public. The French Army was rapidly defeated and Napoleon III was captured at Sedan. He was swiftly dethroned and the Third Republic was proclaimed in Paris. After he was released from German custody, he went into exile in England, where he died in 1873.\n",
      "\n",
      "\n",
      "\n",
      "Page: House of Bonaparte\n",
      "Summary: The House of Bonaparte (originally Buonaparte) is a former imperial and royal European dynasty of Italian (Genoese) origin. It was founded in 1804 by Napoleon I, the son of Corsican nobleman Carlo Buonaparte and Letizia Buonaparte (née Ramolino).  Napoleon was a French military leader who rose to power during the French Revolution and who, in 1804, transformed the First French Republic into the First French Empire, five years after his coup d'état of November 1799 (18 Brumaire).  Napoleon and the Grande Armée had to fight against every major European power (except for the ones he was allied with, including Denmark-Norway) and dominated continental Europe through a series of military victories during the Napoleonic Wars.  He installed members of his family on the thrones of client states, expanding the power of the dynasty.\n",
      "The House of Bonaparte formed the Imperial House of France during the French Empire, together with some non-Bonaparte family members. In addition to holding the title of Emperor of the French, the Bonaparte dynasty held various other titles and territories during the Napoleonic Wars, including the Kingdom of Italy, the Kingdom of Spain, the Kingdom of Westphalia, the Kingdom of Holland, and the Kingdom of Naples. The dynasty held power for around a decade until the Napoleonic Wars began to take their toll. Making very powerful enemies, such as Austria, Britain, Russia, and Prussia, as well as royalist (particularly Bourbon) restorational movements in France, Spain, the Two Sicilies, and Sardinia, the dynasty eventually collapsed due to the final defeat of Napoleon at the Battle of Waterloo and the restoration of former dynasties by the Congress of Vienna.\n",
      "During the reign of Napoleon I, the Imperial Family consisted of the Emperor's immediate relations – his wife, son, siblings, and some other close relatives, namely his brother-in-law Joachim Murat, his uncle Joseph Fesch, and his stepson Eugène de Beauharnais.\n",
      "Between 1852 and 1870, there was a Second French Empire, when a member of the Bonaparte dynasty again ruled France: Napoleon III, the youngest son of Louis Bonaparte. However, during the Franco-Prussian War of 1870–1871, the dynasty was again ousted from the Imperial Throne. Since that time, there has been a series of pretenders. Supporters of the Bonaparte family's claim to the throne of France are known as Bonapartists. Current head Jean-Christophe, Prince Napoléon, has a Bourbon mother.\u001b[0m\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Thought:\u001b[32;1m\u001b[1;3mI now know the summary of Napoleon Bonaparte. I need to find information about Serena Williams to identify commonalities between them.\n",
      "Action: Wikipedia\n",
      "Action Input: Serena Williams\u001b[0m\n",
      "Observation: \u001b[36;1m\u001b[1;3mPage: Serena Williams\n",
      "Summary: Serena Jameka Williams (born September 26, 1981) is an American retired professional tennis player. Considered among the greatest tennis players of all time, she was ranked world No. 1 in singles by the Women's Tennis Association (WTA) for 319 weeks, including a joint-record 186 consecutive weeks, and finished as the year-end No. 1 five times. She won 23 Grand Slam singles titles, the most by any player in the Open Era, and the second-most of all time. She is the only player, male or female, to accomplish a Career Golden Slam in both singles and doubles.Along with her older sister Venus, Serena Williams was coached by her parents Oracene Price and Richard Williams. Turning professional in 1995, she won her first major singles title at the 1999 US Open. From the 2002 French Open to the 2003 Australian Open, she was dominant, winning all four major singles titles (each time over Venus in the final) to achieve a non-calendar year Grand Slam and the career Grand Slam, known as the 'Serena Slam'. The next few years saw her claim two more singles majors, but suffer from injury and decline in form. Beginning in 2007, however, she gradually returned to form despite continued injuries, retaking the world No. 1 singles ranking. Beginning at the 2012 Wimbledon Championships, Williams returned to dominance, claiming Olympic gold (completing the Career Golden Slam in singles) and winning eight out of thirteen singles majors, including all four in a row from 2014–15 to achieve a second \"Serena Slam\". At the 2017 Australian Open, she won her 23rd major singles title, surpassing Steffi Graf's Open Era record. She then took a break from professional tennis after becoming pregnant and reached four major finals upon returning to play. In August 2022, Williams announced her impending \"evolution\" away from professional tennis and played what was expected to be her final match at the 2022 US Open.Williams also won 14 major women's doubles titles, all with her sister Venus, and the pair was unbeaten in major doubles finals (the best unbeaten record in major finals in any discipline of the sport). The pair achieved a non-calendar year Grand Slam between the 2009 Wimbledon Championships and the 2010 French Open, which granted the sisters the doubles world No. 1 ranking. Serena won four Olympic gold medals, three in women's doubles—an all-time joint record in tennis, shared with her sister. The duo are the only women in the Open Era to win Olympic gold in both singles and doubles. She also won two major mixed doubles titles, both in 1998. She is the only singles player, male or female, to complete three Career Golden Slams – one in women's singles and two in same-sex doubles.The arrival of the Williams sisters has been credited with ushering in a new era of power and athleticism on the women's professional tennis tour. Serena holds a combined 39 major titles: 23 in singles, 14 in women's doubles, and two in mixed doubles. She is joint-third on the all-time list and second in the Open Era for total major titles. She is the most recent woman to simultaneously hold all four major singles titles (2002–03 and 2014–15), and the most recent woman to win the Surface Slam (major titles on hard, clay and grass courts in the same calendar year), doing so in 2015. She is also, with Venus, the most recent player to have simultaneously held all four major women's doubles titles (2009–10).\n",
      "Williams was the world's highest paid woman athlete in 2016, earning almost $29 million. She repeated this feat in 2017 when she was the only woman on Forbes' list of the 100 highest-paid athletes, with $27 million in prize money and endorsements. She won the Laureus Sportswoman of the Year award a record four times (2003, 2010, 2016, 2018), and in December 2015 was named Sportsperson of the Year by Sports Illustrated magazine. She is the highest-earning woman athlete of all time.\n",
      "\n",
      "Page: Williams sisters\n",
      "Summary: The Williams sisters are two professional American tennis players: Venus Williams (b. 1980), a seven-time Grand Slam title winner (singles), and Serena Williams (b. 1981), twenty-three-time Grand Slam title winner (singles), both of whom were coached from an early age by their parents Richard Williams and Oracene Price.\n",
      "Both sisters have been ranked by the Women's Tennis Association at the world No. 1 position in both singles and doubles. In 2002, after the French Open, Venus and Serena Williams were ranked world No. 1 and No. 2 on singles, respectively, marking the first time in history that sisters occupied the top two positions. On 21 June 2010, Serena and Venus again held the No. 1 and No. 2 rankings spots in singles, respectively, some eight years after first accomplishing this feat. At the time, Serena was three months shy of her 29th birthday and Venus had just celebrated her 30th birthday.\n",
      "There is a noted professional rivalry between the sisters in singles — between the 2001 US Open and the 2017 Australian Open, they contested nine major finals. They became the first two players, female or male, to contest four consecutive major singles finals, from the 2002 French Open to the 2003 Australian Open; Serena famously won all four to complete the first of two \"Serena Slams\" (non-calendar year Grand Slams). Between 2000 and 2016, they collectively won 12 Wimbledon singles titles (Venus five, and Serena seven). Nonetheless, they remain very close, often watching each other's matches in support, even after one of them had been knocked out of a tournament.\n",
      "By winning the 2001 Australian Open doubles title, they became the fifth pair of women to complete the career Grand Slam in doubles, and the only pair to complete the career Golden Slam in doubles. At the time, Venus and Serena were only 20 and 19 years old, respectively. Since then, they have gone on to add another two Olympic gold medals at the 2008 Beijing Olympics and the 2012 London Olympics. Moreover, the duo would go on to win a non-calendar year Grand Slam in doubles between 2009 Wimbledon and 2010 Roland Garros, which made them the co-No. 1 doubles players on 7 June 2010. Their most recent major doubles title came at the 2016 Wimbledon Championships.\n",
      "Both players have won four gold medals at the Olympics, one each in singles and three in doubles— all won together— the most of any tennis players. Venus has also won a silver in mixed doubles at the 2016 Rio Olympics. As a duo, they have also completed the double career Golden Slam in doubles.  Between the two of them, they have completed the Boxed Set, winning all four grand slams in singles, women's doubles, and mixed doubles. They split all four mixed doubles titles in 1998.\n",
      "\n",
      "\n",
      "\n",
      "Page: Venus Williams\n",
      "Summary: Venus Ebony Starr Williams (born June 17, 1980) is an American professional tennis player. A former world No. 1 in both singles and doubles, Williams has won seven Grand Slam singles titles, five at Wimbledon and two at the US Open. She is widely regarded as one of the all-time greats of the sport.Along with her younger sister, Serena, Venus Williams was coached by her parents Oracene Price and Richard Williams. Turning professional in 1994, she reached her first major final at the 1997 US Open. In 2000 and 2001, Williams claimed the Wimbledon and US Open titles, as well as Olympic singles gold at the 2000 Sydney Olympics. She first reached the singles world No. 1 ranking on 25 February 2002, becoming the first African American woman to do so in the Open era, and the second of all-time after Althea Gibson. She reached four consecutive major finals between 2002 and 2003, but lost each time to Serena. She then suffered from injuries, winning just one major title between 2003 and 2006. Williams returned to form starting in 2007, when she won Wimbledon (a feat she repeated the following year). In 2010, she returned to the world No. 2 position in singles, but then suffered again from injuries. Starting in 2014, she again gradually returned to form, culminating in two major final appearances at the Australian Open and Wimbledon in 2017.\n",
      "Along with her seven singles major titles, Williams has also won 14 women's doubles major titles, all partnering Serena; the pair are unbeaten in Grand Slam doubles finals. She became the world No. 1 in doubles for the first time on June 7, 2010, alongside Serena, after the pair completed a non-calendar-year Grand Slam at the French Open. The pair also won three Olympic gold medals in women's doubles, in 2000, 2008, and 2012, adding to Venus' singles gold in 2000 and her mixed doubles silver in 2016. Williams has also won two mixed doubles major titles, both in 1998.\n",
      "The Williams sisters are credited with ushering in a new era of power and athleticism on the women's professional tennis tour. With 49 WTA Tour singles titles, Williams trails only her sister Serena among active players with the most singles titles. With 22 WTA doubles titles and two mixed doubles titles, her combined total of 73 WTA titles is also second among active players behind Serena. She is also one of only two active players to have reached the singles finals of all four majors, along with Serena. Williams was twice the season prize money leader (in 2001 and 2017), and ranks second behind Serena in all-time career prize money winnings, having earned over US$42 million as of March 2022.\u001b[0m\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Thought:\u001b[32;1m\u001b[1;3mI now know the summaries of both Napoleon Bonaparte and Serena Williams. I can identify commonalities between them.\n",
      "\n",
      "Final Answer: Napoleon Bonaparte and Serena Williams both achieved remarkable success in their respective fields, with Napoleon being one of the greatest military commanders in history and Serena being one of the greatest tennis players of all time. They both dominated their fields during their peak years and have left lasting legacies. Additionally, they both faced challenges and setbacks in their careers but managed to overcome them and continue to excel. However, it is important to note that their fields of expertise are vastly different, with Napoleon being a military and political leader, while Serena is a professional athlete.\u001b[0m\n",
      "\n",
      "\u001b[1m> Finished chain.\u001b[0m\n"
     ]
    }
   ],
   "source": [
    "output = agent_executor.run(\"Can you please provide a quick summary of Napoleon Bonaparte? \\\n",
    "                          Then do a separate search and tell me what the commonalities are with Serena Williams\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 70,
   "id": "4e5aeeee",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Napoleon Bonaparte and Serena Williams both achieved remarkable success in their respective fields, with Napoleon being one of the greatest military commanders in history and Serena being one of the greatest tennis players of all time. They both dominated their fields during their peak years and have left lasting legacies. Additionally, they both faced challenges and setbacks in their careers but managed to overcome them and continue to excel. However, it is important to note that their fields of expertise are vastly different, with Napoleon being a military and political leader, while Serena is a professional athlete.\n"
     ]
    }
   ],
   "source": [
    "print (output)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "f48735b9",
   "metadata": {},
   "source": [
    "Awesome, good luck summarizing!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "6b87ac86",
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "850699b5",
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "39ccd5d6",
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "3ae94d85",
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "b0a27f63",
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "8bc1875e",
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "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.9.13"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}