> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Start Moorcheh, create a namespace, upload data, and search.

## 1. Start the server

```bash theme={null}
pip install moorcheh-client
moorcheh up          # first run: choose embedding provider (Ollama, OpenAI, or Cohere)
moorcheh status
```

API base URL: `http://localhost:8080`

<Note>
  To set embeddings and the answer LLM before starting: `moorcheh configure`. See [Embedding providers](/on-prem/guides/embedding-providers). **Ollama** is only required if you choose it as the provider. If you change config later while the server is running, run **`moorcheh down`** then **`moorcheh up`**. Re-running configure with existing data under `~/.moorcheh/data` and a **different embedding model** can break search for old text namespaces until you re-upload.
</Note>

## 2. Create a namespace

```bash theme={null}
moorcheh namespace-create --name docs --type text
```

Or in Python:

```python theme={null}
from moorcheh import MoorchehClient

with MoorchehClient("http://localhost:8080") as client:
    client.namespaces.create("docs", type="text")
```

## 3. Upload documents

Save `docs-upload.json`:

```json theme={null}
{
  "documents": [
    {
      "id": "doc-1",
      "text": "Hello from Moorcheh on-prem",
      "team": "ai"
    }
  ]
}
```

```bash theme={null}
moorcheh upload-documents --namespace-name docs --documents-file docs-upload.json
moorcheh upload-job-status --namespace-name docs --job-id <job_id>
```

## 4. Search

```bash theme={null}
moorcheh search --query "hello moorcheh" --namespaces docs --top-k 5
```

## Optional: Upload a file (PDF, DOCX, …)

Place a file under `~/.moorcheh/uploads`, then:

```bash theme={null}
moorcheh upload-file --namespace-name docs --file ~/.moorcheh/uploads/document.pdf
moorcheh file-job-status --namespace-name docs --job-id <job_id>
moorcheh search --query "experience" --namespaces docs --top-k 5
```

The server reads `/uploads/document.pdf` inside the container. See [Upload file](/on-prem/api-references/files/upload).

## 5. Stop (data is kept)

```bash theme={null}
moorcheh down
```

Data remains in `~/.moorcheh/data`.

## Next steps

<CardGroup cols={2}>
  <Card title="CLI" icon="terminal" href="/on-prem/cli/introduction">
    Full `moorcheh` command reference
  </Card>

  <Card title="API reference" icon="code" href="/on-prem/api-references/health">
    Full REST endpoint documentation
  </Card>

  <Card title="Python client" icon="python" href="/on-prem/python-client/getting-started">
    End-to-end Python workflow
  </Card>
</CardGroup>