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

# CLI overview

> moorcheh-edge command-line interface.

## Install

```bash theme={null}
pip install moorcheh-edge
```

## Command groups

| Group       | Commands                                     | Purpose                                        |
| ----------- | -------------------------------------------- | ---------------------------------------------- |
| **Runtime** | `up`, `down`, `status`                       | Docker container lifecycle                     |
| **Upload**  | `upload-documents`, `upload-vectors`         | Text (BGE) or precomputed vectors              |
| **Search**  | `search`                                     | Text or vector query                           |
| **Answer**  | `answer`                                     | RAG with local LLM (`qwen2.5:0.5b-instruct`)   |
| **Voice**   | `voice setup`, `voice ask`, `voice serve`, … | STT/TTS and kiosk voice on Linux edge hardware |
| **Delete**  | `delete`, `clear-store`                      | Remove items or wipe the store                 |

## Typical workflow (text store)

```bash theme={null}
moorcheh-edge up
moorcheh-edge status
moorcheh-edge upload-documents --documents-file documents.json
moorcheh-edge search --query-text "Hello world" --top-k 5
moorcheh-edge answer --query "Who won the football match?" --top-k 5
moorcheh-edge delete --ids-json '["doc-1"]'
moorcheh-edge clear-store
moorcheh-edge down
```

## Output

API commands print **JSON** to stdout. Errors print JSON (when available) and exit with code `1`.

## Data directory

`moorcheh-edge up` stores data at `~/.moorcheh-edge/data`. `moorcheh-edge down` stops the container but does not delete your data.

## Shared flag: `--base-url`

```bash theme={null}
--base-url http://localhost:8080
```

Use when the server runs on a non-default port:

```bash theme={null}
moorcheh-edge up --server-port 8083
moorcheh-edge status --base-url http://localhost:8083
```

## Help

```bash theme={null}
moorcheh-edge --help
moorcheh-edge up --help
moorcheh-edge search --help
moorcheh-edge answer --help
moorcheh-edge voice --help
```

## Voice (Linux edge hardware)

On-device speech commands (`voice setup`, `voice listen`, `voice serve`, …) require **Linux** with ALSA. See [Voice CLI overview](/cli/voice/introduction).