Notebook_Ferro.ipynb

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 52,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "True"
      ]
     },
     "execution_count": 52,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from mistralai.client import MistralClient, ChatMessage\n",
    "import faiss\n",
    "\n",
    "import requests\n",
    "from dotenv import load_dotenv\n",
    "import os\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "from sklearn.manifold import TSNE\n",
    "import seaborn as sns\n",
    "\n",
    "load_dotenv()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Today's date: 2024-02-26\n"
     ]
    }
   ],
   "source": [
    "open_cage_api = os.getenv(\"OPENCAGE_API_KEY\")\n",
    "\n",
    "city = 'Clamart'\n",
    "\n",
    "geocode_url = f\"https://api.opencagedata.com/geocode/v1/json?q={city}&key={opencage_api_key}\"\n",
    "geocode_response = requests.get(geocode_url)\n",
    "geocode_data = geocode_response.json()\n",
    "\n",
    "\n",
    "latitude = geocode_data['results'][0]['geometry']['lat']\n",
    "longitude = geocode_data['results'][0]['geometry']['lng']"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 57,
   "metadata": {},
   "outputs": [],
   "source": [
    "api_key = os.environ['API_KEY']"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Yes, the Nazi regime, which was in power in Germany from 1933 to 1945, is widely considered to have been one of the most evil and brutal regimes in history. Under the leadership of Adolf Hitler, the Nazis implemented policies of racial discrimination and persecution, which led to the genocide of six million Jews during the Holocaust. They also persecuted and murdered other groups that they deemed inferior or undesirable, including Romani people, homosexuals, people with disabilities, and political dissidents. The Nazi regime was responsible for numerous war crimes and crimes against humanity, and its actions had a profound and devastating impact on the world.\n"
     ]
    }
   ],
   "source": [
    "# Basic example\n",
    "\n",
    "model = \"mistral-small\"\n",
    "\n",
    "client = MistralClient(api_key=api_key)\n",
    "\n",
    "messages = [\n",
    "    ChatMessage(role=\"user\", content=\"Nazi are they really bad?\"),\n",
    "]\n",
    "\n",
    "# No streaming\n",
    "chat_response = client.chat(\n",
    "    model=model,\n",
    "    messages=messages,\n",
    ")\n",
    "\n",
    "print(chat_response.choices[0].message.content)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "What is RAG (Retrieval-Augmented Generation) ?\n",
    "\n",
    "- Step 1 : Retrieve relevant information from a knowledge base with text embeddings stored in a vector store\n",
    "- Step 2 : Insert the relevant information to the prompt for the LLM to generate information"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "##### Basic Rag"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [],
   "source": [
    "response = requests.get('https://raw.githubusercontent.com/run-llama/llama_index/main/docs/examples/data/paul_graham/paul_graham_essay.txt')\n",
    "text = response.text"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "There are 37 chunks and 75014 characters\n"
     ]
    }
   ],
   "source": [
    "chunk_size = 2048\n",
    "chunks = [text[i:i+chunk_size] for i in range(0, len(text), chunk_size)]\n",
    "\n",
    "print(\"There are {} chunks and {} characters\".format(len(chunks), len(text)))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We must consider the trade-offs that come with using smaller chunks, such as increasing processing time and computational resources."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [],
   "source": [
    "def get_text_embedding(input):\n",
    "    embeddings_batch_response = client.embeddings(\n",
    "          model=\"mistral-embed\",\n",
    "          input=input\n",
    "      )\n",
    "    return embeddings_batch_response.data[0].embedding\n",
    "\n",
    "text_embeddings = np.array([get_text_embedding(chunk) for chunk in chunks])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once we get the text embeddings, a common practice is to store them in a vector database for efficient processing and retrieval. We are using an open-source vector database Faiss (Facebook AI Similarity Search), which allows for efficient similarity search.\n",
    "\n",
    "Check this [Medium article](https://lajavaness.medium.com/indexation-et-recherche-avec-faiss-c7675c42abb9) for more details on Faiss."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {},
   "outputs": [],
   "source": [
    "d = text_embeddings.shape[1] \n",
    "index = faiss.IndexFlatL2(d) # We create a Flat index (exhaustive search) : this can be costly for large datasets\n",
    "index.add(text_embeddings)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {},
   "outputs": [],
   "source": [
    "question = \"Is it possible to make a lot of money and stay true to your values?\"\n",
    "question_embeddings = np.array([get_text_embedding(question)])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Note that since Mistral AI embeddings are norm 1, cosine similarity, dot product or Euclidean distance are all equivalent"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 45,
   "metadata": {},
   "outputs": [],
   "source": [
    "distances, indices = index.search(question_embeddings, k=5) # k is the number of nearest neighbors to return\n",
    "retrieved_chunk = [chunks[i] for i in indices.tolist()[0]]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 46,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The retrieved chunks are:   But by this point I knew enough to find that encouraging instead of discouraging.\n",
      "\n",
      "One of the most conspicuous patterns I've noticed in my life is how well it has worked, for me at least, to work on things that weren't prestigious. Still life has always been the least prestigious form of painting. Viaweb and Y Combinator both seemed lame when we started them. I still get the glassy eye from strangers when they ask what I'm writing, and I explain that it's an essay I'm going to publish on my web site. Even Lisp, though prestigious intellectually in something like the way Latin is, also seems about as hip.\n",
      "\n",
      "It's not that unprestigious types of work are good per se. But when you find yourself drawn to some kind of work despite its current lack of prestige, it's a sign both that there's something real to be discovered there, and that you have the right kind of motives. Impure motives are a big danger for the ambitious. If anything is going to lead you astray, it will be the desire to impress people. So while working on things that aren't prestigious doesn't guarantee you're on the right track, it at least guarantees you're not on the most common type of wrong one.\n",
      "\n",
      "Over the next several years I wrote lots of essays about all kinds of different topics. O'Reilly reprinted a collection of them as a book, called Hackers & Painters after one of the essays in it. I also worked on spam filters, and did some more painting. I used to have dinners for a group of friends every thursday night, which taught me how to cook for groups. And I bought another building in Cambridge, a former candy factory (and later, twas said, porn studio), to use as an office.\n",
      "\n",
      "One night in October 2003 there was a big party at my house. It was a clever idea of my friend Maria Daniels, who was one of the thursday diners. Three separate hosts would all invite their friends to one party. So for every guest, two thirds of the other guests would be people they didn't know but would probably like. One of the guests was someone I didn't know but would tur\n"
     ]
    }
   ],
   "source": [
    "print(\"The retrieved chunks are: \", retrieved_chunk[0])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 47,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Their embeddings are:  [[-0.06359863  0.06427002  0.02284241 ... -0.01721191 -0.01486206\n",
      "  -0.01552582]\n",
      " [-0.06787109  0.03765869  0.04403687 ... -0.01507568 -0.00759506\n",
      "   0.00488663]\n",
      " [-0.03970337  0.05783081  0.01531982 ... -0.03805542 -0.0112381\n",
      "  -0.0096817 ]\n",
      " [-0.07196045  0.04748535  0.02894592 ... -0.03182983 -0.01559448\n",
      "  -0.01236725]\n",
      " [-0.05993652  0.06396484  0.03674316 ... -0.01660156  0.00315666\n",
      "  -0.00465775]]\n"
     ]
    }
   ],
   "source": [
    "print(\"Their embeddings are: \", text_embeddings[indices[0]])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here, we are using a simple similarity search with embeddings, there are also other statistical retrieval methods like `TF-IDF` and `BM25` that use frequency and distribution of terms in the document to identify relevant text chunks."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 48,
   "metadata": {},
   "outputs": [],
   "source": [
    "prompt = f\"\"\"\n",
    "Context information is below.\n",
    "---------------------\n",
    "{retrieved_chunk}\n",
    "---------------------\n",
    "Given the context information and not prior knowledge, answer the query.\n",
    "Query: {question}\n",
    "Answer:\n",
    "\"\"\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 49,
   "metadata": {},
   "outputs": [],
   "source": [
    "def run_mistral(user_message, model=\"mistral-medium\"):\n",
    "    messages = [\n",
    "        ChatMessage(role=\"user\", content=user_message)\n",
    "    ]\n",
    "    chat_response = client.chat(\n",
    "        model=model,\n",
    "        messages=messages\n",
    "    )\n",
    "    return (chat_response.choices[0].message.content)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 50,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "\"Based on the context, the author suggests that it is possible to make a lot of money and stay true to your values. They discuss their own experience of becoming rich through founding a startup, which allowed them to pursue their passion for painting. The author also notes that working on unprestigious projects can be a sign of having the right kind of motives, and that the desire to impress people can be a danger for the ambitious. However, it's worth noting that the context does not explicitly address the question of whether making a lot of money always aligns with one's values, and further information would be needed to answer this question fully.\""
      ]
     },
     "execution_count": 50,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "run_mistral(prompt)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Check Corrective Rag (CRAG) to correct irrelevancy in retrieve documents."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 56,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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LC0txZYtW8S5c+fEc889JxwcHMTVq1eFEEI8+eSTYvHixar5Y2JihJmZmVizZo04f/68CA8PF+bm5uLs2bO6+gg60dj9tmzZMnHgwAGRlpYmTp8+LR5//HFhZWUlkpKSdPURdObmzZuq32UAxNq1a0V8fLzIysoSQgixePFi8eSTT6rmT09PFzY2NmLRokXi/Pnz4pNPPhGmpqZi//79uvoIOtHY/bZu3TqxZ88ekZKSIs6ePSsWLFggTExMxM8//9yo7TJotHEzZ84UAOq8oqKiVPMAEJs3b1a9r66uFv/617+Ei4uLsLS0FCNHjhTJycmtX7yO5efni5CQECGXy4W9vb14+umn1QJaRkaG2r78888/RWBgoHB0dBSWlpbC29tbLFq0SBQWFuroE7SeiIgI0blzZ2FhYSECAgLEiRMnVNOGDh0qZs6cqTb/zp07xf333y8sLCxEjx49xI8//tjKFeuHxuy3F198UTWvi4uLGDt2rPj99991ULXu1Vx2WftVs79mzpwphg4dWmeZPn36CAsLC+Hl5aX2O89YNHa/vffee6JLly7CyspKODo6imHDhokjR440ert8TDwRERFJhvfRICIiIskwaBAREZFkGDSIiIhIMgwaREREJBkGDSIiIpIMgwYRERFJhkGDiIiIJMOgQURERJJh0CAiIiLJMGgQERGRZBg0iIiISDIMGkRERCSZ/wNuwb+fTmBSJQAAAABJRU5ErkJggg==",
      "text/plain": [
       "<Figure size 600x500 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Réduire la dimensionnalité de tous les embeddings avec t-SNE\n",
    "tsne = TSNE(n_components=2, random_state=0)\n",
    "text_embeddings_2d = tsne.fit_transform(text_embeddings)\n",
    "\n",
    "# Sélectionner les embeddings à colorer\n",
    "selected_embeddings_2d = text_embeddings_2d[indices[0]]\n",
    "\n",
    "# Visualiser tous les embeddings\n",
    "plt.figure(figsize=(6, 5))\n",
    "plt.scatter(text_embeddings_2d[:, 0], text_embeddings_2d[:, 1], s=20)\n",
    "\n",
    "# Visualiser et colorer les embeddings sélectionnés\n",
    "plt.scatter(selected_embeddings_2d[:, 0], selected_embeddings_2d[:, 1], s=20, color='red')\n",
    "plt.legend([\"All embeddings\", \"Similar chunks to Q\"], loc=\"best\")\n",
    "plt.title('t-SNE visualization of text embeddings')\n",
    "plt.show()"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "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.11.5"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}