> ## 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.

# moorcheh-edge upload-documents

> Upload text documents (embeds locally, text store, 384-dim).

## Synopsis

```bash theme={null}
moorcheh-edge upload-documents --documents-file PATH [--base-url URL]
```

## Options

| Flag               | Required | Description                                    |
| ------------------ | -------- | ---------------------------------------------- |
| `--documents-file` | Yes      | Path to JSON with `{"documents": [...]}`       |
| `--base-url`       | No       | API base URL (default `http://localhost:8080`) |

## File format

```json theme={null}
{
  "documents": [
    {
      "id": "doc-1",
      "text": "Hello world"
    }
  ]
}
```

The CLI embeds each document with BGE-small-en-v1.5 (384 dimensions) and uploads to a **text** store.

## Example

```bash theme={null}
moorcheh-edge upload-documents --documents-file documents.json
```

See [API: Upload](/api-references/upload).
