Skip to main content

​
Overview

The moorcheh-edge voice commands run speech-to-text (Whisper), text-to-speech (Piper), and a voice RAG loop on the same machine as Moorcheh Edge - for example an Arduino UNO Q with a USB mic and speaker.
Voice commands require Linux with ALSA audio. They are not supported on Windows or macOS. On a PC demo, use browser-based voice in your app instead.

​
Prerequisites

  1. Moorcheh Edge running with RAG: moorcheh-edge up --with-llm --warm-llm -y
  2. One-time voice setup: moorcheh-edge voice setup
  3. Bluetooth speaker: manual pairing guide (wired USB is configured by voice setup)
For the retail kiosk demo (holding welcome audio + ambient thinking loop), see Retail Kiosk.

​
Commands

​
Typical workflow (UNO Q)

Terminal 1 - Moorcheh Edge (already running from up). Terminal 2 - voice HTTP server for a remote display PC:
Or test locally without HTTP:
When speak: true on /ask/stream, the server streams answer tokens to the client immediately and starts TTS after the full answer is ready (one Piper pass on the device speaker).

​
HTTP API

When you run voice serve, the CLI starts a small HTTP server (default http://0.0.0.0:8766) documented in Voice server API.