Skip to main content

​
Synopsis

moorcheh-edge voice ask [options]
Embeds the question locally (BGE, 768-dim), calls POST /answer on Moorcheh Edge, and optionally plays the reply with Piper TTS.
Run moorcheh-edge up --with-llm first so Ollama and the answer model are available. Run voice setup once before first use.

​
Options

FlagDefaultDescription
--base-urlhttp://localhost:8080Moorcheh Edge API base URL
--query-Skip STT and use this text as the question
--seconds5Recording length when --query is omitted
--capture-device-ALSA capture device for recording
--playback-device-ALSA playback device for TTS
--top-k5Passages to retrieve for context
--threshold0.0Minimum score when --kiosk-mode is set
--kiosk-modeoffFilter low-scoring passages
--header-prompt-Custom system instruction
--footer-prompt-Instruction before the question
--chat-history-json-Prior turns as JSON array
--temperatureserver defaultLLM temperature 0.0–2.0
--timeout120HTTP timeout in seconds
--no-speakoffPrint answer only; do not play TTS
--jsonoffPrint full API JSON plus heard; still speaks unless --no-speak

​
Examples

moorcheh-edge voice ask --kiosk-mode --query "What are your hours?"
moorcheh-edge voice ask --kiosk-mode --threshold 0.3 --top-k 2
moorcheh-edge voice ask --query "Do you have oat milk?" --no-speak --json
When --query is omitted, the CLI records for --seconds and prints what it heard before answering.

​
Output

Without --json, prints Q: and A: lines. With --json, prints the full /answer response plus "heard".