From bfeab16e90309d54b6d71a042cba32644468bdd0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Louis=20Brul=C3=A9=20Naudet?= <louisbrulenaudet@icloud.com>
Date: Sat, 27 Jul 2024 12:53:02 +0200
Subject: [PATCH] Test commit

---
 docs/build/doctrees/environment.pickle  |  Bin 0 -> 136092 bytes
 docs/build/doctrees/index.doctree       |  Bin 0 -> 6545 bytes
 docs/build/doctrees/ragoon.doctree      |  Bin 0 -> 314899 bytes
 docs/build/html/_sources/index.rst.txt  |   41 +
 docs/build/html/_sources/ragoon.rst.txt |   37 +
 docs/build/html/genindex.html           |  675 ++++++++++
 docs/build/html/index.html              |  473 ++++++++
 docs/build/html/modules.html            |  559 +++++++++
 docs/build/html/objects.inv             |  Bin 0 -> 750 bytes
 docs/build/html/py-modindex.html        |  425 +++++++
 docs/build/html/ragoon.html             | 1486 +++++++++++++++++++++++
 docs/build/html/searchindex.js          |    1 +
 docs/source/conf.py                     |    2 -
 docs/source/index.rst                   |    7 +-
 docs/source/introduction.rst            |    8 -
 15 files changed, 3702 insertions(+), 12 deletions(-)
 create mode 100644 docs/build/doctrees/environment.pickle
 create mode 100644 docs/build/doctrees/index.doctree
 create mode 100644 docs/build/doctrees/ragoon.doctree
 create mode 100644 docs/build/html/_sources/index.rst.txt
 create mode 100644 docs/build/html/_sources/ragoon.rst.txt
 create mode 100644 docs/build/html/genindex.html
 create mode 100644 docs/build/html/index.html
 create mode 100644 docs/build/html/modules.html
 create mode 100644 docs/build/html/objects.inv
 create mode 100644 docs/build/html/py-modindex.html
 create mode 100644 docs/build/html/ragoon.html
 create mode 100644 docs/build/html/searchindex.js
 delete mode 100644 docs/source/introduction.rst

diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees/environment.pickle
new file mode 100644
index 0000000000000000000000000000000000000000..8b25d64dfa048622306be66842bd58482c20953f
GIT binary patch
literal 136092
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

literal 0
HcmV?d00001

diff --git a/docs/build/doctrees/index.doctree b/docs/build/doctrees/index.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..476123cc3b37371dc5a196ecdc0a417c38ba8ac5
GIT binary patch
literal 6545
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
QPM|J{BA%-1CF^hg8=zo`VE_OC

literal 0
HcmV?d00001

diff --git a/docs/build/doctrees/ragoon.doctree b/docs/build/doctrees/ragoon.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..39c601a90c05855b70bf2f8bcf4fdacc0d64cecf
GIT binary patch
literal 314899
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
KX`AhgM*lw_GS1Kd

literal 0
HcmV?d00001

diff --git a/docs/build/html/_sources/index.rst.txt b/docs/build/html/_sources/index.rst.txt
new file mode 100644
index 0000000..398fb63
--- /dev/null
+++ b/docs/build/html/_sources/index.rst.txt
@@ -0,0 +1,41 @@
+.. RAGoon documentation master file, created by
+   sphinx-quickstart on Fri Jul 26 22:25:47 2024.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+RAGoon documentation
+====================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Modules:
+
+   modules
+   ragoon
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+
+ragoon package
+===============
+
+.. automodule:: ragoon
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Submodules
+----------
+
+.. toctree::
+   :maxdepth: 2
+
+   ragoon.embeddings
+   ragoon.similarity_search
+   ragoon.web_rag
diff --git a/docs/build/html/_sources/ragoon.rst.txt b/docs/build/html/_sources/ragoon.rst.txt
new file mode 100644
index 0000000..d51885a
--- /dev/null
+++ b/docs/build/html/_sources/ragoon.rst.txt
@@ -0,0 +1,37 @@
+ragoon package
+==============
+
+Submodules
+----------
+
+ragoon.embeddings module
+------------------------
+
+.. automodule:: ragoon.embeddings
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+ragoon.similarity\_search module
+--------------------------------
+
+.. automodule:: ragoon.similarity_search
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+ragoon.web\_rag module
+----------------------
+
+.. automodule:: ragoon.web_rag
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: ragoon
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/build/html/genindex.html b/docs/build/html/genindex.html
new file mode 100644
index 0000000..ff495c1
--- /dev/null
+++ b/docs/build/html/genindex.html
@@ -0,0 +1,675 @@
+
+<!DOCTYPE html>
+
+
+<html lang="en" data-content_root="./" >
+
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Index &#8212; RAGoon 0.0.4 documentation</title>
+  
+  
+  
+  <script data-cfasync="false">
+    document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
+    document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
+  </script>
+  
+  <!-- Loaded before other Sphinx assets -->
+  <link href="_static/styles/theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/bootstrap.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/pydata-sphinx-theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+
+  
+  <link href="_static/vendor/fontawesome/6.5.2/css/all.min.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+  <link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-solid-900.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-brands-400.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-regular-400.woff2" />
+
+    <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
+  
+  <!-- Pre-loaded scripts that we'll load fully later -->
+  <link rel="preload" as="script" href="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b" />
+<link rel="preload" as="script" href="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
+  <script src="_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+    <script src="_static/documentation_options.js?v=8c5712d9"></script>
+    <script src="_static/doctools.js?v=9a2dae69"></script>
+    <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script>DOCUMENTATION_OPTIONS.pagename = 'genindex';</script>
+    <link rel="index" title="Index" href="#" />
+    <link rel="search" title="Search" href="search.html" />
+  <meta name="viewport" content="width=device-width, initial-scale=1"/>
+  <meta name="docsearch:language" content="en"/>
+  </head>
+  
+  
+  <body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">
+
+  
+  
+  <div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>
+  
+  <div id="pst-scroll-pixel-helper"></div>
+  
+  <button type="button" class="btn rounded-pill" id="pst-back-to-top">
+    <i class="fa-solid fa-arrow-up"></i>Back to top</button>
+
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-primary-sidebar-checkbox"/>
+  <label class="overlay overlay-primary" for="pst-primary-sidebar-checkbox"></label>
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-secondary-sidebar-checkbox"/>
+  <label class="overlay overlay-secondary" for="pst-secondary-sidebar-checkbox"></label>
+  
+  <div class="search-button__wrapper">
+    <div class="search-button__overlay"></div>
+    <div class="search-button__search-container">
+<form class="bd-search d-flex align-items-center"
+      action="search.html"
+      method="get">
+  <i class="fa-solid fa-magnifying-glass"></i>
+  <input type="search"
+         class="form-control"
+         name="q"
+         id="search-input"
+         placeholder="Search the docs ..."
+         aria-label="Search the docs ..."
+         autocomplete="off"
+         autocorrect="off"
+         autocapitalize="off"
+         spellcheck="false"/>
+  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
+</form></div>
+  </div>
+
+  <div class="pst-async-banner-revealer d-none">
+  <aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>
+</div>
+
+  
+    <header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
+<div class="bd-header__inner bd-page-width">
+  <button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation">
+    <span class="fa-solid fa-bars"></span>
+  </button>
+  
+  
+  <div class="col-lg-3 navbar-header-items__start">
+    
+      <div class="navbar-item">
+
+  
+    
+  
+
+<a class="navbar-brand logo" href="index.html">
+  
+  
+  
+  
+  
+  
+    <p class="title logo__title">RAGoon 0.0.4 documentation</p>
+  
+</a></div>
+    
+  </div>
+  
+  <div class="col-lg-9 navbar-header-items">
+    
+    <div class="me-auto navbar-header-items__center">
+      
+        <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="modules.html">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="ragoon.html">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+      
+    </div>
+    
+    
+    <div class="navbar-header-items__end">
+      
+        <div class="navbar-item navbar-persistent--container">
+          
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+        </div>
+      
+      
+        <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+      
+    </div>
+    
+  </div>
+  
+  
+    <div class="navbar-persistent--mobile">
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+    </div>
+  
+
+  
+</div>
+
+    </header>
+  
+
+  <div class="bd-container">
+    <div class="bd-container__inner bd-page-width">
+      
+      
+      
+        
+      
+      <div class="bd-sidebar-primary bd-sidebar hide-on-wide">
+        
+
+  
+  <div class="sidebar-header-items sidebar-primary__section">
+    
+    
+      <div class="sidebar-header-items__center">
+        
+          
+          
+            <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="modules.html">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="ragoon.html">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+          
+        
+      </div>
+    
+    
+    
+      <div class="sidebar-header-items__end">
+        
+          <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+        
+      </div>
+    
+  </div>
+  
+  
+  <div class="sidebar-primary-items__end sidebar-primary__section">
+  </div>
+  
+  <div id="rtd-footer-container"></div>
+
+
+      </div>
+      
+      <main id="main-content" class="bd-main" role="main">
+        
+        
+          <div class="bd-content">
+            <div class="bd-article-container">
+              
+              <div class="bd-header-article d-print-none"></div>
+              
+              
+              
+                
+<div id="searchbox"></div>
+                <article class="bd-article">
+                  
+
+<h1 id="index">Index</h1>
+
+<div class="genindex-jumpbox">
+ <a href="#B"><strong>B</strong></a>
+ | <a href="#C"><strong>C</strong></a>
+ | <a href="#D"><strong>D</strong></a>
+ | <a href="#E"><strong>E</strong></a>
+ | <a href="#G"><strong>G</strong></a>
+ | <a href="#I"><strong>I</strong></a>
+ | <a href="#L"><strong>L</strong></a>
+ | <a href="#M"><strong>M</strong></a>
+ | <a href="#N"><strong>N</strong></a>
+ | <a href="#P"><strong>P</strong></a>
+ | <a href="#Q"><strong>Q</strong></a>
+ | <a href="#R"><strong>R</strong></a>
+ | <a href="#S"><strong>S</strong></a>
+ | <a href="#T"><strong>T</strong></a>
+ | <a href="#U"><strong>U</strong></a>
+ | <a href="#V"><strong>V</strong></a>
+ | <a href="#W"><strong>W</strong></a>
+ 
+</div>
+<h2 id="B">B</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.batch_size">batch_size (ragoon.embeddings.EmbeddingsDataLoader attribute)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="C">C</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.convert_to_tensor">convert_to_tensor (ragoon.embeddings.EmbeddingsDataLoader attribute)</a>
+</li>
+      <li><a href="ragoon.html#id12">create_faiss_index() (ragoon.similarity_search.SimilaritySearch method)</a>, <a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.create_faiss_index">[1]</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.create_plot">create_plot() (ragoon.embeddings.EmbeddingsVisualizer method)</a>
+</li>
+      <li><a href="ragoon.html#id13">create_usearch_index() (ragoon.similarity_search.SimilaritySearch method)</a>, <a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.create_usearch_index">[1]</a>
+</li>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.cuda_available">cuda_available (ragoon.embeddings.EmbeddingsDataLoader attribute)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="D">D</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.dataset">dataset (ragoon.embeddings.EmbeddingsDataLoader attribute)</a>
+
+      <ul>
+        <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.dataset">(ragoon.embeddings.EmbeddingsVisualizer attribute)</a>
+</li>
+      </ul></li>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.dataset_name">dataset_name (ragoon.embeddings.EmbeddingsDataLoader attribute)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.dataset_path">dataset_path (ragoon.embeddings.EmbeddingsVisualizer attribute)</a>
+</li>
+      <li><a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.device">device (ragoon.similarity_search.SimilaritySearch attribute)</a>
+</li>
+      <li><a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.dtype">dtype (ragoon.similarity_search.SimilaritySearch attribute)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="E">E</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#id0">embed() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.embed">[1]</a>
+</li>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader">EmbeddingsDataLoader (class in ragoon.embeddings)</a>
+</li>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer">EmbeddingsVisualizer (class in ragoon.embeddings)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#id1">encode() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.encode">[1]</a>
+
+      <ul>
+        <li><a href="ragoon.html#id14">(ragoon.similarity_search.SimilaritySearch method)</a>, <a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.encode">[1]</a>
+</li>
+      </ul></li>
+      <li><a href="ragoon.html#id9">extract_vectors() (ragoon.embeddings.EmbeddingsVisualizer method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.extract_vectors">[1]</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="G">G</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#id2">get_dataset() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.get_dataset">[1]</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="I">I</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.index">index (ragoon.embeddings.EmbeddingsVisualizer attribute)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.index_path">index_path (ragoon.embeddings.EmbeddingsVisualizer attribute)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="L">L</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.labels">labels (ragoon.embeddings.EmbeddingsVisualizer attribute)</a>
+</li>
+      <li><a href="ragoon.html#id3">load_dataset() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.load_dataset">[1]</a>
+
+      <ul>
+        <li><a href="ragoon.html#id10">(ragoon.embeddings.EmbeddingsVisualizer method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.load_dataset">[1]</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#id15">load_faiss_index() (ragoon.similarity_search.SimilaritySearch method)</a>, <a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.load_faiss_index">[1]</a>
+</li>
+      <li><a href="ragoon.html#id11">load_index() (ragoon.embeddings.EmbeddingsVisualizer method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.load_index">[1]</a>
+</li>
+      <li><a href="ragoon.html#id4">load_model() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.load_model">[1]</a>
+</li>
+      <li><a href="ragoon.html#id16">load_usearch_index_view() (ragoon.similarity_search.SimilaritySearch method)</a>, <a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.load_usearch_index_view">[1]</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="M">M</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.metric">metric (ragoon.similarity_search.SimilaritySearch attribute)</a>
+</li>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.model_configs">model_configs (ragoon.embeddings.EmbeddingsDataLoader attribute)</a>
+</li>
+      <li><a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.model_name">model_name (ragoon.similarity_search.SimilaritySearch attribute)</a>
+</li>
+      <li>
+    module
+
+      <ul>
+        <li><a href="index.html#module-ragoon">ragoon</a>, <a href="ragoon.html#module-ragoon">[1]</a>
+</li>
+        <li><a href="ragoon.html#module-ragoon.embeddings">ragoon.embeddings</a>
+</li>
+        <li><a href="ragoon.html#module-ragoon.similarity_search">ragoon.similarity_search</a>
+</li>
+        <li><a href="ragoon.html#module-ragoon.web_rag">ragoon.web_rag</a>
+</li>
+      </ul></li>
+  </ul></td>
+</tr></table>
+
+<h2 id="N">N</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.ndim">ndim (ragoon.similarity_search.SimilaritySearch attribute)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="P">P</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.plot_3d">plot_3d() (ragoon.embeddings.EmbeddingsVisualizer method)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#id5">process_split() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.process_split">[1]</a>
+</li>
+      <li><a href="ragoon.html#id6">process_splits() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.process_splits">[1]</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="Q">Q</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#id17">quantize_embeddings() (ragoon.similarity_search.SimilaritySearch method)</a>, <a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.quantize_embeddings">[1]</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="R">R</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li>
+    ragoon
+
+      <ul>
+        <li><a href="index.html#module-ragoon">module</a>, <a href="ragoon.html#module-ragoon">[1]</a>
+</li>
+      </ul></li>
+      <li>
+    ragoon.embeddings
+
+      <ul>
+        <li><a href="ragoon.html#module-ragoon.embeddings">module</a>
+</li>
+      </ul></li>
+      <li>
+    ragoon.similarity_search
+
+      <ul>
+        <li><a href="ragoon.html#module-ragoon.similarity_search">module</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li>
+    ragoon.web_rag
+
+      <ul>
+        <li><a href="ragoon.html#module-ragoon.web_rag">module</a>
+</li>
+      </ul></li>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.reduce_dimensionality">reduce_dimensionality() (ragoon.embeddings.EmbeddingsVisualizer method)</a>
+</li>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.reduced_vectors">reduced_vectors (ragoon.embeddings.EmbeddingsVisualizer attribute)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="S">S</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#id7">save_dataset() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.save_dataset">[1]</a>
+</li>
+      <li><a href="ragoon.html#id18">search() (ragoon.similarity_search.SimilaritySearch method)</a>, <a href="ragoon.html#ragoon.similarity_search.SimilaritySearch.search">[1]</a>
+
+      <ul>
+        <li><a href="ragoon.html#ragoon.web_rag.WebRAG.search">(ragoon.web_rag.WebRAG method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.similarity_search.SimilaritySearch">SimilaritySearch (class in ragoon.similarity_search)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="T">T</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.token">token (ragoon.embeddings.EmbeddingsDataLoader attribute)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="U">U</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#id8">upload_dataset() (ragoon.embeddings.EmbeddingsDataLoader method)</a>, <a href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.upload_dataset">[1]</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="V">V</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.vectors">vectors (ragoon.embeddings.EmbeddingsVisualizer attribute)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.visualize">visualize() (ragoon.embeddings.EmbeddingsVisualizer method)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="W">W</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="ragoon.html#ragoon.web_rag.WebRAG">WebRAG (class in ragoon.web_rag)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+
+
+                </article>
+              
+              
+              
+              
+              
+                <footer class="prev-next-footer d-print-none">
+                  
+<div class="prev-next-area">
+</div>
+                </footer>
+              
+            </div>
+            
+            
+              
+            
+          </div>
+          <footer class="bd-footer-content">
+            
+          </footer>
+        
+      </main>
+    </div>
+  </div>
+  
+  <!-- Scripts loaded after <body> so the DOM is not blocked -->
+  <script src="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b"></script>
+<script src="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+  <footer class="bd-footer">
+<div class="bd-footer__inner bd-page-width">
+  
+    <div class="footer-items__start">
+      
+        <div class="footer-item">
+
+  <p class="copyright">
+    
+      © Copyright 2024, Louis Brulé Naudet.
+      <br/>
+    
+  </p>
+</div>
+      
+        <div class="footer-item">
+
+  <p class="sphinx-version">
+    Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.7.
+    <br/>
+  </p>
+</div>
+      
+    </div>
+  
+  
+  
+    <div class="footer-items__end">
+      
+        <div class="footer-item">
+<p class="theme-version">
+  Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.15.4.
+</p></div>
+      
+    </div>
+  
+</div>
+
+  </footer>
+  </body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/index.html b/docs/build/html/index.html
new file mode 100644
index 0000000..7d408c4
--- /dev/null
+++ b/docs/build/html/index.html
@@ -0,0 +1,473 @@
+
+<!DOCTYPE html>
+
+
+<html lang="en" data-content_root="./" >
+
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
+
+    <title>RAGoon documentation &#8212; RAGoon 0.0.4 documentation</title>
+  
+  
+  
+  <script data-cfasync="false">
+    document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
+    document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
+  </script>
+  
+  <!-- Loaded before other Sphinx assets -->
+  <link href="_static/styles/theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/bootstrap.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/pydata-sphinx-theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+
+  
+  <link href="_static/vendor/fontawesome/6.5.2/css/all.min.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+  <link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-solid-900.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-brands-400.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-regular-400.woff2" />
+
+    <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
+  
+  <!-- Pre-loaded scripts that we'll load fully later -->
+  <link rel="preload" as="script" href="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b" />
+<link rel="preload" as="script" href="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
+  <script src="_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+    <script src="_static/documentation_options.js?v=8c5712d9"></script>
+    <script src="_static/doctools.js?v=9a2dae69"></script>
+    <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script>DOCUMENTATION_OPTIONS.pagename = 'index';</script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="ragoon" href="modules.html" />
+  <meta name="viewport" content="width=device-width, initial-scale=1"/>
+  <meta name="docsearch:language" content="en"/>
+  </head>
+  
+  
+  <body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">
+
+  
+  
+  <div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>
+  
+  <div id="pst-scroll-pixel-helper"></div>
+  
+  <button type="button" class="btn rounded-pill" id="pst-back-to-top">
+    <i class="fa-solid fa-arrow-up"></i>Back to top</button>
+
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-primary-sidebar-checkbox"/>
+  <label class="overlay overlay-primary" for="pst-primary-sidebar-checkbox"></label>
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-secondary-sidebar-checkbox"/>
+  <label class="overlay overlay-secondary" for="pst-secondary-sidebar-checkbox"></label>
+  
+  <div class="search-button__wrapper">
+    <div class="search-button__overlay"></div>
+    <div class="search-button__search-container">
+<form class="bd-search d-flex align-items-center"
+      action="search.html"
+      method="get">
+  <i class="fa-solid fa-magnifying-glass"></i>
+  <input type="search"
+         class="form-control"
+         name="q"
+         id="search-input"
+         placeholder="Search the docs ..."
+         aria-label="Search the docs ..."
+         autocomplete="off"
+         autocorrect="off"
+         autocapitalize="off"
+         spellcheck="false"/>
+  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
+</form></div>
+  </div>
+
+  <div class="pst-async-banner-revealer d-none">
+  <aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>
+</div>
+
+  
+    <header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
+<div class="bd-header__inner bd-page-width">
+  <button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation">
+    <span class="fa-solid fa-bars"></span>
+  </button>
+  
+  
+  <div class="col-lg-3 navbar-header-items__start">
+    
+      <div class="navbar-item">
+
+  
+    
+  
+
+<a class="navbar-brand logo" href="#">
+  
+  
+  
+  
+  
+  
+    <p class="title logo__title">RAGoon 0.0.4 documentation</p>
+  
+</a></div>
+    
+  </div>
+  
+  <div class="col-lg-9 navbar-header-items">
+    
+    <div class="me-auto navbar-header-items__center">
+      
+        <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="modules.html">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="ragoon.html">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+      
+    </div>
+    
+    
+    <div class="navbar-header-items__end">
+      
+        <div class="navbar-item navbar-persistent--container">
+          
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+        </div>
+      
+      
+        <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+      
+    </div>
+    
+  </div>
+  
+  
+    <div class="navbar-persistent--mobile">
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+    </div>
+  
+
+  
+    <button class="pst-navbar-icon sidebar-toggle secondary-toggle" aria-label="On this page">
+      <span class="fa-solid fa-outdent"></span>
+    </button>
+  
+</div>
+
+    </header>
+  
+
+  <div class="bd-container">
+    <div class="bd-container__inner bd-page-width">
+      
+      
+      
+        
+      
+      <div class="bd-sidebar-primary bd-sidebar hide-on-wide">
+        
+
+  
+  <div class="sidebar-header-items sidebar-primary__section">
+    
+    
+      <div class="sidebar-header-items__center">
+        
+          
+          
+            <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="modules.html">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="ragoon.html">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+          
+        
+      </div>
+    
+    
+    
+      <div class="sidebar-header-items__end">
+        
+          <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+        
+      </div>
+    
+  </div>
+  
+  
+  <div class="sidebar-primary-items__end sidebar-primary__section">
+  </div>
+  
+  <div id="rtd-footer-container"></div>
+
+
+      </div>
+      
+      <main id="main-content" class="bd-main" role="main">
+        
+        
+          <div class="bd-content">
+            <div class="bd-article-container">
+              
+              <div class="bd-header-article d-print-none"></div>
+              
+              
+              
+                
+<div id="searchbox"></div>
+                <article class="bd-article">
+                  
+  <section id="ragoon-documentation">
+<h1>RAGoon documentation<a class="headerlink" href="#ragoon-documentation" title="Link to this heading">#</a></h1>
+<p>Contents:</p>
+<div class="toctree-wrapper compound">
+<p aria-level="2" class="caption" role="heading"><span class="caption-text">Modules:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="modules.html">ragoon</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html">ragoon package</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="ragoon.html">ragoon package</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#submodules">Submodules</a></li>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#module-ragoon.embeddings">ragoon.embeddings module</a></li>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#module-ragoon.similarity_search">ragoon.similarity_search module</a></li>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#module-ragoon.web_rag">ragoon.web_rag module</a></li>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#module-ragoon">Module contents</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</section>
+<section id="indices-and-tables">
+<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Link to this heading">#</a></h1>
+<ul class="simple">
+<li><p><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></p></li>
+<li><p><a class="reference internal" href="py-modindex.html"><span class="std std-ref">Module Index</span></a></p></li>
+<li><p><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></p></li>
+</ul>
+</section>
+<section id="module-ragoon">
+<span id="ragoon-package"></span><h1>ragoon package<a class="headerlink" href="#module-ragoon" title="Link to this heading">#</a></h1>
+<section id="submodules">
+<h2>Submodules<a class="headerlink" href="#submodules" title="Link to this heading">#</a></h2>
+<div class="toctree-wrapper compound">
+</div>
+</section>
+</section>
+
+
+                </article>
+              
+              
+              
+              
+              
+                <footer class="prev-next-footer d-print-none">
+                  
+<div class="prev-next-area">
+    <a class="right-next"
+       href="modules.html"
+       title="next page">
+      <div class="prev-next-info">
+        <p class="prev-next-subtitle">next</p>
+        <p class="prev-next-title">ragoon</p>
+      </div>
+      <i class="fa-solid fa-angle-right"></i>
+    </a>
+</div>
+                </footer>
+              
+            </div>
+            
+            
+              
+                <div class="bd-sidebar-secondary bd-toc"><div class="sidebar-secondary-items sidebar-secondary__inner">
+
+
+  <div class="sidebar-secondary-item">
+<div
+    id="pst-page-navigation-heading-2"
+    class="page-toc tocsection onthispage">
+    <i class="fa-solid fa-list"></i> On this page
+  </div>
+  <nav class="bd-toc-nav page-toc" aria-labelledby="pst-page-navigation-heading-2">
+    <ul class="visible nav section-nav flex-column">
+<li class="toc-h1 nav-item toc-entry"><a class="reference internal nav-link" href="#">RAGoon documentation</a></li>
+<li class="toc-h1 nav-item toc-entry"><a class="reference internal nav-link" href="#indices-and-tables">Indices and tables</a></li>
+<li class="toc-h1 nav-item toc-entry"><a class="reference internal nav-link" href="#module-ragoon">ragoon package</a><ul class="visible nav section-nav flex-column">
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#submodules">Submodules</a></li>
+</ul>
+</li>
+</ul>
+
+  </nav></div>
+
+  <div class="sidebar-secondary-item">
+
+  <div class="tocsection sourcelink">
+    <a href="_sources/index.rst.txt">
+      <i class="fa-solid fa-file-lines"></i> Show Source
+    </a>
+  </div>
+</div>
+
+</div></div>
+              
+            
+          </div>
+          <footer class="bd-footer-content">
+            
+          </footer>
+        
+      </main>
+    </div>
+  </div>
+  
+  <!-- Scripts loaded after <body> so the DOM is not blocked -->
+  <script src="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b"></script>
+<script src="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+  <footer class="bd-footer">
+<div class="bd-footer__inner bd-page-width">
+  
+    <div class="footer-items__start">
+      
+        <div class="footer-item">
+
+  <p class="copyright">
+    
+      © Copyright 2024, Louis Brulé Naudet.
+      <br/>
+    
+  </p>
+</div>
+      
+        <div class="footer-item">
+
+  <p class="sphinx-version">
+    Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.7.
+    <br/>
+  </p>
+</div>
+      
+    </div>
+  
+  
+  
+    <div class="footer-items__end">
+      
+        <div class="footer-item">
+<p class="theme-version">
+  Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.15.4.
+</p></div>
+      
+    </div>
+  
+</div>
+
+  </footer>
+  </body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/modules.html b/docs/build/html/modules.html
new file mode 100644
index 0000000..0795b25
--- /dev/null
+++ b/docs/build/html/modules.html
@@ -0,0 +1,559 @@
+
+<!DOCTYPE html>
+
+
+<html lang="en" data-content_root="./" >
+
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
+
+    <title>ragoon &#8212; RAGoon 0.0.4 documentation</title>
+  
+  
+  
+  <script data-cfasync="false">
+    document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
+    document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
+  </script>
+  
+  <!-- Loaded before other Sphinx assets -->
+  <link href="_static/styles/theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/bootstrap.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/pydata-sphinx-theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+
+  
+  <link href="_static/vendor/fontawesome/6.5.2/css/all.min.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+  <link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-solid-900.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-brands-400.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-regular-400.woff2" />
+
+    <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
+  
+  <!-- Pre-loaded scripts that we'll load fully later -->
+  <link rel="preload" as="script" href="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b" />
+<link rel="preload" as="script" href="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
+  <script src="_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+    <script src="_static/documentation_options.js?v=8c5712d9"></script>
+    <script src="_static/doctools.js?v=9a2dae69"></script>
+    <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script>DOCUMENTATION_OPTIONS.pagename = 'modules';</script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="ragoon package" href="ragoon.html" />
+    <link rel="prev" title="RAGoon documentation" href="index.html" />
+  <meta name="viewport" content="width=device-width, initial-scale=1"/>
+  <meta name="docsearch:language" content="en"/>
+  </head>
+  
+  
+  <body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">
+
+  
+  
+  <div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>
+  
+  <div id="pst-scroll-pixel-helper"></div>
+  
+  <button type="button" class="btn rounded-pill" id="pst-back-to-top">
+    <i class="fa-solid fa-arrow-up"></i>Back to top</button>
+
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-primary-sidebar-checkbox"/>
+  <label class="overlay overlay-primary" for="pst-primary-sidebar-checkbox"></label>
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-secondary-sidebar-checkbox"/>
+  <label class="overlay overlay-secondary" for="pst-secondary-sidebar-checkbox"></label>
+  
+  <div class="search-button__wrapper">
+    <div class="search-button__overlay"></div>
+    <div class="search-button__search-container">
+<form class="bd-search d-flex align-items-center"
+      action="search.html"
+      method="get">
+  <i class="fa-solid fa-magnifying-glass"></i>
+  <input type="search"
+         class="form-control"
+         name="q"
+         id="search-input"
+         placeholder="Search the docs ..."
+         aria-label="Search the docs ..."
+         autocomplete="off"
+         autocorrect="off"
+         autocapitalize="off"
+         spellcheck="false"/>
+  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
+</form></div>
+  </div>
+
+  <div class="pst-async-banner-revealer d-none">
+  <aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>
+</div>
+
+  
+    <header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
+<div class="bd-header__inner bd-page-width">
+  <button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation">
+    <span class="fa-solid fa-bars"></span>
+  </button>
+  
+  
+  <div class="col-lg-3 navbar-header-items__start">
+    
+      <div class="navbar-item">
+
+  
+    
+  
+
+<a class="navbar-brand logo" href="index.html">
+  
+  
+  
+  
+  
+  
+    <p class="title logo__title">RAGoon 0.0.4 documentation</p>
+  
+</a></div>
+    
+  </div>
+  
+  <div class="col-lg-9 navbar-header-items">
+    
+    <div class="me-auto navbar-header-items__center">
+      
+        <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item current active">
+  <a class="nav-link nav-internal" href="#">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="ragoon.html">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+      
+    </div>
+    
+    
+    <div class="navbar-header-items__end">
+      
+        <div class="navbar-item navbar-persistent--container">
+          
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+        </div>
+      
+      
+        <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+      
+    </div>
+    
+  </div>
+  
+  
+    <div class="navbar-persistent--mobile">
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+    </div>
+  
+
+  
+    <button class="pst-navbar-icon sidebar-toggle secondary-toggle" aria-label="On this page">
+      <span class="fa-solid fa-outdent"></span>
+    </button>
+  
+</div>
+
+    </header>
+  
+
+  <div class="bd-container">
+    <div class="bd-container__inner bd-page-width">
+      
+      
+      
+      <div class="bd-sidebar-primary bd-sidebar">
+        
+
+  
+  <div class="sidebar-header-items sidebar-primary__section">
+    
+    
+      <div class="sidebar-header-items__center">
+        
+          
+          
+            <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item current active">
+  <a class="nav-link nav-internal" href="#">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="ragoon.html">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+          
+        
+      </div>
+    
+    
+    
+      <div class="sidebar-header-items__end">
+        
+          <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+        
+      </div>
+    
+  </div>
+  
+    <div class="sidebar-primary-items__start sidebar-primary__section">
+        <div class="sidebar-primary-item">
+<nav class="bd-docs-nav bd-links"
+     aria-label="Section Navigation">
+  <p class="bd-links__title" role="heading" aria-level="1">Section Navigation</p>
+  <div class="bd-toc-item navbar-nav"><ul class="nav bd-sidenav">
+<li class="toctree-l1"><a class="reference internal" href="ragoon.html">ragoon package</a></li>
+</ul>
+</div>
+</nav></div>
+    </div>
+  
+  
+  <div class="sidebar-primary-items__end sidebar-primary__section">
+  </div>
+  
+  <div id="rtd-footer-container"></div>
+
+
+      </div>
+      
+      <main id="main-content" class="bd-main" role="main">
+        
+        
+          <div class="bd-content">
+            <div class="bd-article-container">
+              
+              <div class="bd-header-article d-print-none">
+<div class="header-article-items header-article__inner">
+  
+    <div class="header-article-items__start">
+      
+        <div class="header-article-item">
+
+
+
+<nav aria-label="Breadcrumb" class="d-print-none">
+  <ul class="bd-breadcrumbs">
+    
+    <li class="breadcrumb-item breadcrumb-home">
+      <a href="index.html" class="nav-link" aria-label="Home">
+        <i class="fa-solid fa-home"></i>
+      </a>
+    </li>
+    <li class="breadcrumb-item active" aria-current="page">ragoon</li>
+  </ul>
+</nav>
+</div>
+      
+    </div>
+  
+  
+</div>
+</div>
+              
+              
+              
+                
+<div id="searchbox"></div>
+                <article class="bd-article">
+                  
+  <section id="ragoon">
+<h1>ragoon<a class="headerlink" href="#ragoon" title="Link to this heading">#</a></h1>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="ragoon.html">ragoon package</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#submodules">Submodules</a></li>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#module-ragoon.embeddings">ragoon.embeddings module</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader</span></code></a><ul>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.dataset_name"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.dataset_name</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.token"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.token</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.model_configs"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.model_configs</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.batch_size"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.batch_size</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.dataset</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.convert_to_tensor"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.convert_to_tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.cuda_available"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.cuda_available</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.load_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.load_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.load_model"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.load_model()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.encode"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.encode()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.embed"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.embed()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.process_split"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.process_split()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.process_splits"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.process_splits()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.get_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.get_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.save_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.save_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsDataLoader.upload_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.upload_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id0"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.embed()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id1"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.encode()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id2"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.get_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id3"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.load_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id4"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.load_model()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id5"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.process_split()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id6"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.process_splits()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id7"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.save_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id8"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.upload_dataset()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer</span></code></a><ul>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.index_path"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.index_path</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.dataset_path"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.dataset_path</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.index"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.index</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.dataset</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.vectors"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.vectors</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.reduced_vectors"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.reduced_vectors</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.labels"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.labels</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.load_index"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.load_index()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.load_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.load_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.extract_vectors"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.extract_vectors()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.plot_3d"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.plot_3d()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.create_plot"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.create_plot()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id9"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.extract_vectors()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id10"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.load_dataset()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id11"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.load_index()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.reduce_dimensionality"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.reduce_dimensionality()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.embeddings.EmbeddingsVisualizer.visualize"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.visualize()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#module-ragoon.similarity_search">ragoon.similarity_search module</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch</span></code></a><ul>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.model_name"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.model_name</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.device"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.device</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.ndim"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.ndim</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.metric"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.metric</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.dtype"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.dtype</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.encode"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.encode()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.quantize_embeddings"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.quantize_embeddings()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.create_faiss_index"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.create_faiss_index()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.create_usearch_index"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.create_usearch_index()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.load_usearch_index_view"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.load_usearch_index_view()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.load_faiss_index"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.load_faiss_index()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.similarity_search.SimilaritySearch.search"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.search()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id12"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.create_faiss_index()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id13"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.create_usearch_index()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id14"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.encode()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id15"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.load_faiss_index()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id16"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.load_usearch_index_view()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id17"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.quantize_embeddings()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#id18"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.search()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#module-ragoon.web_rag">ragoon.web_rag module</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="ragoon.html#ragoon.web_rag.WebRAG"><code class="docutils literal notranslate"><span class="pre">WebRAG</span></code></a><ul>
+<li class="toctree-l4"><a class="reference internal" href="ragoon.html#ragoon.web_rag.WebRAG.search"><code class="docutils literal notranslate"><span class="pre">WebRAG.search()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="ragoon.html#module-ragoon">Module contents</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</section>
+
+
+                </article>
+              
+              
+              
+              
+              
+                <footer class="prev-next-footer d-print-none">
+                  
+<div class="prev-next-area">
+    <a class="left-prev"
+       href="index.html"
+       title="previous page">
+      <i class="fa-solid fa-angle-left"></i>
+      <div class="prev-next-info">
+        <p class="prev-next-subtitle">previous</p>
+        <p class="prev-next-title">RAGoon documentation</p>
+      </div>
+    </a>
+    <a class="right-next"
+       href="ragoon.html"
+       title="next page">
+      <div class="prev-next-info">
+        <p class="prev-next-subtitle">next</p>
+        <p class="prev-next-title">ragoon package</p>
+      </div>
+      <i class="fa-solid fa-angle-right"></i>
+    </a>
+</div>
+                </footer>
+              
+            </div>
+            
+            
+              
+                <div class="bd-sidebar-secondary bd-toc"><div class="sidebar-secondary-items sidebar-secondary__inner">
+
+
+  <div class="sidebar-secondary-item">
+
+  <div class="tocsection sourcelink">
+    <a href="_sources/modules.rst.txt">
+      <i class="fa-solid fa-file-lines"></i> Show Source
+    </a>
+  </div>
+</div>
+
+</div></div>
+              
+            
+          </div>
+          <footer class="bd-footer-content">
+            
+          </footer>
+        
+      </main>
+    </div>
+  </div>
+  
+  <!-- Scripts loaded after <body> so the DOM is not blocked -->
+  <script src="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b"></script>
+<script src="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+  <footer class="bd-footer">
+<div class="bd-footer__inner bd-page-width">
+  
+    <div class="footer-items__start">
+      
+        <div class="footer-item">
+
+  <p class="copyright">
+    
+      © Copyright 2024, Louis Brulé Naudet.
+      <br/>
+    
+  </p>
+</div>
+      
+        <div class="footer-item">
+
+  <p class="sphinx-version">
+    Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.7.
+    <br/>
+  </p>
+</div>
+      
+    </div>
+  
+  
+  
+    <div class="footer-items__end">
+      
+        <div class="footer-item">
+<p class="theme-version">
+  Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.15.4.
+</p></div>
+      
+    </div>
+  
+</div>
+
+  </footer>
+  </body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv
new file mode 100644
index 0000000000000000000000000000000000000000..318ae79c059aedd583d90773210521221b61971b
GIT binary patch
literal 750
zcmV<K0ulWqAX9K?X>NERX>N99Zgg*Qc_4OWa&u{KZXhxWBOp+6Z)#;@bUGkXK}T<I
zZVDqHR%LQ?X>V>iAPOTORA^-&a%F8{X>Md?av*PJAarPHb0B7EY-J#6b0A}HZE$jB
zb8}^6Aa!$TZf78RY-wUH3V7PBmrHNkFbsh2`4tAXYmB7nW9x0ehGD=46f3YD1zKVg
zp|<2nvfJ#}kA5Vz+r^dwogzr&M~Y%d+Q3$8m6ZG2LW?TLWR*xI@HySNB7fKIE#D{0
zg=qy-EHV^As;wRA^ry2*>6hd3GdTFJL7-_!JO^u&^$6roNHcJJ$E^H|4Gf$!GOHY(
z59C_aXdH8zIaF4gSlmhggBoNGSsu$-K}(A+E{!QDVma8Jw+Vx8r^PFf6srJ~;#%MY
zYwge4(k%zEI|01#2j=wSLEHoq=^usp1n<(H*P<9@_k-;I!VzA#G@7He%$B*Fy7twX
zNISv2_GenC(c^J${E1FKqKXv6s`N~r4>QbP(pHdDB|N*Xz7SGw5F9e{?X*h)xCn*n
zEsd4nc9D?y><n<nYUECvsl@x}4{aN2BnMko%o|f5!raD!`K9oB6^J}W@Dy<E4{UOo
zZA6T8HYh4iHANOQB1o-h+wJ3l#V`#cyiR1=Vd-;WD+`)<426eT1jBa$)8iZ6^!~VW
ze}v5xx_QW<);)lv#xt977w536?tGrU38D+ECHI}xe0XkOM#RmJY?nd2wj_8y(^WWm
z^hm6h_%vnUI>-P~jO6h`+l_Mplez~}Q9X-C`%{5(R3+G}FUJ$%ya|F2YRL)SU|M>@
zjL|Zn^7I<%Z_Ivv`sz_-#tL)pHHuqQT@G6(Zrfg*EZ50lx0Or2HOs||n9#ft8c2|_
z<}02KDr!Xz95tf_-RD2(a=$zrbh<yfSae3Z7}%kieybDi++PeJGxWPXU0jWgbdaHq
gK~(y6QUZU3EiU>Pj;!?Q(2DmR;I5JV2d%*+MK9N50RR91

literal 0
HcmV?d00001

diff --git a/docs/build/html/py-modindex.html b/docs/build/html/py-modindex.html
new file mode 100644
index 0000000..b50bcdd
--- /dev/null
+++ b/docs/build/html/py-modindex.html
@@ -0,0 +1,425 @@
+
+<!DOCTYPE html>
+
+
+<html lang="en" data-content_root="./" >
+
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Python Module Index &#8212; RAGoon 0.0.4 documentation</title>
+  
+  
+  
+  <script data-cfasync="false">
+    document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
+    document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
+  </script>
+  
+  <!-- Loaded before other Sphinx assets -->
+  <link href="_static/styles/theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/bootstrap.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/pydata-sphinx-theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+
+  
+  <link href="_static/vendor/fontawesome/6.5.2/css/all.min.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+  <link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-solid-900.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-brands-400.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-regular-400.woff2" />
+
+    <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
+  
+  <!-- Pre-loaded scripts that we'll load fully later -->
+  <link rel="preload" as="script" href="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b" />
+<link rel="preload" as="script" href="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
+  <script src="_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+    <script src="_static/documentation_options.js?v=8c5712d9"></script>
+    <script src="_static/doctools.js?v=9a2dae69"></script>
+    <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script>DOCUMENTATION_OPTIONS.pagename = 'py-modindex';</script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1"/>
+  <meta name="docsearch:language" content="en"/>
+
+
+  </head>
+  
+  
+  <body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">
+
+  
+  
+  <div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>
+  
+  <div id="pst-scroll-pixel-helper"></div>
+  
+  <button type="button" class="btn rounded-pill" id="pst-back-to-top">
+    <i class="fa-solid fa-arrow-up"></i>Back to top</button>
+
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-primary-sidebar-checkbox"/>
+  <label class="overlay overlay-primary" for="pst-primary-sidebar-checkbox"></label>
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-secondary-sidebar-checkbox"/>
+  <label class="overlay overlay-secondary" for="pst-secondary-sidebar-checkbox"></label>
+  
+  <div class="search-button__wrapper">
+    <div class="search-button__overlay"></div>
+    <div class="search-button__search-container">
+<form class="bd-search d-flex align-items-center"
+      action="search.html"
+      method="get">
+  <i class="fa-solid fa-magnifying-glass"></i>
+  <input type="search"
+         class="form-control"
+         name="q"
+         id="search-input"
+         placeholder="Search the docs ..."
+         aria-label="Search the docs ..."
+         autocomplete="off"
+         autocorrect="off"
+         autocapitalize="off"
+         spellcheck="false"/>
+  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
+</form></div>
+  </div>
+
+  <div class="pst-async-banner-revealer d-none">
+  <aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>
+</div>
+
+  
+    <header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
+<div class="bd-header__inner bd-page-width">
+  <button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation">
+    <span class="fa-solid fa-bars"></span>
+  </button>
+  
+  
+  <div class="col-lg-3 navbar-header-items__start">
+    
+      <div class="navbar-item">
+
+  
+    
+  
+
+<a class="navbar-brand logo" href="index.html">
+  
+  
+  
+  
+  
+  
+    <p class="title logo__title">RAGoon 0.0.4 documentation</p>
+  
+</a></div>
+    
+  </div>
+  
+  <div class="col-lg-9 navbar-header-items">
+    
+    <div class="me-auto navbar-header-items__center">
+      
+        <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="modules.html">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="ragoon.html">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+      
+    </div>
+    
+    
+    <div class="navbar-header-items__end">
+      
+        <div class="navbar-item navbar-persistent--container">
+          
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+        </div>
+      
+      
+        <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+      
+    </div>
+    
+  </div>
+  
+  
+    <div class="navbar-persistent--mobile">
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+    </div>
+  
+
+  
+</div>
+
+    </header>
+  
+
+  <div class="bd-container">
+    <div class="bd-container__inner bd-page-width">
+      
+      
+      
+        
+      
+      <div class="bd-sidebar-primary bd-sidebar hide-on-wide">
+        
+
+  
+  <div class="sidebar-header-items sidebar-primary__section">
+    
+    
+      <div class="sidebar-header-items__center">
+        
+          
+          
+            <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="modules.html">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="ragoon.html">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+          
+        
+      </div>
+    
+    
+    
+      <div class="sidebar-header-items__end">
+        
+          <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+        
+      </div>
+    
+  </div>
+  
+  
+  <div class="sidebar-primary-items__end sidebar-primary__section">
+  </div>
+  
+  <div id="rtd-footer-container"></div>
+
+
+      </div>
+      
+      <main id="main-content" class="bd-main" role="main">
+        
+        
+          <div class="bd-content">
+            <div class="bd-article-container">
+              
+              <div class="bd-header-article d-print-none"></div>
+              
+              
+              
+                
+<div id="searchbox"></div>
+                <article class="bd-article">
+                  
+
+   <h1>Python Module Index</h1>
+
+   <div class="modindex-jumpbox">
+   <a href="#cap-r"><strong>r</strong></a>
+   </div>
+
+   <table class="indextable modindextable">
+     <tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
+     <tr class="cap" id="cap-r"><td></td><td>
+       <strong>r</strong></td><td></td></tr>
+     <tr>
+       <td><img src="_static/minus.png" class="toggler"
+              id="toggle-1" style="display: none" alt="-" /></td>
+       <td>
+       <a href="index.html#module-ragoon"><code class="xref">ragoon</code></a></td><td>
+       <em></em></td></tr>
+     <tr class="cg-1">
+       <td></td>
+       <td>&#160;&#160;&#160;
+       <a href="ragoon.html#module-ragoon.embeddings"><code class="xref">ragoon.embeddings</code></a></td><td>
+       <em></em></td></tr>
+     <tr class="cg-1">
+       <td></td>
+       <td>&#160;&#160;&#160;
+       <a href="ragoon.html#module-ragoon.similarity_search"><code class="xref">ragoon.similarity_search</code></a></td><td>
+       <em></em></td></tr>
+     <tr class="cg-1">
+       <td></td>
+       <td>&#160;&#160;&#160;
+       <a href="ragoon.html#module-ragoon.web_rag"><code class="xref">ragoon.web_rag</code></a></td><td>
+       <em></em></td></tr>
+   </table>
+
+
+                </article>
+              
+              
+              
+              
+              
+                <footer class="prev-next-footer d-print-none">
+                  
+<div class="prev-next-area">
+</div>
+                </footer>
+              
+            </div>
+            
+            
+              
+            
+          </div>
+          <footer class="bd-footer-content">
+            
+          </footer>
+        
+      </main>
+    </div>
+  </div>
+  
+  <!-- Scripts loaded after <body> so the DOM is not blocked -->
+  <script src="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b"></script>
+<script src="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+  <footer class="bd-footer">
+<div class="bd-footer__inner bd-page-width">
+  
+    <div class="footer-items__start">
+      
+        <div class="footer-item">
+
+  <p class="copyright">
+    
+      © Copyright 2024, Louis Brulé Naudet.
+      <br/>
+    
+  </p>
+</div>
+      
+        <div class="footer-item">
+
+  <p class="sphinx-version">
+    Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.7.
+    <br/>
+  </p>
+</div>
+      
+    </div>
+  
+  
+  
+    <div class="footer-items__end">
+      
+        <div class="footer-item">
+<p class="theme-version">
+  Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.15.4.
+</p></div>
+      
+    </div>
+  
+</div>
+
+  </footer>
+  </body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/ragoon.html b/docs/build/html/ragoon.html
new file mode 100644
index 0000000..7c37f79
--- /dev/null
+++ b/docs/build/html/ragoon.html
@@ -0,0 +1,1486 @@
+
+<!DOCTYPE html>
+
+
+<html lang="en" data-content_root="./" >
+
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
+
+    <title>ragoon package &#8212; RAGoon 0.0.4 documentation</title>
+  
+  
+  
+  <script data-cfasync="false">
+    document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
+    document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
+  </script>
+  
+  <!-- Loaded before other Sphinx assets -->
+  <link href="_static/styles/theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/bootstrap.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+<link href="_static/styles/pydata-sphinx-theme.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+
+  
+  <link href="_static/vendor/fontawesome/6.5.2/css/all.min.css?digest=dfe6caa3a7d634c4db9b" rel="stylesheet" />
+  <link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-solid-900.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-brands-400.woff2" />
+<link rel="preload" as="font" type="font/woff2" crossorigin href="_static/vendor/fontawesome/6.5.2/webfonts/fa-regular-400.woff2" />
+
+    <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
+  
+  <!-- Pre-loaded scripts that we'll load fully later -->
+  <link rel="preload" as="script" href="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b" />
+<link rel="preload" as="script" href="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
+  <script src="_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+    <script src="_static/documentation_options.js?v=8c5712d9"></script>
+    <script src="_static/doctools.js?v=9a2dae69"></script>
+    <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script>DOCUMENTATION_OPTIONS.pagename = 'ragoon';</script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="prev" title="ragoon" href="modules.html" />
+  <meta name="viewport" content="width=device-width, initial-scale=1"/>
+  <meta name="docsearch:language" content="en"/>
+  </head>
+  
+  
+  <body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">
+
+  
+  
+  <div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>
+  
+  <div id="pst-scroll-pixel-helper"></div>
+  
+  <button type="button" class="btn rounded-pill" id="pst-back-to-top">
+    <i class="fa-solid fa-arrow-up"></i>Back to top</button>
+
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-primary-sidebar-checkbox"/>
+  <label class="overlay overlay-primary" for="pst-primary-sidebar-checkbox"></label>
+  
+  <input type="checkbox"
+          class="sidebar-toggle"
+          id="pst-secondary-sidebar-checkbox"/>
+  <label class="overlay overlay-secondary" for="pst-secondary-sidebar-checkbox"></label>
+  
+  <div class="search-button__wrapper">
+    <div class="search-button__overlay"></div>
+    <div class="search-button__search-container">
+<form class="bd-search d-flex align-items-center"
+      action="search.html"
+      method="get">
+  <i class="fa-solid fa-magnifying-glass"></i>
+  <input type="search"
+         class="form-control"
+         name="q"
+         id="search-input"
+         placeholder="Search the docs ..."
+         aria-label="Search the docs ..."
+         autocomplete="off"
+         autocorrect="off"
+         autocapitalize="off"
+         spellcheck="false"/>
+  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
+</form></div>
+  </div>
+
+  <div class="pst-async-banner-revealer d-none">
+  <aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>
+</div>
+
+  
+    <header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
+<div class="bd-header__inner bd-page-width">
+  <button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation">
+    <span class="fa-solid fa-bars"></span>
+  </button>
+  
+  
+  <div class="col-lg-3 navbar-header-items__start">
+    
+      <div class="navbar-item">
+
+  
+    
+  
+
+<a class="navbar-brand logo" href="index.html">
+  
+  
+  
+  
+  
+  
+    <p class="title logo__title">RAGoon 0.0.4 documentation</p>
+  
+</a></div>
+    
+  </div>
+  
+  <div class="col-lg-9 navbar-header-items">
+    
+    <div class="me-auto navbar-header-items__center">
+      
+        <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="modules.html">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item current active">
+  <a class="nav-link nav-internal" href="#">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+      
+    </div>
+    
+    
+    <div class="navbar-header-items__end">
+      
+        <div class="navbar-item navbar-persistent--container">
+          
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+        </div>
+      
+      
+        <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+      
+    </div>
+    
+  </div>
+  
+  
+    <div class="navbar-persistent--mobile">
+
+ <script>
+ document.write(`
+   <button class="btn search-button-field search-button__button" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="fa-solid fa-magnifying-glass"></i>
+    <span class="search-button__default-text">Search</span>
+    <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
+   </button>
+ `);
+ </script>
+    </div>
+  
+
+  
+    <button class="pst-navbar-icon sidebar-toggle secondary-toggle" aria-label="On this page">
+      <span class="fa-solid fa-outdent"></span>
+    </button>
+  
+</div>
+
+    </header>
+  
+
+  <div class="bd-container">
+    <div class="bd-container__inner bd-page-width">
+      
+      
+      
+      <div class="bd-sidebar-primary bd-sidebar">
+        
+
+  
+  <div class="sidebar-header-items sidebar-primary__section">
+    
+    
+      <div class="sidebar-header-items__center">
+        
+          
+          
+            <div class="navbar-item">
+<nav>
+  <ul class="bd-navbar-elements navbar-nav">
+    
+<li class="nav-item ">
+  <a class="nav-link nav-internal" href="modules.html">
+    ragoon
+  </a>
+</li>
+
+
+<li class="nav-item current active">
+  <a class="nav-link nav-internal" href="#">
+    ragoon package
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://github.com/louisbrulenaudet">
+    GitHub
+  </a>
+</li>
+
+
+<li class="nav-item ">
+  <a class="nav-link nav-external" href="https://x.com/louisbrulenaudet">
+    Twitter
+  </a>
+</li>
+
+  </ul>
+</nav></div>
+          
+        
+      </div>
+    
+    
+    
+      <div class="sidebar-header-items__end">
+        
+          <div class="navbar-item">
+
+<script>
+document.write(`
+  <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button" title="light/dark" aria-label="light/dark" data-bs-placement="bottom" data-bs-toggle="tooltip">
+    <i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light"></i>
+    <i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark"></i>
+    <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto"></i>
+  </button>
+`);
+</script></div>
+        
+      </div>
+    
+  </div>
+  
+    <div class="sidebar-primary-items__start sidebar-primary__section">
+        <div class="sidebar-primary-item">
+<nav class="bd-docs-nav bd-links"
+     aria-label="Section Navigation">
+  <p class="bd-links__title" role="heading" aria-level="1">Section Navigation</p>
+  <div class="bd-toc-item navbar-nav"></div>
+</nav></div>
+    </div>
+  
+  
+  <div class="sidebar-primary-items__end sidebar-primary__section">
+  </div>
+  
+  <div id="rtd-footer-container"></div>
+
+
+      </div>
+      
+      <main id="main-content" class="bd-main" role="main">
+        
+        
+          <div class="bd-content">
+            <div class="bd-article-container">
+              
+              <div class="bd-header-article d-print-none">
+<div class="header-article-items header-article__inner">
+  
+    <div class="header-article-items__start">
+      
+        <div class="header-article-item">
+
+
+
+<nav aria-label="Breadcrumb" class="d-print-none">
+  <ul class="bd-breadcrumbs">
+    
+    <li class="breadcrumb-item breadcrumb-home">
+      <a href="index.html" class="nav-link" aria-label="Home">
+        <i class="fa-solid fa-home"></i>
+      </a>
+    </li>
+    
+    <li class="breadcrumb-item"><a href="modules.html" class="nav-link">ragoon</a></li>
+    
+    <li class="breadcrumb-item active" aria-current="page">ragoon package</li>
+  </ul>
+</nav>
+</div>
+      
+    </div>
+  
+  
+</div>
+</div>
+              
+              
+              
+                
+<div id="searchbox"></div>
+                <article class="bd-article">
+                  
+  <section id="ragoon-package">
+<h1>ragoon package<a class="headerlink" href="#ragoon-package" title="Link to this heading">#</a></h1>
+<section id="submodules">
+<h2>Submodules<a class="headerlink" href="#submodules" title="Link to this heading">#</a></h2>
+</section>
+<section id="module-ragoon.embeddings">
+<span id="ragoon-embeddings-module"></span><h2>ragoon.embeddings module<a class="headerlink" href="#module-ragoon.embeddings" title="Link to this heading">#</a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ragoon.embeddings.</span></span><span class="sig-name descname"><span class="pre">EmbeddingsDataLoader</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">token</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">model_configs</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="pre">str</span><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">batch_size</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">16</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">convert_to_tensor</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader" title="Link to this definition">#</a></dt>
+<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></p>
+<p>A class to load a dataset and process it to add embeddings using specified models.</p>
+<p>This class handles loading a dataset from Hugging Face, processing it to add
+embeddings using specified models, and provides methods to save the processed dataset.</p>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.dataset_name">
+<span class="sig-name descname"><span class="pre">dataset_name</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.dataset_name" title="Link to this definition">#</a></dt>
+<dd><p>The name of the dataset to load from Hugging Face.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.token">
+<span class="sig-name descname"><span class="pre">token</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.token" title="Link to this definition">#</a></dt>
+<dd><p>The token for accessing Hugging Face API.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.model_configs">
+<span class="sig-name descname"><span class="pre">model_configs</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.model_configs" title="Link to this definition">#</a></dt>
+<dd><p>The list of dictionaries with model configurations to use for generating embeddings.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>list of dict</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.batch_size">
+<span class="sig-name descname"><span class="pre">batch_size</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.batch_size" title="Link to this definition">#</a></dt>
+<dd><p>The number of samples to process in each batch.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>int</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.dataset">
+<span class="sig-name descname"><span class="pre">dataset</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.dataset" title="Link to this definition">#</a></dt>
+<dd><p>The loaded and processed dataset.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>datasets.DatasetDict</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.convert_to_tensor">
+<span class="sig-name descname"><span class="pre">convert_to_tensor</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.convert_to_tensor" title="Link to this definition">#</a></dt>
+<dd><p>Whether the output should be one large tensor. Default is False.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool, optional</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.cuda_available">
+<span class="sig-name descname"><span class="pre">cuda_available</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.cuda_available" title="Link to this definition">#</a></dt>
+<dd><p>Whether CUDA is available for GPU acceleration.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.load_dataset">
+<span class="sig-name descname"><span class="pre">load_dataset</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.load_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.load_dataset" title="Link to this definition">#</a></dt>
+<dd><p>Load the dataset from Hugging Face.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.load_model">
+<span class="sig-name descname"><span class="pre">load_model</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">model_name</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.load_model"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.load_model" title="Link to this definition">#</a></dt>
+<dd><p>Load the specified model.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.encode">
+<span class="sig-name descname"><span class="pre">encode</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">texts</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">model</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">query_prefix</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">passage_prefix</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.encode"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.encode" title="Link to this definition">#</a></dt>
+<dd><p>Create embeddings for a list of texts using a loaded model with optional prefixes.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.embed">
+<span class="sig-name descname"><span class="pre">embed</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">batch</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">model</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">model_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">column</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'text'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">query_prefix</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">passage_prefix</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.embed"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.embed" title="Link to this definition">#</a></dt>
+<dd><p>Add embeddings columns to the dataset for each model.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.process_split">
+<span class="sig-name descname"><span class="pre">process_split</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">split</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">column</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'text'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.process_split"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.process_split" title="Link to this definition">#</a></dt>
+<dd><p>Process a specific split of the dataset and add embeddings for each model.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.process_splits">
+<span class="sig-name descname"><span class="pre">process_splits</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">splits</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">column</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'text'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.process_splits"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.process_splits" title="Link to this definition">#</a></dt>
+<dd><p>Process specified splits of the dataset and add embeddings for each model.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.get_dataset">
+<span class="sig-name descname"><span class="pre">get_dataset</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.get_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.get_dataset" title="Link to this definition">#</a></dt>
+<dd><p>Return the processed dataset.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.save_dataset">
+<span class="sig-name descname"><span class="pre">save_dataset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">output_dir</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.save_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.save_dataset" title="Link to this definition">#</a></dt>
+<dd><p>Save the processed dataset to disk.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsDataLoader.upload_dataset">
+<span class="sig-name descname"><span class="pre">upload_dataset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">repo_id</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.upload_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsDataLoader.upload_dataset" title="Link to this definition">#</a></dt>
+<dd><p>Upload the processed dataset to the Hugging Face Hub.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id0">
+<span class="sig-name descname"><span class="pre">embed</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">batch</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">dict</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">model</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">InferenceClient</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">SentenceTransformer</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">model_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">column</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'text'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">query_prefix</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">passage_prefix</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">dict</span></span></span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.embed"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id0" title="Link to this definition">#</a></dt>
+<dd><p>Add embeddings columns to the dataset for each model.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>batch</strong> (<em>dict</em>) – A batch of data from the dataset.</p></li>
+<li><p><strong>model</strong> (<em>model</em>) – The loaded model to use for encoding.</p></li>
+<li><p><strong>model_name</strong> (<em>str</em>) – The name of the model to use for encoding.</p></li>
+<li><p><strong>column</strong> (<em>str</em><em>, </em><em>optional</em>) – The name of the column containing the text to encode (default is “text”).</p></li>
+<li><p><strong>query_prefix</strong> (<em>str</em><em>, </em><em>optional</em>) – The prefix to add to each query (default is None).</p></li>
+<li><p><strong>passage_prefix</strong> (<em>str</em><em>, </em><em>optional</em>) – The prefix to add to each passage (default is None).</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A dictionary containing the embeddings for the model.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>dict</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>Exception</strong> – If embedding fails.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id1">
+<span class="sig-name descname"><span class="pre">encode</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">texts</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">model</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">InferenceClient</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">SentenceTransformer</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">query_prefix</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">passage_prefix</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.encode"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id1" title="Link to this definition">#</a></dt>
+<dd><p>Create embeddings for a list of texts using a loaded model with optional prefixes.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>texts</strong> (<em>list</em><em> of </em><em>str</em>) – The list of texts to encode.</p></li>
+<li><p><strong>model</strong> (<em>model</em>) – The loaded model to use for encoding.</p></li>
+<li><p><strong>query_prefix</strong> (<em>str</em><em>, </em><em>optional</em>) – The prefix to add to each query. Default is None.</p></li>
+<li><p><strong>passage_prefix</strong> (<em>str</em><em>, </em><em>optional</em>) – The prefix to add to each passage. Default is None.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The embeddings for the texts.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>numpy.ndarray</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>Exception</strong> – If encoding fails.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id2">
+<span class="sig-name descname"><span class="pre">get_dataset</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Dataset</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">DatasetDict</span></span></span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.get_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id2" title="Link to this definition">#</a></dt>
+<dd><p>Return the processed dataset.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p>The processed dataset.</p>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p>datasets.DatasetDict</p>
+</dd>
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>ValueError</strong> – If the dataset is not processed.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id3">
+<span class="sig-name descname"><span class="pre">load_dataset</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.load_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id3" title="Link to this definition">#</a></dt>
+<dd><p>Load the dataset from Hugging Face.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>Exception</strong> – If the dataset fails to load from Hugging Face.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id4">
+<span class="sig-name descname"><span class="pre">load_model</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">model_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">InferenceClient</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">SentenceTransformer</span></span></span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.load_model"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id4" title="Link to this definition">#</a></dt>
+<dd><p>Load the specified model.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>model_name</strong> (<em>str</em>) – The name of the model to load.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>model</strong> – The loaded model, either a SentenceTransformer or an InferenceClient.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>Union[InferenceClient, SentenceTransformer]</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>Exception</strong> – If the model fails to load.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id5">
+<span class="sig-name descname"><span class="pre">process_split</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">split</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">column</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'text'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.process_split"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id5" title="Link to this definition">#</a></dt>
+<dd><p>Process a specific split of the dataset and add embeddings for each model.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>split</strong> (<em>str</em>) – The split of the dataset to process.</p></li>
+<li><p><strong>column</strong> (<em>str</em><em>, </em><em>optional</em>) – The name of the column containing the text to encode (default is “text”).</p></li>
+</ul>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>ValueError</strong> – If the dataset is not loaded.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id6">
+<span class="sig-name descname"><span class="pre">process_splits</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">splits</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">column</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'text'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.process_splits"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id6" title="Link to this definition">#</a></dt>
+<dd><p>Process specified splits of the dataset and add embeddings for each model.
+If splits are not provided, process all splits available in the dataset.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>splits</strong> (<em>list</em><em> of </em><em>str</em>) – The list of splits to process. If None, process all splits.</p></li>
+<li><p><strong>column</strong> (<em>str</em><em>, </em><em>optional</em>) – The name of the column containing the text to encode (default is “text”).</p></li>
+</ul>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>ValueError</strong> – If the dataset is not loaded.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id7">
+<span class="sig-name descname"><span class="pre">save_dataset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">output_dir</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.save_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id7" title="Link to this definition">#</a></dt>
+<dd><p>Save the processed dataset to disk.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>output_dir</strong> (<em>str</em>) – The directory where the dataset will be saved.</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>ValueError</strong> – If the dataset is not processed.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id8">
+<span class="sig-name descname"><span class="pre">upload_dataset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">repo_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsDataLoader.upload_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id8" title="Link to this definition">#</a></dt>
+<dd><p>Upload the processed dataset to the Hugging Face Hub.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>repo_id</strong> (<em>str</em>) – The repository ID on the Hugging Face Hub.</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>ValueError</strong> – If the dataset is not processed.</p>
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ragoon.embeddings.</span></span><span class="sig-name descname"><span class="pre">EmbeddingsVisualizer</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index_path</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_path</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer" title="Link to this definition">#</a></dt>
+<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></p>
+<p>A class for Embedding Exploration Lab, visualizing high-dimensional embeddings in 3D space.</p>
+<p>This class provides functionality to load embeddings from a FAISS index,
+reduce their dimensionality using PCA and/or t-SNE, and visualize them
+in an interactive 3D plot.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>index_path</strong> (<em>str</em>) – Path to the FAISS index file.</p></li>
+<li><p><strong>dataset_path</strong> (<em>str</em>) – Path to the dataset containing labels.</p></li>
+</ul>
+</dd>
+</dl>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.index_path">
+<span class="sig-name descname"><span class="pre">index_path</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.index_path" title="Link to this definition">#</a></dt>
+<dd><p>Path to the FAISS index file.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.dataset_path">
+<span class="sig-name descname"><span class="pre">dataset_path</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.dataset_path" title="Link to this definition">#</a></dt>
+<dd><p>Path to the dataset containing labels.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.index">
+<span class="sig-name descname"><span class="pre">index</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.index" title="Link to this definition">#</a></dt>
+<dd><p>Loaded FAISS index.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>faiss.Index or None</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.dataset">
+<span class="sig-name descname"><span class="pre">dataset</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.dataset" title="Link to this definition">#</a></dt>
+<dd><p>Loaded dataset containing labels.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>datasets.Dataset or None</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.vectors">
+<span class="sig-name descname"><span class="pre">vectors</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.vectors" title="Link to this definition">#</a></dt>
+<dd><p>Extracted vectors from the FAISS index.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>np.ndarray or None</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.reduced_vectors">
+<span class="sig-name descname"><span class="pre">reduced_vectors</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.reduced_vectors" title="Link to this definition">#</a></dt>
+<dd><p>Dimensionality-reduced vectors.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>np.ndarray or None</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.labels">
+<span class="sig-name descname"><span class="pre">labels</span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.labels" title="Link to this definition">#</a></dt>
+<dd><p>Labels from the dataset.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>list of str or None</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.load_index">
+<span class="sig-name descname"><span class="pre">load_index</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">'EmbeddingsVisualizer':</span></span></span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.load_index"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.load_index" title="Link to this definition">#</a></dt>
+<dd><p>Load the FAISS index from the specified file path.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.load_dataset">
+<span class="sig-name descname"><span class="pre">load_dataset</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">'EmbeddingsVisualizer':</span></span></span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.load_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.load_dataset" title="Link to this definition">#</a></dt>
+<dd><p>Load the dataset containing labels from the specified file path.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.extract_vectors">
+<span class="sig-name descname"><span class="pre">extract_vectors</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">'EmbeddingsVisualizer':</span></span></span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.extract_vectors"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.extract_vectors" title="Link to this definition">#</a></dt>
+<dd><p>Extract all vectors from the loaded FAISS index.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">reduce_dimensionality(</span></span></dt>
+<dd><p>method: str = “umap”,
+pca_components: int = 50,
+final_components: int = 3,
+random_state: int = 42</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">)</span> <span class="pre">-&gt;</span> <span class="pre">'EmbeddingsVisualizer':</span></span></dt>
+<dd><p>Reduce dimensionality of the extracted vectors with dynamic progress tracking.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.plot_3d">
+<span class="sig-name descname"><span class="pre">plot_3d</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">None:</span></span></span><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.plot_3d" title="Link to this definition">#</a></dt>
+<dd><p>Generate a 3D scatter plot of the reduced vectors with labels.</p>
+</dd></dl>
+
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">visualizer</span> <span class="o">=</span> <span class="n">EmbeddingsVisualizer</span><span class="p">(</span><span class="n">index_path</span><span class="o">=</span><span class="s2">&quot;path/to/index&quot;</span><span class="p">,</span> <span class="n">dataset_path</span><span class="o">=</span><span class="s2">&quot;path/to/dataset&quot;</span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">visualizer</span><span class="o">.</span><span class="n">load_index</span><span class="p">()</span><span class="o">.</span><span class="n">load_dataset</span><span class="p">()</span><span class="o">.</span><span class="n">extract_vectors</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">visualizer</span><span class="o">.</span><span class="n">reduce_dimensionality</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;pca_umap&quot;</span><span class="p">,</span> <span class="n">pca_components</span><span class="o">=</span><span class="mi">50</span><span class="p">,</span> <span class="n">final_components</span><span class="o">=</span><span class="mi">3</span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">visualizer</span><span class="o">.</span><span class="n">plot_3d</span><span class="p">()</span>
+</pre></div>
+</div>
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.create_plot">
+<span class="sig-name descname"><span class="pre">create_plot</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">title</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'3D</span> <span class="pre">Visualization</span> <span class="pre">of</span> <span class="pre">Embeddings'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">point_size</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">3</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Figure</span></span></span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.create_plot"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.create_plot" title="Link to this definition">#</a></dt>
+<dd><p>Generate a 3D scatter plot of the reduced vectors with labels.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>title</strong> (<em>str</em><em>, </em><em>optional</em>) – The title of the plot (default is ‘3D Visualization of Embeddings’).</p></li>
+<li><p><strong>point_size</strong> (<em>int</em><em>, </em><em>optional</em>) – The size of the markers in the scatter plot (default is 3).</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The generated 3D scatter plot.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>go.Figure</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>ValueError</strong> – If vectors have not been reduced yet.</p>
+</dd>
+</dl>
+<p class="rubric">Notes</p>
+<p>This method requires the <cite>plotly</cite> library to be installed.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">visualizer</span> <span class="o">=</span> <span class="n">EmbeddingsVisualizer</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">plot</span> <span class="o">=</span> <span class="n">visualizer</span><span class="o">.</span><span class="n">create_plot</span><span class="p">(</span><span class="n">title</span><span class="o">=</span><span class="s1">&#39;My Embeddings&#39;</span><span class="p">,</span> <span class="n">point_size</span><span class="o">=</span><span class="mi">5</span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">plot</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id9">
+<span class="sig-name descname"><span class="pre">extract_vectors</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.extract_vectors"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id9" title="Link to this definition">#</a></dt>
+<dd><p>Extract all vectors from the loaded FAISS index.</p>
+<p>This method should be called after <cite>load_index()</cite>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>self</strong> – The instance itself, allowing for method chaining.</p>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p><a class="reference internal" href="#ragoon.embeddings.EmbeddingsVisualizer" title="ragoon.embeddings.EmbeddingsVisualizer">EmbeddingsVisualizer</a></p>
+</dd>
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>ValueError</strong> – If the index has not been loaded yet.</p></li>
+<li><p><strong>RuntimeError</strong> – If there’s an issue with vector extraction.</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id10">
+<span class="sig-name descname"><span class="pre">load_dataset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">column</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'document'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.load_dataset"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id10" title="Link to this definition">#</a></dt>
+<dd><p>Load the Dataset containing labels from the specified file path.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>column</strong> (<em>str</em><em>, </em><em>optional</em>) – The column of the split corresponding to the embeddings stored in
+the index. Default is ‘document’.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>self</strong> – The instance itself, allowing for method chaining.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>datasets.Dataset</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id11">
+<span class="sig-name descname"><span class="pre">load_index</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.load_index"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id11" title="Link to this definition">#</a></dt>
+<dd><p>Load the FAISS index from the specified file path.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>self</strong> – The instance itself, allowing for method chaining.</p>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p><a class="reference internal" href="#ragoon.embeddings.EmbeddingsVisualizer" title="ragoon.embeddings.EmbeddingsVisualizer">EmbeddingsVisualizer</a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.reduce_dimensionality">
+<span class="sig-name descname"><span class="pre">reduce_dimensionality</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'umap'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">pca_components</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">50</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_components</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">3</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">random_state</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">42</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.reduce_dimensionality"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.reduce_dimensionality" title="Link to this definition">#</a></dt>
+<dd><p>Reduce dimensionality of the extracted vectors with dynamic progress tracking.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>method</strong> (<em>{'pca'</em><em>, </em><em>'umap'</em><em>, </em><em>'pca_umap'}</em><em>, </em><em>optional</em>) – <p>The method to use for dimensionality reduction, by default ‘umap’.</p>
+<ul>
+<li><p>pca : Principal Component Analysis (PCA) is a linear dimensionality reduction technique</p></li>
+</ul>
+<p>that is commonly used to reduce the dimensionality of high-dimensional data.
+It identifies the directions (principal components) in which the data varies the most
+and projects the data onto these components, resulting in a lower-dimensional representation.</p>
+<ul>
+<li><p>umap : Uniform Manifold Approximation and Projection (UMAP) is a non-linear dimensionality</p></li>
+</ul>
+<p>reduction technique that is particularly well-suited for visualizing high-dimensional
+data in lower-dimensional space. It preserves both local and global structure of the data
+by constructing a low-dimensional representation that captures the underlying manifold
+structure of the data.</p>
+<ul>
+<li><p>pca_umap : PCA followed by UMAP is a two-step dimensionality reduction technique.</p></li>
+</ul>
+<p>First, PCA is applied to reduce the dimensionality of the data.
+Then, UMAP is applied to further reduce the dimensionality and capture the
+non-linear structure of the data. This combination can be effective in
+preserving both global and local structure of the data.</p>
+</p></li>
+<li><p><strong>pca_components</strong> (<em>int</em><em>, </em><em>optional</em>) – Number of components for PCA (used in ‘pca’ and ‘pca_umap’), by default 50.</p></li>
+<li><p><strong>final_components</strong> (<em>int</em><em>, </em><em>optional</em>) – Final number of components (3 for 3D visualization), by default 3.</p></li>
+<li><p><strong>random_state</strong> (<em>int</em><em>, </em><em>optional</em>) – Random state for reproducibility, by default 42.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>self</strong> – The instance itself, allowing for method chaining.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#ragoon.embeddings.EmbeddingsVisualizer" title="ragoon.embeddings.EmbeddingsVisualizer">EmbeddingsVisualizer</a></p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>ValueError</strong> – If vectors have not been extracted yet or if an invalid method is specified.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.embeddings.EmbeddingsVisualizer.visualize">
+<span class="sig-name descname"><span class="pre">visualize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'tsne'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">pca_components</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">50</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_components</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">3</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">random_state</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">42</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">title</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'3D</span> <span class="pre">Visualization</span> <span class="pre">of</span> <span class="pre">Embeddings'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">point_size</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">3</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">save_html</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">html_file_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'embedding_visualization.html'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/embeddings.html#EmbeddingsVisualizer.visualize"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.embeddings.EmbeddingsVisualizer.visualize" title="Link to this definition">#</a></dt>
+<dd><p>Full pipeline: load index, extract vectors, reduce dimensionality, and visualize.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>method</strong> (<em>str</em><em>, </em><em>optional</em>) – The dimensionality reduction method to use. Default is ‘tsne’.</p></li>
+<li><p><strong>pca_components</strong> (<em>int</em><em>, </em><em>optional</em>) – The number of components to keep when using PCA for dimensionality reduction. Default is 50.</p></li>
+<li><p><strong>final_components</strong> (<em>int</em><em>, </em><em>optional</em>) – The number of final components to visualize. Default is 3.</p></li>
+<li><p><strong>random_state</strong> (<em>int</em><em>, </em><em>optional</em>) – The random state for reproducibility. Default is 42.</p></li>
+<li><p><strong>title</strong> (<em>str</em><em>, </em><em>optional</em>) – The title of the visualization plot. Default is ‘3D Visualization of Embeddings’.</p></li>
+<li><p><strong>point_size</strong> (<em>int</em><em>, </em><em>optional</em>) – The size of the points in the visualization plot. Default is 3.</p></li>
+<li><p><strong>save_html</strong> (<em>bool</em><em>, </em><em>optional</em>) – Whether to save the visualization as an HTML file. Default is False.</p></li>
+<li><p><strong>html_file_name</strong> (<em>str</em><em>, </em><em>optional</em>) – The name of the HTML file to save. Default is ‘embedding_visualization.html’.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p>None</p>
+</dd>
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>None</strong> – </p>
+</dd>
+</dl>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">visualizer</span> <span class="o">=</span> <span class="n">EmbeddingsVisualizer</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">visualizer</span><span class="o">.</span><span class="n">visualize</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s1">&#39;tsne&#39;</span><span class="p">,</span> <span class="n">pca_components</span><span class="o">=</span><span class="mi">50</span><span class="p">,</span> <span class="n">final_components</span><span class="o">=</span><span class="mi">3</span><span class="p">,</span> <span class="n">random_state</span><span class="o">=</span><span class="mi">42</span><span class="p">)</span>
+</pre></div>
+</div>
+</dd></dl>
+
+</dd></dl>
+
+</section>
+<section id="module-ragoon.similarity_search">
+<span id="ragoon-similarity-search-module"></span><h2>ragoon.similarity_search module<a class="headerlink" href="#module-ragoon.similarity_search" title="Link to this heading">#</a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ragoon.similarity_search.</span></span><span class="sig-name descname"><span class="pre">SimilaritySearch</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">model_name</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">device</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'cuda'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ndim</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">1024</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">metric</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'ip'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dtype</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'i8'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch" title="Link to this definition">#</a></dt>
+<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></p>
+<p>A class dedicated to encoding text data, quantizing embeddings, and managing indices for efficient similarity search.</p>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.model_name">
+<span class="sig-name descname"><span class="pre">model_name</span></span><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.model_name" title="Link to this definition">#</a></dt>
+<dd><p>Name or identifier of the embedding model.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.device">
+<span class="sig-name descname"><span class="pre">device</span></span><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.device" title="Link to this definition">#</a></dt>
+<dd><p>Computation device (‘cpu’ or ‘cuda’).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.ndim">
+<span class="sig-name descname"><span class="pre">ndim</span></span><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.ndim" title="Link to this definition">#</a></dt>
+<dd><p>Dimension of the embeddings.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>int</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.metric">
+<span class="sig-name descname"><span class="pre">metric</span></span><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.metric" title="Link to this definition">#</a></dt>
+<dd><p>Metric used for the index (‘ip’ for inner product, etc.).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.dtype">
+<span class="sig-name descname"><span class="pre">dtype</span></span><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.dtype" title="Link to this definition">#</a></dt>
+<dd><p>Data type for the index (‘i8’ for int8, etc.).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.encode">
+<span class="sig-name descname"><span class="pre">encode</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">corpus</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">normalize_embeddings</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.encode"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.encode" title="Link to this definition">#</a></dt>
+<dd><p>Encodes a list of text data into embeddings.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.quantize_embeddings">
+<span class="sig-name descname"><span class="pre">quantize_embeddings</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">embeddings</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">quantization_type</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.quantize_embeddings"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.quantize_embeddings" title="Link to this definition">#</a></dt>
+<dd><p>Quantizes the embeddings for efficient storage and search.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.create_faiss_index">
+<span class="sig-name descname"><span class="pre">create_faiss_index</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ubinary_embeddings</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">index_path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.create_faiss_index"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.create_faiss_index" title="Link to this definition">#</a></dt>
+<dd><p>Creates and saves a FAISS binary index.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.create_usearch_index">
+<span class="sig-name descname"><span class="pre">create_usearch_index</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">int8_embeddings</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">index_path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.create_usearch_index"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.create_usearch_index" title="Link to this definition">#</a></dt>
+<dd><p>Creates and saves a USEARCH integer index.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.load_usearch_index_view">
+<span class="sig-name descname"><span class="pre">load_usearch_index_view</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index_path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.load_usearch_index_view"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.load_usearch_index_view" title="Link to this definition">#</a></dt>
+<dd><p>Loads a USEARCH index as a view for memory-efficient operations.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.load_faiss_index">
+<span class="sig-name descname"><span class="pre">load_faiss_index</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index_path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.load_faiss_index"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.load_faiss_index" title="Link to this definition">#</a></dt>
+<dd><p>Loads a FAISS binary index for searching.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.similarity_search.SimilaritySearch.search">
+<span class="sig-name descname"><span class="pre">search</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">query</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">top_k</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">10</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rescore_multiplier</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">4</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.search"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.similarity_search.SimilaritySearch.search" title="Link to this definition">#</a></dt>
+<dd><p>Performs a search operation against the indexed embeddings.</p>
+</dd></dl>
+
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">instance</span> <span class="o">=</span> <span class="n">SimilaritySearch</span><span class="p">(</span>
+<span class="go">    model_name=&quot;louisbrulenaudet/tsdae-lemone-mbert-base&quot;,</span>
+<span class="go">    device=&quot;cuda&quot;,</span>
+<span class="go">    ndim=768,</span>
+<span class="go">    metric=&quot;ip&quot;,</span>
+<span class="go">    dtype=&quot;i8&quot;</span>
+<span class="go">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">embeddings</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">corpus</span><span class="o">=</span><span class="n">dataset</span><span class="p">[</span><span class="s2">&quot;output&quot;</span><span class="p">])</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">ubinary_embeddings</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="n">quantize_embeddings</span><span class="p">(</span>
+<span class="go">    embeddings=embeddings,</span>
+<span class="go">    quantization_type=&quot;ubinary&quot;</span>
+<span class="go">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">int8_embeddings</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="n">quantize_embeddings</span><span class="p">(</span>
+<span class="go">    embeddings=embeddings,</span>
+<span class="go">    quantization_type=&quot;int8&quot;</span>
+<span class="go">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">instance</span><span class="o">.</span><span class="n">create_usearch_index</span><span class="p">(</span>
+<span class="go">    int8_embeddings=int8_embeddings,</span>
+<span class="go">    index_path=&quot;./usearch_int8.index&quot;</span>
+<span class="go">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">instance</span><span class="o">.</span><span class="n">create_faiss_index</span><span class="p">(</span>
+<span class="go">    ubinary_embeddings=ubinary_embeddings,</span>
+<span class="go">    index_path=&quot;./faiss_ubinary.index&quot;</span>
+<span class="go">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">top_k_scores</span><span class="p">,</span> <span class="n">top_k_indices</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="n">search</span><span class="p">(</span>
+<span class="go">    query=&quot;Sont considérées comme ayant leur domicile fiscal en France au sens de l&#39;article 4 A&quot;,</span>
+<span class="go">    top_k=10,</span>
+<span class="go">    rescore_multiplier=4</span>
+<span class="go">)</span>
+</pre></div>
+</div>
+<dl class="py method">
+<dt class="sig sig-object py" id="id12">
+<span class="sig-name descname"><span class="pre">create_faiss_index</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ubinary_embeddings</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bytearray</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">index_path</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">save</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.create_faiss_index"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id12" title="Link to this definition">#</a></dt>
+<dd><p>Creates and saves a FAISS binary index from ubinary embeddings.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>ubinary_embeddings</strong> (<em>bytearray</em>) – The ubinary-quantized embeddings.</p></li>
+<li><p><strong>index_path</strong> (<em>str</em><em>, </em><em>optional</em>) – The file path to save the FAISS binary index. Default is None.</p></li>
+<li><p><strong>save</strong> (<em>bool</em><em>, </em><em>optional</em>) – Indicator for saving the index. Default is False.</p></li>
+</ul>
+</dd>
+</dl>
+<p class="rubric">Notes</p>
+<p>The dimensionality of the index is specified during the class initialization (default is 1024).</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id13">
+<span class="sig-name descname"><span class="pre">create_usearch_index</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">int8_embeddings</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">ndarray</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">index_path</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">save</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.create_usearch_index"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id13" title="Link to this definition">#</a></dt>
+<dd><p>Creates and saves a USEARCH integer index from int8 embeddings.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>int8_embeddings</strong> (<em>np.ndarray</em>) – The int8-quantized embeddings.</p></li>
+<li><p><strong>index_path</strong> (<em>str</em><em>, </em><em>optional</em>) – The file path to save the USEARCH integer index. Default is None.</p></li>
+<li><p><strong>save</strong> (<em>bool</em><em>, </em><em>optional</em>) – Indicator for saving the index. Default is False.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p>None</p>
+</dd>
+</dl>
+<p class="rubric">Notes</p>
+<p>The dimensionality and metric of the index are specified during class initialization.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id14">
+<span class="sig-name descname"><span class="pre">encode</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">corpus</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">list</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">normalize_embeddings</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">True</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">ndarray</span></span></span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.encode"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id14" title="Link to this definition">#</a></dt>
+<dd><p>Encodes the given corpus into full-precision embeddings.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>corpus</strong> (<em>list</em>) – A list of sentences to be encoded.</p></li>
+<li><p><strong>normalize_embeddings</strong> (<em>bool</em><em>, </em><em>optional</em>) – Whether to normalize returned vectors to have length 1. In that case,
+the faster dot-product (util.dot_score) instead of cosine similarity can be used. Default is True.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The full-precision embeddings of the corpus.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>np.ndarray</p>
+</dd>
+</dl>
+<p class="rubric">Notes</p>
+<p>This method normalizes the embeddings and shows the progress bar during the encoding process.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id15">
+<span class="sig-name descname"><span class="pre">load_faiss_index</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index_path</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.load_faiss_index"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id15" title="Link to this definition">#</a></dt>
+<dd><p>Loads a FAISS binary index from a specified file path.</p>
+<p>This method loads a binary index created by FAISS into the class
+attribute <cite>binary_index</cite>, ready for performing similarity searches.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>index_path</strong> (<em>str</em>) – The file path to the saved FAISS binary index.</p>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p>None</p>
+</dd>
+</dl>
+<p class="rubric">Notes</p>
+<p>The loaded index is stored in the <cite>binary_index</cite> attribute of the class.
+Ensure that the index at <cite>index_path</cite> is compatible with the configurations
+(e.g., dimensions) used for this class instance.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id16">
+<span class="sig-name descname"><span class="pre">load_usearch_index_view</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index_path</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">any</span></span></span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.load_usearch_index_view"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id16" title="Link to this definition">#</a></dt>
+<dd><p>Loads a USEARCH index as a view for memory-efficient operations.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>index_path</strong> (<em>str</em>) – The file path to the USEARCH index to be loaded as a view.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A view of the USEARCH index for memory-efficient similarity search operations.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>object</p>
+</dd>
+</dl>
+<p class="rubric">Notes</p>
+<p>Implementing this would depend on the specific USEARCH index handling library being used.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id17">
+<span class="sig-name descname"><span class="pre">quantize_embeddings</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">embeddings</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">ndarray</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">quantization_type</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">ndarray</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">bytearray</span></span></span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.quantize_embeddings"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id17" title="Link to this definition">#</a></dt>
+<dd><p>Quantizes the given embeddings based on the specified quantization type (‘ubinary’ or ‘int8’).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>embeddings</strong> (<em>np.ndarray</em>) – The full-precision embeddings to be quantized.</p></li>
+<li><p><strong>quantization_type</strong> (<em>str</em>) – The type of quantization (‘ubinary’ for unsigned binary, ‘int8’ for 8-bit integers).</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The quantized embeddings.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>Union[np.ndarray, bytearray]</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>ValueError</strong> – If an unsupported quantization type is provided.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="id18">
+<span class="sig-name descname"><span class="pre">search</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">query</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">top_k</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">10</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rescore_multiplier</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">4</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Tuple</span><span class="p"><span class="pre">[</span></span><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">float</span><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span><a class="reference internal" href="_modules/ragoon/similarity_search.html#SimilaritySearch.search"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#id18" title="Link to this definition">#</a></dt>
+<dd><p>Performs a search operation against the indexed embeddings.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>query</strong> (<em>str</em>) – The query sentence/string to be searched.</p></li>
+<li><p><strong>top_k</strong> (<em>int</em><em>, </em><em>optional</em>) – The number of top results to return.</p></li>
+<li><p><strong>rescore_multiplier</strong> (<em>int</em><em>, </em><em>optional</em>) – The multiplier used to increase the initial retrieval size for re-scoring.
+Higher values can increase precision at the cost of performance.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A tuple containing the scores and the indices of the top k results.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>Tuple[List[float], List[int]]</p>
+</dd>
+</dl>
+<p class="rubric">Notes</p>
+<p>This method assumes that <cite>binary_index</cite> and <cite>int8_index</cite> are already loaded or created.</p>
+</dd></dl>
+
+</dd></dl>
+
+</section>
+<section id="module-ragoon.web_rag">
+<span id="ragoon-web-rag-module"></span><h2>ragoon.web_rag module<a class="headerlink" href="#module-ragoon.web_rag" title="Link to this heading">#</a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="ragoon.web_rag.WebRAG">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">ragoon.web_rag.</span></span><span class="sig-name descname"><span class="pre">WebRAG</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">google_api_key</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">google_cx</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">completion_client</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">user_agent</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'Mozilla/5.0</span> <span class="pre">(Windows</span> <span class="pre">NT</span> <span class="pre">10.0;</span> <span class="pre">Win64;</span> <span class="pre">x64)</span> <span class="pre">AppleWebKit/537.36</span> <span class="pre">(KHTML,</span> <span class="pre">like</span> <span class="pre">Gecko)</span> <span class="pre">Chrome/98.0.4758.102</span> <span class="pre">Safari/537.36'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/web_rag.html#WebRAG"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.web_rag.WebRAG" title="Link to this definition">#</a></dt>
+<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></p>
+<dl class="py method">
+<dt class="sig sig-object py" id="ragoon.web_rag.WebRAG.search">
+<span class="sig-name descname"><span class="pre">search</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">query</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">completion_model</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">system_prompt</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">&quot;\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">Given</span> <span class="pre">the</span> <span class="pre">user's</span> <span class="pre">input</span> <span class="pre">query,</span> <span class="pre">generate</span> <span class="pre">a</span> <span class="pre">concise</span> <span class="pre">and</span> <span class="pre">relevant</span> <span class="pre">Google</span> <span class="pre">search\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">query</span> <span class="pre">that</span> <span class="pre">directly</span> <span class="pre">addresses</span> <span class="pre">the</span> <span class="pre">main</span> <span class="pre">intent</span> <span class="pre">of</span> <span class="pre">the</span> <span class="pre">user's</span> <span class="pre">question.</span> <span class="pre">The</span> <span class="pre">search</span> <span class="pre">query</span> <span class="pre">must\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">be</span> <span class="pre">specifically</span> <span class="pre">tailored</span> <span class="pre">to</span> <span class="pre">retrieve</span> <span class="pre">results</span> <span class="pre">that</span> <span class="pre">can</span> <span class="pre">significantly</span> <span class="pre">enhance</span> <span class="pre">the</span> <span class="pre">context</span> <span class="pre">for</span> <span class="pre">a\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">subsequent</span> <span class="pre">dialogue</span> <span class="pre">with</span> <span class="pre">an</span> <span class="pre">LLM.</span> <span class="pre">This</span> <span class="pre">approach</span> <span class="pre">will</span> <span class="pre">facilitate</span> <span class="pre">few-shot</span> <span class="pre">learning</span> <span class="pre">by</span> <span class="pre">providing\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">rich,</span> <span class="pre">specific,</span> <span class="pre">and</span> <span class="pre">contextually</span> <span class="pre">relevant</span> <span class="pre">information.</span> <span class="pre">Please</span> <span class="pre">ensure</span> <span class="pre">that</span> <span class="pre">the</span> <span class="pre">response</span> <span class="pre">is\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">well-formed</span> <span class="pre">and</span> <span class="pre">format</span> <span class="pre">it</span> <span class="pre">as</span> <span class="pre">a</span> <span class="pre">JSON</span> <span class="pre">object</span> <span class="pre">with</span> <span class="pre">a</span> <span class="pre">key</span> <span class="pre">named</span> <span class="pre">'search_query'.</span> <span class="pre">This\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">structured</span> <span class="pre">approach</span> <span class="pre">will</span> <span class="pre">help</span> <span class="pre">in</span> <span class="pre">assimilating</span> <span class="pre">the</span> <span class="pre">fetched</span> <span class="pre">results</span> <span class="pre">into</span> <span class="pre">an</span> <span class="pre">enhanced</span> <span class="pre">conversational\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">model,</span> <span class="pre">contributing</span> <span class="pre">to</span> <span class="pre">a</span> <span class="pre">more</span> <span class="pre">nuanced</span> <span class="pre">and</span> <span class="pre">informed</span> <span class="pre">interaction.\n</span>&#160;&#160;&#160;&#160;&#160;&#160;&#160; <span class="pre">&quot;</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/ragoon/web_rag.html#WebRAG.search"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#ragoon.web_rag.WebRAG.search" title="Link to this definition">#</a></dt>
+<dd><p>Search for information and perform completion.</p>
+<p>This method searches for information related to the given query
+and performs completion using the specified model. Additional
+parameters can be passed to the completion method.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>query</strong> (<em>str</em>) – The search query.</p></li>
+<li><p><strong>completion_model</strong> (<em>str</em>) – The name or identifier of the completion model to be used.</p></li>
+<li><p><strong>*args</strong> – Additional positional arguments to be passed to the completion method.</p></li>
+<li><p><strong>**kwargs</strong> – Additional keyword arguments to be passed to the completion method.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>completion_data</strong> – A dictionary containing the generated completion data.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>dict</p>
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
+</section>
+<section id="module-ragoon">
+<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-ragoon" title="Link to this heading">#</a></h2>
+</section>
+</section>
+
+
+                </article>
+              
+              
+              
+              
+              
+                <footer class="prev-next-footer d-print-none">
+                  
+<div class="prev-next-area">
+    <a class="left-prev"
+       href="modules.html"
+       title="previous page">
+      <i class="fa-solid fa-angle-left"></i>
+      <div class="prev-next-info">
+        <p class="prev-next-subtitle">previous</p>
+        <p class="prev-next-title">ragoon</p>
+      </div>
+    </a>
+</div>
+                </footer>
+              
+            </div>
+            
+            
+              
+                <div class="bd-sidebar-secondary bd-toc"><div class="sidebar-secondary-items sidebar-secondary__inner">
+
+
+  <div class="sidebar-secondary-item">
+<div
+    id="pst-page-navigation-heading-2"
+    class="page-toc tocsection onthispage">
+    <i class="fa-solid fa-list"></i> On this page
+  </div>
+  <nav class="bd-toc-nav page-toc" aria-labelledby="pst-page-navigation-heading-2">
+    <ul class="visible nav section-nav flex-column">
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#submodules">Submodules</a></li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#module-ragoon.embeddings">ragoon.embeddings module</a><ul class="nav section-nav flex-column">
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader</span></code></a><ul class="nav section-nav flex-column">
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.dataset_name"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.dataset_name</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.token"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.token</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.model_configs"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.model_configs</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.batch_size"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.batch_size</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.dataset</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.convert_to_tensor"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.convert_to_tensor</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.cuda_available"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.cuda_available</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.load_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.load_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.load_model"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.load_model()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.encode"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.encode()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.embed"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.embed()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.process_split"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.process_split()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.process_splits"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.process_splits()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.get_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.get_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.save_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.save_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsDataLoader.upload_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.upload_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id0"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.embed()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id1"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.encode()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id2"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.get_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id3"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.load_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id4"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.load_model()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id5"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.process_split()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id6"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.process_splits()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id7"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.save_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id8"><code class="docutils literal notranslate"><span class="pre">EmbeddingsDataLoader.upload_dataset()</span></code></a></li>
+</ul>
+</li>
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer</span></code></a><ul class="nav section-nav flex-column">
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.index_path"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.index_path</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.dataset_path"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.dataset_path</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.index"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.index</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.dataset</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.vectors"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.vectors</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.reduced_vectors"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.reduced_vectors</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.labels"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.labels</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.load_index"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.load_index()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.load_dataset"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.load_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.extract_vectors"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.extract_vectors()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.plot_3d"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.plot_3d()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.create_plot"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.create_plot()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id9"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.extract_vectors()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id10"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.load_dataset()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id11"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.load_index()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.reduce_dimensionality"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.reduce_dimensionality()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.embeddings.EmbeddingsVisualizer.visualize"><code class="docutils literal notranslate"><span class="pre">EmbeddingsVisualizer.visualize()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#module-ragoon.similarity_search">ragoon.similarity_search module</a><ul class="nav section-nav flex-column">
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch</span></code></a><ul class="nav section-nav flex-column">
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.model_name"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.model_name</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.device"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.device</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.ndim"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.ndim</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.metric"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.metric</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.dtype"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.dtype</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.encode"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.encode()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.quantize_embeddings"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.quantize_embeddings()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.create_faiss_index"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.create_faiss_index()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.create_usearch_index"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.create_usearch_index()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.load_usearch_index_view"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.load_usearch_index_view()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.load_faiss_index"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.load_faiss_index()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.similarity_search.SimilaritySearch.search"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.search()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id12"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.create_faiss_index()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id13"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.create_usearch_index()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id14"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.encode()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id15"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.load_faiss_index()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id16"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.load_usearch_index_view()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id17"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.quantize_embeddings()</span></code></a></li>
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#id18"><code class="docutils literal notranslate"><span class="pre">SimilaritySearch.search()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#module-ragoon.web_rag">ragoon.web_rag module</a><ul class="nav section-nav flex-column">
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.web_rag.WebRAG"><code class="docutils literal notranslate"><span class="pre">WebRAG</span></code></a><ul class="nav section-nav flex-column">
+<li class="toc-h4 nav-item toc-entry"><a class="reference internal nav-link" href="#ragoon.web_rag.WebRAG.search"><code class="docutils literal notranslate"><span class="pre">WebRAG.search()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#module-ragoon">Module contents</a></li>
+</ul>
+  </nav></div>
+
+  <div class="sidebar-secondary-item">
+
+  <div class="tocsection sourcelink">
+    <a href="_sources/ragoon.rst.txt">
+      <i class="fa-solid fa-file-lines"></i> Show Source
+    </a>
+  </div>
+</div>
+
+</div></div>
+              
+            
+          </div>
+          <footer class="bd-footer-content">
+            
+          </footer>
+        
+      </main>
+    </div>
+  </div>
+  
+  <!-- Scripts loaded after <body> so the DOM is not blocked -->
+  <script src="_static/scripts/bootstrap.js?digest=dfe6caa3a7d634c4db9b"></script>
+<script src="_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b"></script>
+
+  <footer class="bd-footer">
+<div class="bd-footer__inner bd-page-width">
+  
+    <div class="footer-items__start">
+      
+        <div class="footer-item">
+
+  <p class="copyright">
+    
+      © Copyright 2024, Louis Brulé Naudet.
+      <br/>
+    
+  </p>
+</div>
+      
+        <div class="footer-item">
+
+  <p class="sphinx-version">
+    Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.7.
+    <br/>
+  </p>
+</div>
+      
+    </div>
+  
+  
+  
+    <div class="footer-items__end">
+      
+        <div class="footer-item">
+<p class="theme-version">
+  Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.15.4.
+</p></div>
+      
+    </div>
+  
+</div>
+
+  </footer>
+  </body>
+</html>
\ No newline at end of file
diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex.js
new file mode 100644
index 0000000..1ccef32
--- /dev/null
+++ b/docs/build/html/searchindex.js
@@ -0,0 +1 @@
+Search.setIndex({"alltitles": {"Indices and tables": [[0, "indices-and-tables"]], "Module contents": [[2, "module-ragoon"]], "Modules:": [[0, null]], "RAGoon documentation": [[0, null]], "Submodules": [[0, "submodules"], [2, "submodules"]], "ragoon": [[1, null]], "ragoon package": [[0, "module-ragoon"], [2, null]], "ragoon.embeddings module": [[2, "module-ragoon.embeddings"]], "ragoon.similarity_search module": [[2, "module-ragoon.similarity_search"]], "ragoon.web_rag module": [[2, "module-ragoon.web_rag"]]}, "docnames": ["index", "modules", "ragoon"], "envversion": {"sphinx": 62, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1}, "filenames": ["index.rst", "modules.rst", "ragoon.rst"], "indexentries": {"batch_size (ragoon.embeddings.embeddingsdataloader attribute)": [[2, "ragoon.embeddings.EmbeddingsDataLoader.batch_size", false]], "convert_to_tensor (ragoon.embeddings.embeddingsdataloader attribute)": [[2, "ragoon.embeddings.EmbeddingsDataLoader.convert_to_tensor", false]], "create_faiss_index() (ragoon.similarity_search.similaritysearch method)": [[2, "id12", false], [2, "ragoon.similarity_search.SimilaritySearch.create_faiss_index", false]], "create_plot() (ragoon.embeddings.embeddingsvisualizer method)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.create_plot", false]], "create_usearch_index() (ragoon.similarity_search.similaritysearch method)": [[2, "id13", false], [2, "ragoon.similarity_search.SimilaritySearch.create_usearch_index", false]], "cuda_available (ragoon.embeddings.embeddingsdataloader attribute)": [[2, "ragoon.embeddings.EmbeddingsDataLoader.cuda_available", false]], "dataset (ragoon.embeddings.embeddingsdataloader attribute)": [[2, "ragoon.embeddings.EmbeddingsDataLoader.dataset", false]], "dataset (ragoon.embeddings.embeddingsvisualizer attribute)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.dataset", false]], "dataset_name (ragoon.embeddings.embeddingsdataloader attribute)": [[2, "ragoon.embeddings.EmbeddingsDataLoader.dataset_name", false]], "dataset_path (ragoon.embeddings.embeddingsvisualizer attribute)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.dataset_path", false]], "device (ragoon.similarity_search.similaritysearch attribute)": [[2, "ragoon.similarity_search.SimilaritySearch.device", false]], "dtype (ragoon.similarity_search.similaritysearch attribute)": [[2, "ragoon.similarity_search.SimilaritySearch.dtype", false]], "embed() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id0", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.embed", false]], "embeddingsdataloader (class in ragoon.embeddings)": [[2, "ragoon.embeddings.EmbeddingsDataLoader", false]], "embeddingsvisualizer (class in ragoon.embeddings)": [[2, "ragoon.embeddings.EmbeddingsVisualizer", false]], "encode() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id1", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.encode", false]], "encode() (ragoon.similarity_search.similaritysearch method)": [[2, "id14", false], [2, "ragoon.similarity_search.SimilaritySearch.encode", false]], "extract_vectors() (ragoon.embeddings.embeddingsvisualizer method)": [[2, "id9", false], [2, "ragoon.embeddings.EmbeddingsVisualizer.extract_vectors", false]], "get_dataset() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id2", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.get_dataset", false]], "index (ragoon.embeddings.embeddingsvisualizer attribute)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.index", false]], "index_path (ragoon.embeddings.embeddingsvisualizer attribute)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.index_path", false]], "labels (ragoon.embeddings.embeddingsvisualizer attribute)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.labels", false]], "load_dataset() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id3", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.load_dataset", false]], "load_dataset() (ragoon.embeddings.embeddingsvisualizer method)": [[2, "id10", false], [2, "ragoon.embeddings.EmbeddingsVisualizer.load_dataset", false]], "load_faiss_index() (ragoon.similarity_search.similaritysearch method)": [[2, "id15", false], [2, "ragoon.similarity_search.SimilaritySearch.load_faiss_index", false]], "load_index() (ragoon.embeddings.embeddingsvisualizer method)": [[2, "id11", false], [2, "ragoon.embeddings.EmbeddingsVisualizer.load_index", false]], "load_model() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id4", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.load_model", false]], "load_usearch_index_view() (ragoon.similarity_search.similaritysearch method)": [[2, "id16", false], [2, "ragoon.similarity_search.SimilaritySearch.load_usearch_index_view", false]], "metric (ragoon.similarity_search.similaritysearch attribute)": [[2, "ragoon.similarity_search.SimilaritySearch.metric", false]], "model_configs (ragoon.embeddings.embeddingsdataloader attribute)": [[2, "ragoon.embeddings.EmbeddingsDataLoader.model_configs", false]], "model_name (ragoon.similarity_search.similaritysearch attribute)": [[2, "ragoon.similarity_search.SimilaritySearch.model_name", false]], "module": [[0, "module-ragoon", false], [2, "module-ragoon", false], [2, "module-ragoon.embeddings", false], [2, "module-ragoon.similarity_search", false], [2, "module-ragoon.web_rag", false]], "ndim (ragoon.similarity_search.similaritysearch attribute)": [[2, "ragoon.similarity_search.SimilaritySearch.ndim", false]], "plot_3d() (ragoon.embeddings.embeddingsvisualizer method)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.plot_3d", false]], "process_split() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id5", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.process_split", false]], "process_splits() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id6", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.process_splits", false]], "quantize_embeddings() (ragoon.similarity_search.similaritysearch method)": [[2, "id17", false], [2, "ragoon.similarity_search.SimilaritySearch.quantize_embeddings", false]], "ragoon": [[0, "module-ragoon", false], [2, "module-ragoon", false]], "ragoon.embeddings": [[2, "module-ragoon.embeddings", false]], "ragoon.similarity_search": [[2, "module-ragoon.similarity_search", false]], "ragoon.web_rag": [[2, "module-ragoon.web_rag", false]], "reduce_dimensionality() (ragoon.embeddings.embeddingsvisualizer method)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.reduce_dimensionality", false]], "reduced_vectors (ragoon.embeddings.embeddingsvisualizer attribute)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.reduced_vectors", false]], "save_dataset() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id7", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.save_dataset", false]], "search() (ragoon.similarity_search.similaritysearch method)": [[2, "id18", false], [2, "ragoon.similarity_search.SimilaritySearch.search", false]], "search() (ragoon.web_rag.webrag method)": [[2, "ragoon.web_rag.WebRAG.search", false]], "similaritysearch (class in ragoon.similarity_search)": [[2, "ragoon.similarity_search.SimilaritySearch", false]], "token (ragoon.embeddings.embeddingsdataloader attribute)": [[2, "ragoon.embeddings.EmbeddingsDataLoader.token", false]], "upload_dataset() (ragoon.embeddings.embeddingsdataloader method)": [[2, "id8", false], [2, "ragoon.embeddings.EmbeddingsDataLoader.upload_dataset", false]], "vectors (ragoon.embeddings.embeddingsvisualizer attribute)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.vectors", false]], "visualize() (ragoon.embeddings.embeddingsvisualizer method)": [[2, "ragoon.embeddings.EmbeddingsVisualizer.visualize", false]], "webrag (class in ragoon.web_rag)": [[2, "ragoon.web_rag.WebRAG", false]]}, "objects": {"": [[0, 0, 0, "-", "ragoon"]], "ragoon": [[2, 0, 0, "-", "embeddings"], [2, 0, 0, "-", "similarity_search"], [2, 0, 0, "-", "web_rag"]], "ragoon.embeddings": [[2, 1, 1, "", "EmbeddingsDataLoader"], [2, 1, 1, "", "EmbeddingsVisualizer"]], "ragoon.embeddings.EmbeddingsDataLoader": [[2, 2, 1, "", "batch_size"], [2, 2, 1, "", "convert_to_tensor"], [2, 2, 1, "", "cuda_available"], [2, 2, 1, "", "dataset"], [2, 2, 1, "", "dataset_name"], [2, 3, 1, "id0", "embed"], [2, 3, 1, "id1", "encode"], [2, 3, 1, "id2", "get_dataset"], [2, 3, 1, "id3", "load_dataset"], [2, 3, 1, "id4", "load_model"], [2, 2, 1, "", "model_configs"], [2, 3, 1, "id5", "process_split"], [2, 3, 1, "id6", "process_splits"], [2, 3, 1, "id7", "save_dataset"], [2, 2, 1, "", "token"], [2, 3, 1, "id8", "upload_dataset"]], "ragoon.embeddings.EmbeddingsVisualizer": [[2, 3, 1, "", "create_plot"], [2, 2, 1, "", "dataset"], [2, 2, 1, "", "dataset_path"], [2, 3, 1, "id9", "extract_vectors"], [2, 2, 1, "", "index"], [2, 2, 1, "", "index_path"], [2, 2, 1, "", "labels"], [2, 3, 1, "id10", "load_dataset"], [2, 3, 1, "id11", "load_index"], [2, 3, 1, "", "plot_3d"], [2, 3, 1, "", "reduce_dimensionality"], [2, 2, 1, "", "reduced_vectors"], [2, 2, 1, "", "vectors"], [2, 3, 1, "", "visualize"]], "ragoon.similarity_search": [[2, 1, 1, "", "SimilaritySearch"]], "ragoon.similarity_search.SimilaritySearch": [[2, 3, 1, "id12", "create_faiss_index"], [2, 3, 1, "id13", "create_usearch_index"], [2, 2, 1, "", "device"], [2, 2, 1, "", "dtype"], [2, 3, 1, "id14", "encode"], [2, 3, 1, "id15", "load_faiss_index"], [2, 3, 1, "id16", "load_usearch_index_view"], [2, 2, 1, "", "metric"], [2, 2, 1, "", "model_name"], [2, 2, 1, "", "ndim"], [2, 3, 1, "id17", "quantize_embeddings"], [2, 3, 1, "id18", "search"]], "ragoon.web_rag": [[2, 1, 1, "", "WebRAG"]], "ragoon.web_rag.WebRAG": [[2, 3, 1, "", "search"]]}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "attribute", "Python attribute"], "3": ["py", "method", "Python method"]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:attribute", "3": "py:method"}, "terms": {"": 2, "0": 2, "1": 2, "10": 2, "102": 2, "1024": 2, "16": 2, "3": 2, "36": 2, "3d": 2, "4": 2, "42": 2, "4758": 2, "5": 2, "50": 2, "537": 2, "768": 2, "8": 2, "98": 2, "A": 2, "If": 2, "In": 2, "It": 2, "The": 2, "Then": 2, "acceler": 2, "access": 2, "add": 2, "addit": 2, "address": 2, "after": 2, "against": 2, "all": 2, "allow": 2, "alreadi": 2, "an": 2, "analysi": 2, "ani": 2, "api": 2, "applewebkit": 2, "appli": 2, "approach": 2, "approxim": 2, "ar": 2, "arg": 2, "argument": 2, "articl": 2, "assimil": 2, "assum": 2, "attribut": 2, "au": 2, "avail": 2, "ayant": 2, "bar": 2, "base": 2, "batch": 2, "batch_siz": [1, 2], "been": 2, "being": 2, "binari": 2, "binary_index": 2, "bit": 2, "bool": 2, "both": 2, "bytearrai": 2, "call": 2, "can": 2, "captur": 2, "case": 2, "chain": 2, "chrome": 2, "class": 2, "column": 2, "combin": 2, "comm": 2, "commonli": 2, "compat": 2, "complet": 2, "completion_cli": 2, "completion_data": 2, "completion_model": 2, "compon": 2, "comput": 2, "concis": 2, "configur": 2, "consid\u00e9r\u00e9": 2, "construct": 2, "contain": 2, "content": [0, 1], "context": 2, "contextu": 2, "contribut": 2, "convers": 2, "convert_to_tensor": [1, 2], "corpu": 2, "correspond": 2, "cosin": 2, "cost": 2, "cpu": 2, "creat": 2, "create_faiss_index": [1, 2], "create_plot": [1, 2], "create_usearch_index": [1, 2], "cuda": 2, "cuda_avail": [1, 2], "data": 2, "dataset": [1, 2], "dataset_nam": [1, 2], "dataset_path": [1, 2], "datasetdict": 2, "de": 2, "dedic": 2, "default": 2, "depend": 2, "detail": [], "devic": [1, 2], "dialogu": 2, "dict": 2, "dictionari": 2, "dimens": 2, "dimension": 2, "direct": 2, "directli": 2, "directori": 2, "disk": 2, "document": 2, "domicil": 2, "dot": 2, "dot_scor": 2, "dtype": [1, 2], "dure": 2, "dynam": 2, "e": 2, "each": 2, "effect": 2, "effici": 2, "either": 2, "emb": [1, 2], "embed": [0, 1], "embedding_visu": 2, "embeddingsdataload": [1, 2], "embeddingsvisu": [1, 2], "en": 2, "encod": [1, 2], "enhanc": 2, "ensur": 2, "etc": 2, "exampl": 2, "except": 2, "explor": 2, "extract": 2, "extract_vector": [1, 2], "face": 2, "facilit": 2, "fail": 2, "faiss": 2, "faiss_ubinari": 2, "fals": 2, "faster": 2, "fetch": 2, "few": 2, "figur": 2, "file": 2, "final": 2, "final_compon": 2, "first": 2, "fiscal": 2, "float": 2, "follow": 2, "form": 2, "format": 2, "franc": 2, "from": 2, "full": 2, "function": 2, "further": 2, "g": 2, "gecko": 2, "gener": 2, "get_dataset": [1, 2], "given": 2, "global": 2, "go": 2, "googl": 2, "google_api_kei": 2, "google_cx": 2, "gpu": 2, "ha": 2, "handl": 2, "have": 2, "help": 2, "high": 2, "higher": 2, "html": 2, "html_file_nam": 2, "hub": 2, "hug": 2, "i": 2, "i8": 2, "id": 2, "identifi": 2, "implement": 2, "increas": 2, "index": [0, 1, 2], "index_path": [1, 2], "indic": 2, "inferencecli": 2, "inform": 2, "initi": 2, "inner": 2, "input": 2, "instal": 2, "instanc": 2, "instead": 2, "int": 2, "int8": 2, "int8_embed": 2, "int8_index": 2, "integ": 2, "intent": 2, "interact": 2, "invalid": 2, "ip": 2, "issu": 2, "itself": 2, "json": 2, "k": 2, "karg": 2, "keep": 2, "kei": 2, "keyword": 2, "khtml": 2, "kwarg": 2, "l": 2, "lab": 2, "label": [1, 2], "larg": 2, "learn": 2, "lemon": 2, "length": 2, "leur": 2, "librari": 2, "like": 2, "linear": 2, "list": 2, "llm": 2, "load": 2, "load_dataset": [1, 2], "load_faiss_index": [1, 2], "load_index": [1, 2], "load_model": [1, 2], "load_usearch_index_view": [1, 2], "local": 2, "louisbrulenaudet": 2, "low": 2, "lower": 2, "main": 2, "manag": 2, "manifold": 2, "marker": 2, "mbert": 2, "memori": 2, "method": 2, "metric": [1, 2], "model": 2, "model_config": [1, 2], "model_nam": [1, 2], "modul": 1, "more": 2, "most": 2, "mozilla": 2, "multipli": 2, "must": 2, "my": 2, "n": 2, "name": 2, "ndarrai": 2, "ndim": [1, 2], "non": 2, "none": 2, "normal": 2, "normalize_embed": 2, "note": 2, "np": 2, "nt": 2, "nuanc": 2, "number": 2, "numpi": 2, "object": 2, "one": 2, "onto": 2, "oper": 2, "option": 2, "output": 2, "output_dir": 2, "packag": 1, "page": 0, "paramet": 2, "particularli": 2, "pass": 2, "passag": 2, "passage_prefix": 2, "path": 2, "pca": 2, "pca_compon": 2, "pca_umap": 2, "perform": 2, "pipelin": 2, "pleas": 2, "plot": 2, "plot_3d": [1, 2], "plotli": 2, "point": 2, "point_siz": 2, "posit": 2, "precis": 2, "prefix": 2, "preserv": 2, "princip": 2, "process": 2, "process_split": [1, 2], "product": 2, "progress": 2, "project": 2, "provid": 2, "quantiz": 2, "quantization_typ": 2, "quantize_embed": [1, 2], "queri": 2, "query_prefix": 2, "question": 2, "rais": 2, "random": 2, "random_st": 2, "re": 2, "readi": 2, "reduc": 2, "reduce_dimension": [1, 2], "reduced_vector": [1, 2], "reduct": 2, "relat": 2, "relev": 2, "repo_id": 2, "repositori": 2, "represent": 2, "reproduc": 2, "requir": 2, "rescore_multipli": 2, "respons": 2, "restructuredtext": [], "result": 2, "retriev": 2, "return": 2, "rich": 2, "runtimeerror": 2, "safari": 2, "sampl": 2, "save": 2, "save_dataset": [1, 2], "save_html": 2, "scatter": 2, "score": 2, "search": [0, 1, 2], "search_queri": 2, "see": [], "self": 2, "sen": 2, "sentenc": 2, "sentencetransform": 2, "shot": 2, "should": 2, "show": 2, "significantli": 2, "similar": 2, "similarity_search": [0, 1], "similaritysearch": [1, 2], "size": 2, "sne": 2, "sont": 2, "sourc": 2, "space": 2, "specif": 2, "specifi": 2, "split": 2, "state": 2, "step": 2, "storag": 2, "store": 2, "str": 2, "string": 2, "structur": 2, "submodul": 1, "subsequ": 2, "suit": 2, "syntax": [], "system_prompt": 2, "t": 2, "tailor": 2, "techniqu": 2, "tensor": 2, "text": 2, "them": 2, "thi": 2, "titl": 2, "token": [1, 2], "top": 2, "top_k": 2, "top_k_indic": 2, "top_k_scor": 2, "track": 2, "true": 2, "tsdae": 2, "tsne": 2, "tupl": 2, "two": 2, "type": 2, "ubinari": 2, "ubinary_embed": 2, "umap": 2, "underli": 2, "uniform": 2, "union": 2, "unsign": 2, "unsupport": 2, "upload": 2, "upload_dataset": [1, 2], "us": 2, "usearch": 2, "usearch_int8": 2, "user": 2, "user_ag": 2, "util": 2, "valu": 2, "valueerror": 2, "vari": 2, "vector": [1, 2], "view": 2, "visual": [1, 2], "web_rag": [0, 1], "webrag": [1, 2], "well": 2, "when": 2, "where": 2, "whether": 2, "which": 2, "win64": 2, "window": 2, "would": 2, "x64": 2, "yet": 2, "your": []}, "titles": ["RAGoon documentation", "ragoon", "ragoon package"], "titleterms": {"content": 2, "document": 0, "embed": 2, "indic": 0, "modul": [0, 2], "packag": [0, 2], "ragoon": [0, 1, 2], "similarity_search": 2, "submodul": [0, 2], "tabl": 0, "web_rag": 2}})
\ No newline at end of file
diff --git a/docs/source/conf.py b/docs/source/conf.py
index c4a597a..83013d6 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -43,8 +43,6 @@
 html_static_path = ['_static']
 
 html_theme_options = {
-	"show_nav_level": 2,  # Controls the number of navigation levels to show
-    "navigation_depth": 4,  # Adjust the depth of navigation levels
     "external_links": [
         {"name": "GitHub", "url": "https://github.com/louisbrulenaudet"},
         {"name": "Twitter", "url": "https://x.com/louisbrulenaudet"}
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 1306f99..7faea83 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -10,13 +10,16 @@ Contents:
 
 .. toctree::
    :maxdepth: 2
-   :caption: Contents:
+   :caption: Modules:
 
-   introduction
    modules
    api_reference
    ragoon
+<<<<<<< HEAD
    
+=======
+
+>>>>>>> parent of f9a7317 (Add section navigation to Sphinx documentation)
 Indices and tables
 ==================
 
diff --git a/docs/source/introduction.rst b/docs/source/introduction.rst
deleted file mode 100644
index 2a1cab4..0000000
--- a/docs/source/introduction.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-Introduction
-============
-
-Welcome to the RAGoon documentation. This section provides an overview of the project.
-
-.. contents:: Table of Contents
-   :local:
-   :depth: 2