HiveMind Voice Satellite

HiveMind Voice Satellite is a full-stack OVOS voice satellite. Microphone capture, VAD, wakeword detection, STT, and TTS all run on this device. The satellite transcribes speech locally and sends only the resulting text utterance to the hive. Responses arrive as text and the satellite speaks them locally. This satellite needs the most compute of the satellite family. It puts the least load on the server and works fully offline once set up.

Satellite spectrum

Satellite	Mic	VAD	Wakeword	STT	TTS	What crosses the wire
HiveMind-cli	n/a	n/a	n/a	n/a	n/a	text in / text out
hivemind-mic-satellite	local	local	n/a	remote	remote	raw audio stream
HiveMind-voice-relay	local	local	local	remote	remote	audio after wakeword
HiveMind-voice-sat ← you are here	local	local	local	local	local	text utterances only

Use voice-sat when the device has CPU/GPU to spare, bandwidth is limited, or audio privacy matters.

Install

pip install --pre HiveMind-voice-sat
# Linux: ALSA or SoundDevice microphone support
pip install --pre "HiveMind-voice-sat[linux]"
# macOS
pip install --pre "HiveMind-voice-sat[mac]"

HiveMind-voice-sat is published as pre-releases, so pass --pre. Without it, pip installs the last stable release, 2.0.1, with an older OVOS listener and audio stack (ovos-dinkum-listener 0.5.0, ovos-audio 1.2.0) that does not match these docs. With uv, the same install is uv pip install --prerelease=allow HiveMind-voice-sat.

60-second quickstart

1. Add a client on the hive (run this on the server):

hivemind-core add-client --name my-voice-sat
# outputs: Access Key and Password, copy them

2. Run the satellite (on this device):

hivemind-voice-sat --host <hive-host> --key <access-key> --password <password>

Say your wakeword. The satellite transcribes locally and sends the utterance to the hive.

Minimal configuration

The satellite reads ~/.config/mycroft/mycroft.conf (standard OVOS config). Override STT, TTS, VAD, and wakeword plugins there:

{
  "listener": {
    "VAD": {
      "module": "ovos-vad-plugin-silero"
    },
    "wake_word": "hey_mycroft",
    "hey_mycroft": {
      "module": "ovos-ww-plugin-vosk"
    }
  },
  "stt": {
    "module": "ovos-stt-plugin-server",
    "ovos-stt-plugin-server": { "url": "https://stt.openvoiceos.org/stt" }
  },
  "tts": {
    "module": "ovos-tts-plugin-server",
    "ovos-tts-plugin-server": { "host": "https://tts.openvoiceos.org" }
  }
}

All plugin slots are swappable via ovos-plugin-manager. See docs/configuration.md for the full reference.

CLI reference

Usage: hivemind-voice-sat [OPTIONS]
  connect to HiveMind
Options:
  --host TEXT       hivemind host (ws:// or wss://)
  --key TEXT        Access Key
  --password TEXT   Password for key derivation
  --port INTEGER    HiveMind port number (default 5678)
  --selfsigned      accept self-signed certificates
  --siteid TEXT     location identifier for message.context
  --help            Show this message and exit.

Documentation

Full zero-to-hero docs live in docs/:

Development

git clone https://github.com/JarbasHiveMind/HiveMind-voice-sat
cd HiveMind-voice-sat
pip install -e ".[test]"   # lightweight smoke deps
pytest tests/test_smoke.py
pip install -e ".[e2e]"    # full hivemind-core + 2.x stack for end-to-end
pytest tests/e2e/

pyproject.toml is the single packaging source of truth. The dependency stack now runs on ovos-bus-client 2.x (see docs/architecture.md). Prerelease dependencies are pinned as minimum versions, so pip resolves them without --pre.

Project	Role
HiveMind-core	The hive, install it on the server
HiveMind-cli	Text-only client
hivemind-mic-satellite	Thinnest audio satellite
HiveMind-voice-relay	Mid-weight: local wakeword, remote STT/TTS

License

Apache-2.0. See LICENSE.

Metadata

Release files for HiveMind-voice-sat 2.2.3a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for HiveMind-voice-sat 2.2.3a1
File	Size	Uploaded
hivemind_voice_sat-2.2.3a1.tar.gz	14.2 kB	Sep 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for HiveMind-voice-sat 2.2.3a1
File	Interpreter	ABI	Platform	Reset
hivemind_voice_sat-2.2.3a1-py3-none-any.whl 12.1 kB Sep 13, 2026	Python 3	none	any	Details

Total release size: 26.3 kB

Release files / hivemind_voice_sat-2.2.3a1.tar.gz

Download URL	hivemind_voice_sat-2.2.3a1.tar.gz
Size	14.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`cc228c0bab3b6d4b830dfe7497f4b8ebe83799f4485cc92d777c7e8284e63660`
BLAKE2b-256 checksum How to use checksums	`d87c2e3dc265507c15a6f2a6a4ca4a072a218e1a36bde5635aaad673a999fe6f`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / hivemind_voice_sat-2.2.3a1-py3-none-any.whl

Download URL	hivemind_voice_sat-2.2.3a1-py3-none-any.whl
Size	12.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5e9aacc34997b417f312ff9444e1b5e69764090d9a0b657fb8e0106d8a63c2b2`
BLAKE2b-256 checksum How to use checksums	`7d9000c9c6922b2881828a3e7ebd343b89adf6cf3502360cb9ed8b74f49171bd`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`