[DOC] CLI Docs (chroma-core#4187)

## Description of changes
New docs for the CLI

Author: itaismith

docs/docs.trychroma.com/markdoc/content/cli/install-and-run.md

@@ -0,0 +1,91 @@
+# Installing the Chroma CLI
+
+The Chroma CLI lets you run a Chroma server locally on your machine, install sample apps, browse your collections, interact with your Chroma Cloud DBs, and much more!
+
+When you install our Python or JavaScript package globally, you will automatically get the Chroma CLI.
+
+If you don't use one of our packages, you can still install the CLI as a standalone program with `cURL` (or `iex` on Windows).
+
+## Python
+
+You can install Chroma in your environment using `pip`:
+
+```terminal
+pip install chromadb
+```
+
+Or install the Chroma CLI globally with `pipx`
+
+```terminal
+pipx install chromadb
+```
+
+[//]: # (## JavaScript)
+
+[//]: # ()
+[//]: # ({% TabbedUseCaseCodeBlock language="Terminal" %})
+
+[//]: # ()
+[//]: # ({% Tab label="yarn" %})
+
+[//]: # (```terminal)
+
+[//]: # (yarn global add chromadb )
+
+[//]: # (```)
+
+[//]: # ({% /Tab %})
+
+[//]: # ()
+[//]: # ({% Tab label="npm" %})
+
+[//]: # (```terminal)
+
+[//]: # (npm install -g chromadb)
+
+[//]: # (```)
+
+[//]: # ({% /Tab %})
+
+[//]: # ()
+[//]: # ({% Tab label="pnpm" %})
+
+[//]: # (```terminal)
+
+[//]: # (pnpm add -g chromadb )
+
+[//]: # (```)
+
+[//]: # ({% /Tab %})
+
+[//]: # ()
+[//]: # ({% Tab label="bun" %})
+
+[//]: # (```terminal)
+
+[//]: # (bun add -g chromadb )
+
+[//]: # (```)
+
+[//]: # ({% /Tab %})
+
+[//]: # ()
+[//]: # ({% /TabbedUseCaseCodeBlock %})
+
+## Install Globally
+
+{% TabbedUseCaseCodeBlock language="Terminal" %}
+
+{% Tab label="cURL" %}
+```terminal
+curl -sSL https://raw.githubusercontent.com/chroma-core/chroma/main/rust/cli/install/install.sh | bash 
+```
+{% /Tab %}
+
+{% Tab label="Windows" %}
+```terminal
+iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/chroma-core/chroma/main/rust/cli/install/install.ps1'))
+```
+{% /Tab %}
+
+{% /TabbedUseCaseCodeBlock %}

docs/docs.trychroma.com/markdoc/content/cli/install.md

@@ -0,0 +1,39 @@
+# Running a Chroma Server
+
+The Chroma CLI lets you run a Chroma server locally with the `chroma run` command:
+
+```terminal
+chroma run --path [/path/to/persist/data]
+```
+
+Your Chroma server will persist its data in the path you provide after the `path` argument. By default,
+it will save data to the `chroma` directory.
+
+You can further customize how your Chroma server runs with these arguments:
+* `host` - defines the hostname where your server runs. By default, this is `localhost`.
+* `port` - the port your Chroma server will use to listen for requests from clients. By default the port is `8000`.
+* `config_path` - instead of providing `path`, `host`, and `port`, you can provide a configuration file with these definitions and more. You can find an example [here](https://github.com/chroma-core/chroma/blob/main/rust/frontend/sample_configs/single_node_full.yaml).
+
+## Connecting to your Chroma Server
+
+With your Chroma server running, you can connect to it with the `HttpClient`:
+
+{% TabbedCodeBlock %}
+
+{% Tab label="python" %}
+```python
+import chromadb
+
+chroma_client = chromadb.HttpClient(host='localhost', port=8000)
+```
+{% /Tab %}
+
+{% Tab label="typescript" %}
+```typescript
+import { ChromaClient } from "chromadb";
+
+const client = new ChromaClient();
+```
+{% /Tab %}
+
+{% /TabbedCodeBlock %}

docs/docs.trychroma.com/markdoc/content/cli/run.md

@@ -0,0 +1,19 @@
+# Sample Apps
+
+The Chroma team regularly releases sample AI applications powered by Chroma, which you can use to learn about retrieval, building with AI, and as a jumping-off board for your own projects.
+
+The CLI makes it easy to install and set up the Chroma sample apps on your local machine with the `chroma install` command.
+
+To install a sample app simply run
+
+```terminal
+chroma install [app_name]
+```
+
+The CLI will walk you through any particular customization you can make, and setting up your environment.
+
+To see a full list of available sample app, use the `list` argument:
+
+```terminal
+chroma install --list
+```

docs/docs.trychroma.com/markdoc/content/cli/sample-apps.md

@@ -0,0 +1,5 @@
+# Update
+
+The `chroma update` command wil inform you if you should update your CLI installation.
+
+If you run the CLI via our Python or JavaScript packages, the `update` command will inform you if a new `chromadb` version is availble. When you update your `chromadb` package, you will also get the latest version of the CLI bundled with it.

docs/docs.trychroma.com/markdoc/content/cli/update.md

@@ -157,7 +157,9 @@ const sidebarConfig: AppSection[] = [
     default: "install-and-run",
     icon: SquareTerminalIcon,
     pages: [
-      { id: "install-and-run", name: "Install and run" },
+      { id: "install", name: "Installing the CLI" },
+      { id: "run", name: "Run a Chroma Server" },
+      { id: "sample-apps", name: "Sample Apps" },
       { id: "vacuum", name: "Vacuum" },
     ],
   },
@@ -186,14 +188,6 @@ const sidebarConfig: AppSection[] = [
       },
     ],
   },
-  // {
-  //   id: "guides-and-examples",
-  //   name: "Guides & Examples",
-  //   icon: GraduationCap,
-  //   disable: true,
-  //   tag: "Coming Soon",
-  // },
 ];
 
 export default sidebarConfig;
-

docs/docs.trychroma.com/markdoc/content/sidebar-config.ts

@@ -1,6 +1,5 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-/// <reference types="next/navigation-types/compat/navigation" />
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/building-your-application/configuring/typescript for more information.