From c34de2197110aa0127f325e01cc42056935f7b4a Mon Sep 17 00:00:00 2001
From: timothyafolami <timmyafolami8469@gmail.com>
Date: Mon, 5 Aug 2024 22:14:19 +0100
Subject: [PATCH] Pdf Ingestion pipeline completed

---
 Projct Structure.txt                          |  16 ++
 data_ingestion/__init__.py                    |   0
 .../__pycache__/__init__.cpython-311.pyc      | Bin 0 -> 199 bytes
 .../__pycache__/utils.cpython-311.pyc         | Bin 0 -> 2192 bytes
 data_ingestion/pdf_ingest.py                  |  42 ++++
 data_ingestion/utils.py                       |  42 ++++
 doc-experiment.ipynb                          | 236 +++++++++++-------
 loggings/__init__.py                          |   0
 loggings/__pycache__/__init__.cpython-311.pyc | Bin 0 -> 193 bytes
 .../logging_config.cpython-311.pyc            | Bin 0 -> 853 bytes
 loggings/app.log                              |  28 +++
 loggings/logging_config.py                    |  19 ++
 search.py                                     |  25 ++
 .../index.faiss                               | Bin
 .../index.pkl                                 | Bin 945205 -> 945207 bytes
 15 files changed, 318 insertions(+), 90 deletions(-)
 create mode 100644 Projct Structure.txt
 create mode 100644 data_ingestion/__init__.py
 create mode 100644 data_ingestion/__pycache__/__init__.cpython-311.pyc
 create mode 100644 data_ingestion/__pycache__/utils.cpython-311.pyc
 create mode 100644 data_ingestion/pdf_ingest.py
 create mode 100644 data_ingestion/utils.py
 create mode 100644 loggings/__init__.py
 create mode 100644 loggings/__pycache__/__init__.cpython-311.pyc
 create mode 100644 loggings/__pycache__/logging_config.cpython-311.pyc
 create mode 100644 loggings/app.log
 create mode 100644 loggings/logging_config.py
 create mode 100644 search.py
 rename vec-db/index/{faiss_index_rand => faiss_index_pdf}/index.faiss (100%)
 rename vec-db/index/{faiss_index_rand => faiss_index_pdf}/index.pkl (94%)

diff --git a/Projct Structure.txt b/Projct Structure.txt
new file mode 100644
index 00000000..8a3af613
--- /dev/null
+++ b/Projct Structure.txt	
@@ -0,0 +1,16 @@
+---- 1. Load User Document
+    ----> Starting with word document. Like Pdf, txt and docx file. 
+    ----> Data Ingestion is meant to take in the user data. Load the embedding model, then create a vector database from it. 
+    ----> Considerations: 
+            1. Pdfs have pages already, hence text splitter won't be used. We want to be able to make reference to the pages the searched document can be found. 
+            2. The apporach for other data types can be different. we can have text splitter fot txt files and if possible add pages to the chunks made for easy reference.
+            3. 
+        
+        Data Ingestion Module: 
+            This module will handle the data ingestion process.
+                uitls.py --> keep the reusable functions 
+                pdf_ingest.py --> This module will handle pdfs 
+
+        
+        Loggings Module: 
+            This module will keep logs of what's going on here. 
\ No newline at end of file
diff --git a/data_ingestion/__init__.py b/data_ingestion/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/data_ingestion/__pycache__/__init__.cpython-311.pyc b/data_ingestion/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..09e0fb0ec7c3d3543f6c4ea5ee2a6dffd79ccaca
GIT binary patch
literal 199
zcmZ3^%ge<81Pvw|(?IlN5CH>>P{wCAAY(d13PUi1CZpd<h9V{)|1(JPS5&f9OlWax
zQE^O3W^Qg}ym4Y_L4HPhj7xrbUQT{uN^y*DVqRi)US@hmi9$e8epYI7NpVa{aeQKC
zW?o8aMNCR!Nn(6vUV3VANoIatOgxaCSrQ+wS5Wzj!zMRBr8Fniu80+A705Bg{6OLZ
QGb1D82L>2X#0(Sz0Dv+zqW}N^

literal 0
HcmV?d00001

diff --git a/data_ingestion/__pycache__/utils.cpython-311.pyc b/data_ingestion/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d392cb33ff8b76ee43c000bf4aacc95475481149
GIT binary patch
literal 2192
zcmZ`(&2JM&6rcU@+TLVS5&{K6XdsEmwhE>|MTHOu3aB86s7O^QGF@$U#?F%cFf;4W
zL~Ch<km!K}he}W(q?}SvP(^Q5PyG|tm8DuMaq6Ms=8B$j>YFvTlN3g?Z)WGs%zN{D
zzxRI9G!;Sn`|K~JA2SI3#eX_Yd^>sbEleIEjIiJ!SC|t7J{KL)mF6UvOZU*6EFvPW
z!M^p*X*8E1nUa9zd%~Q8`>+CImSk|IB;qX0bGRSpVa#Lo2GX_H{M>UP+4E(!T(-UP
zCDS73%jBXvPcVjmrVB~t(z(kwZdhFlFae*D1mBx8AizhV2A*Nb7HVJ_XJ8Zq0aR~W
zh(aM0UnpyEW}Tl)TTKcj@F6?1GI;*nxyyz5GMQ$s={VEGOB76&Y>OnaRmEm9?D-Tl
z_6jjb*R@$)N>ta!#4$Y6B}spKzIex^WtM2fvp{FGe<`=B%ap@T`?%-_k*K}fm<$VJ
z&^ErYP8GjqgtB5_yY8}a+^kmog>vzNf5&rt6SLwq(=!)6ySxyLU8nvnVg;;-nPJ+t
zhsk$EYzC$Q;1L$szE`XUw!@B8mXl$Ay7vGh^_PACb`|*8Sr8Fw4o*Z@n#21am*Sn1
z(beXzPoB-j!^fg)uLkwz$mGkb@%5W6NgNvZ2Z8vPi|9&ALH)a9dDk1b0$Cjf@gM%G
zG*U-l@(68?%B^mMczo92)Oz=1O$<edjWDB&lm|N*C{f=vuy0je;sp$#&vkyN#y8|r
zC=EQ%xH-U)4)Eoj7A0mtj3ofcrv?K-=q}I<!^if5h|nu-sG%KPoqBequAOXXC!?um
zelRM~9sB~Rf=lmy(JZJRp%AUY`2U85P<Vo#ifi!7_3ldr6m<EAfV11R7{RNhnT@^R
z?=+q-qya6IOq(%?C<ND7+0jdmF=j3itc!`tCx+u&rjukU)b;{clmQ@?NQ-2daa=oy
z45fS9#3R_?WTB&==UA{~Ab<m+a=&o55Dy)HW`TfS7f&?A6R~*Wm6(ll`|9FILmY`a
zJw<8@NZkZI1sA?A>>Y?g0OEzTEjil+kZ0%~xM3E`z(<go{vGfah)w+}GcbW9v3XXS
zoaY^;s42@+EOaU52Hg)=&@|v%xG}UTA38`JgslhQV^bjBQe!keaQ4@65YT_$7rVD(
zjn*~V(CB8SyyjH5Hbu8rrG5j=`<cRP(>C@?P|@Tvs%1jy0=ikKDWM!Hy?l8BfISsg
zfcG^y%&c~^2F!FD?C<)5B_7;%+s?QLM?(qAJ$=s#*vyo8h0M$(XhTpFxnctJ+?p;Y
zgUohq$E0?!Y%pR{Ya!|9dc*R)08%tj%u0oLILWyrFgeTgY$D?MBy+n;=yD<~(h;~R
zksz$VSvUz?<&4e3Dx@!O?G#qp*V9iyF%BPF0s$n=_x+h4{Ubm6n5=$P&mV5&4@VQt
zoEnWc)&6L*sSUP}DCwz)tfrEGC^dGB#o9!>*Odvr+IQc%>pVRE!|7F}vGZ_UnQACg
zaoU@C?R)dVhYc{mRxieRJr?zp=rg)NcY_Ns9O8qT9B_b?)`Dq!@Osy+dH~9iUTLSC
z8OhkYHnq!AT9sH@=+biBW-YH$X=YMR%JliqQR+d8%SP@r6!5A;&d|?5&r1yZ8AMAG
z1fhw(h`078Iu>v3tz1^v-9lY4j0O(H+QGUu-q6M)wUt9hJ_q!Kq3uEyh5dYOvry6a
V^vlWZJJZu@R`{5kd8bI<^B<h`7Q+Al

literal 0
HcmV?d00001

diff --git a/data_ingestion/pdf_ingest.py b/data_ingestion/pdf_ingest.py
new file mode 100644
index 00000000..951d5d0a
--- /dev/null
+++ b/data_ingestion/pdf_ingest.py
@@ -0,0 +1,42 @@
+from langchain_community.document_loaders import PyPDFLoader
+from utils import create_vector_store, save_embedded_data
+import sys, os
+
+#  Add the root directory to sys.path
+sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
+from loggings.logging_config import logger
+
+# A function to load the pdf document
+def load_pdf_document(document_path: str):
+    logger.info(f"Loading document from {document_path}")
+    logger.info(f"Checking if the document is a pdf")
+    if document_path.endswith(".pdf"):
+        logger.info(f"Document is a pdf")
+        logger.info(f"Loading and splitting the document")
+        pdf_doc = PyPDFLoader(document_path)
+        pages = pdf_doc.load_and_split()
+        logger.info(f"Document loaded and split into {len(pages)} pages")
+        return pages
+    else:
+        logger.error(f"Unsupported document type for {document_path}")
+        raise ValueError(f"Unsupported document type for {document_path}")
+    
+# creating a function that loads the pdf document and creates the vector store
+def load_and_create_vector_store(document_path: str):
+    logger.info(f"Loading and creating vector store for {document_path}")
+    pages = load_pdf_document(document_path)
+    logger.info(f"Creating vector store")
+    embed_db = create_vector_store(pages)
+    logger.info(f"Vector store created")
+    logger.info(f"Saving the vector store") 
+    # saving the embedded data
+    save_embedded_data(embed_db)
+    logger.info(f"Vector store saved")
+    
+    return "Vector store created and saved"
+
+
+
+if __name__ == "__main__":
+    document_path = "./data/corolla-2020-toyota-owners-manual.pdf"
+    load_and_create_vector_store(document_path)
\ No newline at end of file
diff --git a/data_ingestion/utils.py b/data_ingestion/utils.py
new file mode 100644
index 00000000..817e18fc
--- /dev/null
+++ b/data_ingestion/utils.py
@@ -0,0 +1,42 @@
+from langchain_community.embeddings import HuggingFaceBgeEmbeddings
+from langchain_community.vectorstores import FAISS
+
+
+# loading the embedding model
+def load_embedding_model():
+    model_name = "BAAI/bge-small-en"
+    model_kwargs = {"device": "cuda"} #can also be cpu
+    encode_kwargs = {"normalize_embeddings": True}
+    embeddings = HuggingFaceBgeEmbeddings(
+                model_name=model_name, model_kwargs=model_kwargs, encode_kwargs=encode_kwargs
+            )
+    return embeddings
+
+# loading the embedding model
+embeddings = load_embedding_model()
+
+
+# A function to create the vector store
+def create_vector_store(document, embeddings=embeddings):
+  embed_db = FAISS.from_documents(document, embeddings)
+  return embed_db
+
+# A function to save the embedded data
+def save_embedded_data(docs,  key="pdf"):
+  docs.save_local(f"vec-db/index/faiss_index_{key}")
+  print("Embeddings saved")
+
+# A function to load the embedded data
+def load_embedded_data(embeddings=embeddings, key="pdf"):
+  embed_db = FAISS.load_local(f"vec-db/index/faiss_index_{key}", embeddings, allow_dangerous_deserialization=True)
+  return embed_db
+
+# A document search function
+def search(db, query, k=4):
+  docs = db.similarity_search(query, k)
+  all = ""
+  pages = []
+  for doc in docs:
+      all += f"{doc.page_content}\n"
+      pages.append(doc.metadata['page'])
+  return docs[0].page_content, all, pages
diff --git a/doc-experiment.ipynb b/doc-experiment.ipynb
index 66761e5e..2d93ec1c 100644
--- a/doc-experiment.ipynb
+++ b/doc-experiment.ipynb
@@ -1,20 +1,35 @@
 {
  "cells": [
   {
-   "cell_type": "code",
-   "execution_count": 1,
+   "cell_type": "markdown",
    "metadata": {},
-   "outputs": [],
    "source": [
-    "from langchain_community.embeddings import HuggingFaceBgeEmbeddings\n",
-    "from langchain_text_splitters import RecursiveCharacterTextSplitter\n",
-    "from langchain_community.vectorstores import FAISS"
+    "## Libs import"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 2,
    "metadata": {},
+   "outputs": [],
+   "source": [
+    "from langchain_community.embeddings import HuggingFaceBgeEmbeddings\n",
+    "from langchain_text_splitters import RecursiveCharacterTextSplitter\n",
+    "from langchain_community.vectorstores import FAISS\n",
+    "from langchain_community.document_loaders import PyPDFLoader"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Loading the embeddings model"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
    "outputs": [
     {
      "name": "stderr",
@@ -32,27 +47,14 @@
     "encode_kwargs = {\"normalize_embeddings\": True}\n",
     "embeddings = HuggingFaceBgeEmbeddings(\n",
     "            model_name=model_name, model_kwargs=model_kwargs, encode_kwargs=encode_kwargs\n",
-    "        )\n",
-    "\n"
+    "        )"
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": 3,
+   "cell_type": "markdown",
    "metadata": {},
-   "outputs": [],
    "source": [
-    "from langchain_community.document_loaders import PyPDFLoader"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 4,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "# Load the document \n",
-    "loader = PyPDFLoader(\"data/corolla-2020-toyota-owners-manual.pdf\")"
+    "## Experiment for pdf loading"
    ]
   },
   {
@@ -61,85 +63,54 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "pages = loader.load_and_split()"
+    "# creating a function that checks the document type and loads the document\n",
+    "def load_pdf_document(document_path):\n",
+    "    if document_path.endswith(\".pdf\"):\n",
+    "        pdf_doc = PyPDFLoader(document_path)\n",
+    "        pages = pdf_doc.load_and_split()\n",
+    "        return pages\n",
+    "    else:\n",
+    "        raise ValueError(f\"Unsupported document type for {document_path}\")\n"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 6,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "588"
-      ]
-     },
-     "execution_count": 6,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
+   "outputs": [],
    "source": [
-    "len(pages)"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 7,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "Document(metadata={'source': 'data/corolla-2020-toyota-owners-manual.pdf', 'page': 0}, page_content='1\\n2\\n3\\n456789\\n9\\n10\\nCOROLLA_UPictorial index Search by illustration\\nFor safety \\nand securityMake sure to read through them\\n(Main topics: Child seat, theft deterrent system)\\nVehicle status information and \\nindicatorsReading driving-related information\\n(Main topics: Meters, multi-information display)\\nBefore drivingOpening and closing the doors and windows, \\nadjustment before driving\\n(Main topics: Keys, doors, seats)\\nDrivingOperations and advice which are necessary for driving\\n(Main topics: Starting engine, refueling)\\nEntune audioOperating the Entune Audio\\n(Main topics: Audio/visual, phone, Toyota Entune)\\nInterior featuresUsage of the interior features\\n(Main topics: Air conditioner, storage features)\\nMaintenance \\nand careCaring for your vehicle and maintenance \\nprocedures\\n(Main topics: Interior and exterior, light bulbs)\\nWhen trouble \\narisesWhat to do in case of malfunction and emergency\\n(Main topics: Battery discharge, flat tire)\\nVehicle specifications Vehicle specifications, customizable features\\n(Main topics: Fuel, oil, tire inflation pressure)\\nFor ownersReporting safety defects for U.S. owners, and seat \\nbelt and SRS airbag instructions for Canadian owners\\nIndexSearch by symptom\\nSearch alphabetically\\nhttps://www.MyCarManual.com')"
-      ]
-     },
-     "execution_count": 7,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "pages[0]"
+    "# Load the document \n",
+    "document_path = \"data/corolla-2020-toyota-owners-manual.pdf\"\n",
+    "pdf_pages = load_pdf_document(document_path)"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 8,
    "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "c:\\Users\\timmy_3aupohg\\anaconda3\\envs\\smog_env\\Lib\\site-packages\\transformers\\models\\bert\\modeling_bert.py:439: UserWarning: 1Torch was not compiled with flash attention. (Triggered internally at C:\\cb\\pytorch_1000000000000\\work\\aten\\src\\ATen\\native\\transformers\\cuda\\sdp_utils.cpp:555.)\n",
-      "  attn_output = torch.nn.functional.scaled_dot_product_attention(\n"
-     ]
-    }
-   ],
+   "outputs": [],
    "source": [
-    "db = FAISS.from_documents(pages, embeddings)"
+    "db = FAISS.from_documents(pdf_pages, embeddings)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 20,
+   "execution_count": 10,
    "metadata": {},
    "outputs": [],
    "source": [
-    "def save_embedded_data(embeddings, key=\"rand\"):\n",
+    "def save_embedded_data(embeddings, key=\"pdf\"):\n",
     "  embeddings.save_local(f\"vec-db/index/faiss_index_{key}\")\n",
     "  print(\"Embeddings saved\")\n",
     "\n",
-    "def load_embedded_data(embeddings, key):\n",
+    "def load_embedded_data(embeddings, key=\"pdf\"):\n",
     "  embed_db = FAISS.load_local(f\"vec-db/index/faiss_index_{key}\", embeddings, allow_dangerous_deserialization=True)\n",
     "  return embed_db"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 10,
+   "execution_count": 11,
    "metadata": {},
    "outputs": [
     {
@@ -151,16 +122,23 @@
     }
    ],
    "source": [
-    "save_embedded_data(db, key=\"rand\")"
+    "save_embedded_data(db)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 23,
+   "execution_count": 12,
    "metadata": {},
    "outputs": [],
    "source": [
-    "load_db = load_embedded_data(embeddings, key=\"rand\")"
+    "load_db = load_embedded_data(embeddings)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Data Search"
    ]
   },
   {
@@ -270,44 +248,122 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 15,
    "metadata": {},
    "outputs": [],
    "source": [
     "def search(db, query, k=4):\n",
     "  docs = db.similarity_search(query, k)\n",
     "  all = \"\"\n",
+    "  pages = []\n",
     "  for doc in docs:\n",
     "      all += f\"{doc.page_content}\\n\"\n",
-    "  return docs[0].page_content, all"
+    "      pages.append(doc.metadata['page'])\n",
+    "  return docs[0].page_content, all, pages"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 16,
    "metadata": {},
    "outputs": [
     {
-     "ename": "TypeError",
-     "evalue": "'FAISS' object is not callable",
-     "output_type": "error",
-     "traceback": [
-      "\u001b[1;31m---------------------------------------------------------------------------\u001b[0m",
-      "\u001b[1;31mTypeError\u001b[0m                                 Traceback (most recent call last)",
-      "Cell \u001b[1;32mIn[16], line 1\u001b[0m\n\u001b[1;32m----> 1\u001b[0m search_result, \u001b[38;5;28mall\u001b[39m \u001b[38;5;241m=\u001b[39m \u001b[43msearch\u001b[49m\u001b[43m(\u001b[49m\u001b[43mdb\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[38;5;124;43mWhat is LDA\u001b[39;49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[43m)\u001b[49m\n\u001b[0;32m      2\u001b[0m \u001b[38;5;28mprint\u001b[39m( search_result )\n",
-      "Cell \u001b[1;32mIn[15], line 2\u001b[0m, in \u001b[0;36msearch\u001b[1;34m(db, query, k)\u001b[0m\n\u001b[0;32m      1\u001b[0m \u001b[38;5;28;01mdef\u001b[39;00m \u001b[38;5;21msearch\u001b[39m(db, query, k\u001b[38;5;241m=\u001b[39m\u001b[38;5;241m4\u001b[39m):\n\u001b[1;32m----> 2\u001b[0m   docs \u001b[38;5;241m=\u001b[39m \u001b[43mdb\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43msimilarity_search\u001b[49m\u001b[43m(\u001b[49m\u001b[43mquery\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mk\u001b[49m\u001b[43m)\u001b[49m\n\u001b[0;32m      3\u001b[0m   \u001b[38;5;28mall\u001b[39m \u001b[38;5;241m=\u001b[39m \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124m\"\u001b[39m\n\u001b[0;32m      4\u001b[0m   \u001b[38;5;28;01mfor\u001b[39;00m doc \u001b[38;5;129;01min\u001b[39;00m docs:\n",
-      "File \u001b[1;32mc:\\Users\\timmy_3aupohg\\anaconda3\\envs\\smog_env\\Lib\\site-packages\\langchain_community\\vectorstores\\faiss.py:530\u001b[0m, in \u001b[0;36mFAISS.similarity_search\u001b[1;34m(self, query, k, filter, fetch_k, **kwargs)\u001b[0m\n\u001b[0;32m    510\u001b[0m \u001b[38;5;28;01mdef\u001b[39;00m \u001b[38;5;21msimilarity_search\u001b[39m(\n\u001b[0;32m    511\u001b[0m     \u001b[38;5;28mself\u001b[39m,\n\u001b[0;32m    512\u001b[0m     query: \u001b[38;5;28mstr\u001b[39m,\n\u001b[1;32m   (...)\u001b[0m\n\u001b[0;32m    516\u001b[0m     \u001b[38;5;241m*\u001b[39m\u001b[38;5;241m*\u001b[39mkwargs: Any,\n\u001b[0;32m    517\u001b[0m ) \u001b[38;5;241m-\u001b[39m\u001b[38;5;241m>\u001b[39m List[Document]:\n\u001b[0;32m    518\u001b[0m \u001b[38;5;250m    \u001b[39m\u001b[38;5;124;03m\"\"\"Return docs most similar to query.\u001b[39;00m\n\u001b[0;32m    519\u001b[0m \n\u001b[0;32m    520\u001b[0m \u001b[38;5;124;03m    Args:\u001b[39;00m\n\u001b[1;32m   (...)\u001b[0m\n\u001b[0;32m    528\u001b[0m \u001b[38;5;124;03m        List of Documents most similar to the query.\u001b[39;00m\n\u001b[0;32m    529\u001b[0m \u001b[38;5;124;03m    \"\"\"\u001b[39;00m\n\u001b[1;32m--> 530\u001b[0m     docs_and_scores \u001b[38;5;241m=\u001b[39m \u001b[38;5;28;43mself\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43msimilarity_search_with_score\u001b[49m\u001b[43m(\u001b[49m\n\u001b[0;32m    531\u001b[0m \u001b[43m        \u001b[49m\u001b[43mquery\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mk\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;28;43mfilter\u001b[39;49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[38;5;28;43mfilter\u001b[39;49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mfetch_k\u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[43mfetch_k\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;241;43m*\u001b[39;49m\u001b[38;5;241;43m*\u001b[39;49m\u001b[43mkwargs\u001b[49m\n\u001b[0;32m    532\u001b[0m \u001b[43m    \u001b[49m\u001b[43m)\u001b[49m\n\u001b[0;32m    533\u001b[0m     \u001b[38;5;28;01mreturn\u001b[39;00m [doc \u001b[38;5;28;01mfor\u001b[39;00m doc, _ \u001b[38;5;129;01min\u001b[39;00m docs_and_scores]\n",
-      "File \u001b[1;32mc:\\Users\\timmy_3aupohg\\anaconda3\\envs\\smog_env\\Lib\\site-packages\\langchain_community\\vectorstores\\faiss.py:402\u001b[0m, in \u001b[0;36mFAISS.similarity_search_with_score\u001b[1;34m(self, query, k, filter, fetch_k, **kwargs)\u001b[0m\n\u001b[0;32m    378\u001b[0m \u001b[38;5;28;01mdef\u001b[39;00m \u001b[38;5;21msimilarity_search_with_score\u001b[39m(\n\u001b[0;32m    379\u001b[0m     \u001b[38;5;28mself\u001b[39m,\n\u001b[0;32m    380\u001b[0m     query: \u001b[38;5;28mstr\u001b[39m,\n\u001b[1;32m   (...)\u001b[0m\n\u001b[0;32m    384\u001b[0m     \u001b[38;5;241m*\u001b[39m\u001b[38;5;241m*\u001b[39mkwargs: Any,\n\u001b[0;32m    385\u001b[0m ) \u001b[38;5;241m-\u001b[39m\u001b[38;5;241m>\u001b[39m List[Tuple[Document, \u001b[38;5;28mfloat\u001b[39m]]:\n\u001b[0;32m    386\u001b[0m \u001b[38;5;250m    \u001b[39m\u001b[38;5;124;03m\"\"\"Return docs most similar to query.\u001b[39;00m\n\u001b[0;32m    387\u001b[0m \n\u001b[0;32m    388\u001b[0m \u001b[38;5;124;03m    Args:\u001b[39;00m\n\u001b[1;32m   (...)\u001b[0m\n\u001b[0;32m    400\u001b[0m \u001b[38;5;124;03m        L2 distance in float. Lower score represents more similarity.\u001b[39;00m\n\u001b[0;32m    401\u001b[0m \u001b[38;5;124;03m    \"\"\"\u001b[39;00m\n\u001b[1;32m--> 402\u001b[0m     embedding \u001b[38;5;241m=\u001b[39m \u001b[38;5;28;43mself\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43m_embed_query\u001b[49m\u001b[43m(\u001b[49m\u001b[43mquery\u001b[49m\u001b[43m)\u001b[49m\n\u001b[0;32m    403\u001b[0m     docs \u001b[38;5;241m=\u001b[39m \u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39msimilarity_search_with_score_by_vector(\n\u001b[0;32m    404\u001b[0m         embedding,\n\u001b[0;32m    405\u001b[0m         k,\n\u001b[1;32m   (...)\u001b[0m\n\u001b[0;32m    408\u001b[0m         \u001b[38;5;241m*\u001b[39m\u001b[38;5;241m*\u001b[39mkwargs,\n\u001b[0;32m    409\u001b[0m     )\n\u001b[0;32m    410\u001b[0m     \u001b[38;5;28;01mreturn\u001b[39;00m docs\n",
-      "File \u001b[1;32mc:\\Users\\timmy_3aupohg\\anaconda3\\envs\\smog_env\\Lib\\site-packages\\langchain_community\\vectorstores\\faiss.py:156\u001b[0m, in \u001b[0;36mFAISS._embed_query\u001b[1;34m(self, text)\u001b[0m\n\u001b[0;32m    154\u001b[0m     \u001b[38;5;28;01mreturn\u001b[39;00m \u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39membedding_function\u001b[38;5;241m.\u001b[39membed_query(text)\n\u001b[0;32m    155\u001b[0m \u001b[38;5;28;01melse\u001b[39;00m:\n\u001b[1;32m--> 156\u001b[0m     \u001b[38;5;28;01mreturn\u001b[39;00m \u001b[38;5;28;43mself\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43membedding_function\u001b[49m\u001b[43m(\u001b[49m\u001b[43mtext\u001b[49m\u001b[43m)\u001b[49m\n",
-      "\u001b[1;31mTypeError\u001b[0m: 'FAISS' object is not callable"
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "206 4-5. Using the driving support systems\n",
+      "COROLLA_UWARNING\n",
+      "■Before using LDA system\n",
+      "●Do not rely solely upon the LDA \n",
+      "system. The LDA system does \n",
+      "not automatically drive the vehi-cle or reduce the amount of \n",
+      "attention that must be paid to \n",
+      "the area in front of the vehicle. The driver must always assume \n",
+      "full responsibilit y for driving \n",
+      "safely by paying careful atten-\n",
+      "tion to the surrounding condi-tions and operating the steering \n",
+      "wheel to correct the path of the \n",
+      "vehicle. Also, the driver must take adequate breaks when \n",
+      "fatigued, such as from driving \n",
+      "for a long period of time.\n",
+      "●Failure to perform  appropriate \n",
+      "driving operations and pay care-\n",
+      "ful attention may lead to an \n",
+      "accident, resulting in death or serious injury.\n",
+      "●When not using the LDA sys-\n",
+      "tem, use the LDA switch to turn \n",
+      "the system off.\n",
+      "■Situations unsuitable for LDA system\n",
+      "In the following situations, use the LDA switch to turn the system off. \n",
+      "Failure to do so may lead to an \n",
+      "accident, resulting in death or serious injury.\n",
+      "●Vehicle is driven on a road sur-\n",
+      "face which is slippery due to \n",
+      "rainy weather, fallen snow, freezing, etc.\n",
+      "●Vehicle is driven on a snow-cov-\n",
+      "ered road.\n",
+      "●White (yellow) lin es are difficult \n",
+      "to see due to rain, snow, fog, \n",
+      "dust, etc.\n",
+      "●A spare tire, tire chains, etc. are \n",
+      "equipped.●When the tires have been excessively worn, or when the \n",
+      "tire inflation p ressure is low.\n",
+      "●When tires of a size other than specified are installed.\n",
+      "●Vehicle is driven in traffic lanes \n",
+      "other than that highways and \n",
+      "freeways.\n",
+      "●During emergency towing.\n",
+      "■Preventing LDA system mal-functions and operations per-\n",
+      "formed by mistake\n",
+      "●Do not modify the headlights or place stickers, etc. on the sur-\n",
+      "face of the lights.\n",
+      "●Do not modify the suspension etc. If the suspension etc. needs \n",
+      "to be replaced, contact your \n",
+      "Toyota dealer.\n",
+      "●Do not install or place anything on the hoo d or grille. Also, do \n",
+      "not install a gr ille guard (bull \n",
+      "bars, kangaroo bar, etc.).\n",
+      "●If your windshield needs repairs, contact your Toyota \n",
+      "dealer.\n",
+      "■Conditions in which functions \n",
+      "may not operate properly\n",
+      "In the following situations, the \n",
+      "functions may not operate prop-erly and the vehicle may depart \n",
+      "from its lane. Drive safely by \n",
+      "always paying careful attention to your surroundings and operate \n",
+      "the steering whee l to correct the \n",
+      "path of the vehicle without relying \n",
+      "solely on the functions.\n",
+      "●Vehicle is being driven around a sharp curve.\n",
+      "https://www.MyCarManual.com\n"
      ]
     }
    ],
    "source": [
-    "search_result, all = search(db, \"What is LDA\")\n",
+    "search_result, all, pages = search(db, \"What is LDA\")\n",
     "print( search_result )"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[205, 208, 204, 212]"
+      ]
+     },
+     "execution_count": 17,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "pages"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
diff --git a/loggings/__init__.py b/loggings/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/loggings/__pycache__/__init__.cpython-311.pyc b/loggings/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..916d547fff74a5695797d9fd0adf0549d858908c
GIT binary patch
literal 193
zcmZ3^%ge<81hdRGrh(|kAOZ#$p^VRLK*n^26oz01O-8?!3`I;p{%4TnuaIP`n9$<X
zqT-m6%-r0{c;m#<g8Yp17?=F=yqx^Rl;RlQ#Jt4pyv+2B5`}=G{H)aElH!<@;`qeO
z%)FG;ikO`I^z_WU^x~NK_{_Y_lK6PNg34bUHo5sJr8%i~MXW$eK+Y)U2NEBc85tQr
LFu;f+W}p}V8~ig$

literal 0
HcmV?d00001

diff --git a/loggings/__pycache__/logging_config.cpython-311.pyc b/loggings/__pycache__/logging_config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb3bcabc24b11968d5d9d6112e360dd8bf32eab2
GIT binary patch
literal 853
zcmZ8f&1(}u6o0$fY&L0A3x#$uQc`HKu{JqKRYW}a5nGI{P`re|GG?cnP4^@0Z0*OP
zEK<;8Z|2~^Q&s9k|B?pw5av|y<ZY#%dUAG~39a*X-g`gZZ{GVo*f05f4%oSS@5jb1
z5#U!0_{j{CGY|kif)2W1LH!~MgDBQTEVfhp$!CdYm!mEou@1-VUK}zm0(+I_`2V^9
zda5on4z#(3I9G;zDXC>S#`4wvNj2FkW*o75%&B0A-_u7-@9|Kx011DDQ}F23ZuPt_
ztV2ou9TQfmV!4K4ItJMr=UD}HI%Nj-N^|pwG=0;?B~n~0&dpo+Ew&sq#5N`b8LV1L
z(R5Oz@`mf#$frsRIl6^CQW~R~L1)TGlzEYgE}>Ef`7J8r9h3NkDmL20y6Lg3w)R}B
zuGF5<kvE8#%_pw2VH#9gS*@<ok*aCo<%=0KzwUb&*&JpK?AO>@*rST3#d<Z3%CQLS
zeS@=j@$-7~LE|-H`WkFMdsn-IwmNRhXgqbd9m_>JX}m-Z+H_2#<riOhZW}j!($I;9
zOw-ZvPGhhW;fdBv<dr+S=gLFd)weAC$Wz&<_&*^(nTt|_AoO7@NURT2C;aO}Hb^Xz
zLCGC#zu$kif7tG2X2Q%&1cGp*FI@{BAG|os^`t^56;7lAV~$P-$|+0)nGhzrH$UC(
z7pkY~LN^nt3tyLe>QbmK_0`1~FZR?*s8*tMYI-tCr-i9Mz}(;1MTr}OT;ao1n7!V;
R-^<R1+1Wsj&6{Mh{{dj@-gW>0

literal 0
HcmV?d00001

diff --git a/loggings/app.log b/loggings/app.log
new file mode 100644
index 00000000..762510e3
--- /dev/null
+++ b/loggings/app.log
@@ -0,0 +1,28 @@
+2024-08-05 22:09:11,365 - INFO - Loading and creating vector store for ./data/corolla-2020-toyota-owners-manual.pdf
+2024-08-05 22:09:11,365 - INFO - Loading document from ./data/corolla-2020-toyota-owners-manual.pdf
+2024-08-05 22:09:11,365 - INFO - Checking if the document is a pdf
+2024-08-05 22:09:11,365 - INFO - Document is a pdf
+2024-08-05 22:09:11,365 - INFO - Loading and splitting the document
+2024-08-05 22:09:56,949 - INFO - Document loaded and split into 588 pages
+2024-08-05 22:09:56,949 - INFO - Creating vector store
+2024-08-05 22:10:06,736 - INFO - Loading faiss with AVX2 support.
+2024-08-05 22:10:06,774 - INFO - Successfully loaded faiss with AVX2 support.
+2024-08-05 22:10:06,800 - INFO - Vector store created
+2024-08-05 22:10:06,802 - INFO - Saving the vector store
+2024-08-05 22:11:24,966 - INFO - Loading and creating vector store for ./data/corolla-2020-toyota-owners-manual.pdf
+2024-08-05 22:11:24,966 - INFO - Loading document from ./data/corolla-2020-toyota-owners-manual.pdf
+2024-08-05 22:11:24,966 - INFO - Checking if the document is a pdf
+2024-08-05 22:11:24,966 - INFO - Document is a pdf
+2024-08-05 22:11:24,966 - INFO - Loading and splitting the document
+2024-08-05 22:12:09,202 - INFO - Document loaded and split into 588 pages
+2024-08-05 22:12:09,202 - INFO - Creating vector store
+2024-08-05 22:12:19,066 - INFO - Loading faiss with AVX2 support.
+2024-08-05 22:12:19,089 - INFO - Successfully loaded faiss with AVX2 support.
+2024-08-05 22:12:19,123 - INFO - Vector store created
+2024-08-05 22:12:19,123 - INFO - Saving the vector store
+2024-08-05 22:12:19,131 - INFO - Vector store saved
+2024-08-05 22:12:55,111 - INFO - Loading faiss with AVX2 support.
+2024-08-05 22:12:55,144 - INFO - Successfully loaded faiss with AVX2 support.
+2024-08-05 22:12:55,205 - INFO - Receiving the search query
+2024-08-05 22:13:04,060 - INFO - Searching for what is LDA?
+2024-08-05 22:13:04,241 - INFO - Search completed
diff --git a/loggings/logging_config.py b/loggings/logging_config.py
new file mode 100644
index 00000000..b8535061
--- /dev/null
+++ b/loggings/logging_config.py
@@ -0,0 +1,19 @@
+import logging
+import logging.handlers
+import os
+
+# Create loggings directory if it doesn't exist
+if not os.path.exists('loggings'):
+    os.makedirs('loggings')
+
+# Define the logging configuration
+LOG_FILE = 'loggings/app.log'
+
+logging.basicConfig(level=logging.INFO,
+                    format='%(asctime)s - %(levelname)s - %(message)s',
+                    handlers=[
+                        logging.FileHandler(LOG_FILE),
+                        logging.StreamHandler()
+                    ])
+
+logger = logging.getLogger(__name__)
diff --git a/search.py b/search.py
new file mode 100644
index 00000000..258ee37f
--- /dev/null
+++ b/search.py
@@ -0,0 +1,25 @@
+from data_ingestion.utils import search, load_embedded_data
+import sys, os
+
+#  Add the root directory to sys.path
+sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
+from loggings.logging_config import logger
+
+
+
+# loading the embedded data
+embed_db = load_embedded_data()
+
+
+
+if __name__ == "__main__":
+    logger.info("Receiving the search query")
+    query = input("Enter the search query: ")
+    logger.info(f"Searching for {query}")
+    page_content, all, pages = search(embed_db, query)
+    logger.info("Search completed")
+    logger.info(f"Page content: {page_content}")
+    print(f"Page content: {page_content}")
+    print(f"Pages: {pages}")
+    print(f"All: {all}")
+    print("Search completed")
\ No newline at end of file
diff --git a/vec-db/index/faiss_index_rand/index.faiss b/vec-db/index/faiss_index_pdf/index.faiss
similarity index 100%
rename from vec-db/index/faiss_index_rand/index.faiss
rename to vec-db/index/faiss_index_pdf/index.faiss
diff --git a/vec-db/index/faiss_index_rand/index.pkl b/vec-db/index/faiss_index_pdf/index.pkl
similarity index 94%
rename from vec-db/index/faiss_index_rand/index.pkl
rename to vec-db/index/faiss_index_pdf/index.pkl
index 046f332aae6b3a6b8f70cd92b133491d862611b3..3492cbc0660f8b3d1b02c3a88edc7168024a2ac9 100644
GIT binary patch
delta 34481
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
K?~{K1>i-vpn|_Y~

delta 34396
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
Wy!9TZ9ba8Db$NOEy-xetEB}AzgYnw{