deploy: 15db33a

faq/index.html

@@ -1994,6 +1994,15 @@
     </span>
   </a>
 
+</li>
+
+          <li class="md-nav__item">
+  <a href="#runtimeerror-chroma-is-running-in-http-only-client-mode-and-can-only-be-run-with-chromadbapifastapifastapi" class="md-nav__link">
+    <span class="md-ellipsis">
+      RuntimeError: Chroma is running in http-only client mode, and can only be run with 'chromadb.api.fastapi.FastAPI'
+    </span>
+  </a>
+
 </li>
 
       </ul>
@@ -2155,6 +2164,46 @@ <h3 id="sqlite3operationalerror-database-or-disk-is-full"><code>sqlite3.Operatio
 <p class="admonition-title">SQLite Temp File</p>
 <p>More information on sqlite3 temp files can be found <a href="https://www.sqlite.org/tempfiles.html">here</a>.</p>
 </div>
+<h3 id="runtimeerror-chroma-is-running-in-http-only-client-mode-and-can-only-be-run-with-chromadbapifastapifastapi"><code>RuntimeError: Chroma is running in http-only client mode, and can only be run with 'chromadb.api.fastapi.FastAPI'</code><a class="headerlink" href="#runtimeerror-chroma-is-running-in-http-only-client-mode-and-can-only-be-run-with-chromadbapifastapifastapi" title="Permanent link">&para;</a></h3>
+<p><strong>Symptoms and Context:</strong></p>
+<p>The following error is raised when trying to create a new <code>PersistentClient</code>, <code>EphemeralClient</code>, or <code>Client</code>:</p>
+<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>RuntimeError: Chroma is running in http-only client mode, and can only be run with &#39;chromadb.api.fastapi.FastAPI&#39; 
+</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>as the chroma_api_impl. see https://docs.trychroma.com/usage-guide?lang=py#using-the-python-http-only-client for more information.
+</span></code></pre></div>
+<p><strong>Cause:</strong></p>
+<p>There are two possible causes for this error:</p>
+<ul>
+<li><code>chromadb-client</code> is installed and you are trying to work with a local client.</li>
+<li>Dependency conflict with <code>chromadb-client</code> and <code>chromadb</code> packages.</li>
+</ul>
+<p><strong>Explanation/Solution:</strong></p>
+<p>Chroma comes in two packages - <code>chromadb</code> and <code>chromadb-client</code>. The <code>chromadb-client</code> package is used to interact with
+a remote Chroma server. If you are trying to work with a local client, you should use the <code>chromadb</code> package. If you are
+planning to interact with remote server only it is recommended to use the <code>chromadb-client</code> package.</p>
+<p>If you intend to work locally with Chroma (e.g. embed in your app) then we suggest that you uninstall
+the <code>chromadb-client</code> package and install the <code>chromadb</code> package.</p>
+<p>To check which package you have installed:</p>
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>pip<span class="w"> </span>list<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>chromadb
+</span></code></pre></div>
+<p>To uninstall the <code>chromadb-client</code> package:</p>
+<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>pip<span class="w"> </span>uninstall<span class="w"> </span>chromadb-client
+</span></code></pre></div>
+<details class="tip">
+<summary>Working with virtual environments</summary>
+<p>It is recommended to work with virtual environments to avoid dependency conflicts. To create a virtual environment 
+you can use the following snippet:</p>
+<p><div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>pip<span class="w"> </span>install<span class="w"> </span>virtualenv
+</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>python<span class="w"> </span>-m<span class="w"> </span>venv<span class="w"> </span>myenv
+</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="nb">source</span><span class="w"> </span>myenv/bin/activate
+</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>pip<span class="w"> </span>install<span class="w"> </span>chromadb<span class="w"> </span><span class="c1"># and other packages you need</span>
+</span></code></pre></div>
+Alternatively you can use <code>conda</code> or <code>poetry</code> to manage your environments.</p>
+</details>
+<details class="tip">
+<summary>Default Embedding Function</summary>
+<p>Default embedding function - <code>chromadb.utils.embedding_functions.DefaultEmbeddingFunction</code> - can only be used with
+<code>chromadb</code> package.</p>
+</details>
 
 
 
@@ -2175,7 +2224,7 @@ <h3 id="sqlite3operationalerror-database-or-disk-is-full"><code>sqlite3.Operatio
     <span class="md-icon" title="Last update">
       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1-2.1-2M12.5 7v5.2l4 2.4-1 1L11 13V7h1.5M11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2v1.8Z"/></svg>
     </span>
-    <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">May 28, 2024</span>
+    <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">June 1, 2024</span>
   </span>