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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.