---
id: wyoming
version: "1.10.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# wyoming — Peer-to-peer protocol for voice assistants

License: permissive · Maintenance: active · Downloads: 134.6K/mo

## What it is and what it does

Wyoming defines a standardized peer-to-peer protocol for voice assistants to communicate over TCP. It combines JSON-formatted headers with optional UTF-8 data and binary PCM audio payloads, enabling modular voice pipelines where different services (speech recognition, text-to-speech, wake word detection, intent handling) can be composed together. The protocol is used by Home Assistant for coordinating voice operations across distributed components.

The package provides protocol definitions and utilities for building voice assistant systems that need to exchange audio and control messages. It supports audio streaming with configurable sample rates, bit depths, and channels, plus service discovery and capability negotiation through structured info messages. This makes it useful for anyone building voice-driven applications or integrating multiple voice services into a cohesive system.

Use it for:

- Building a voice assistant that coordinates multiple speech recognition and text-to-speech services over a network
- Implementing wake word detection that communicates with a central voice pipeline via the Wyoming protocol
- Creating a Home Assistant integration that sends audio to remote voice processing services
- Developing a voice satellite that captures audio locally and streams it to a central voice processing hub
- Composing modular voice pipelines where each component (ASR, TTS, intent handling) runs as a separate service

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Wyoming is a peer-to-peer TCP protocol for voice assistants that exchanges JSONL-formatted messages and PCM audio, enabling communication between voice services like speech recognition, text-to-speech, wake word detection, and intent handling.

Yes, if you are building or integrating with voice assistant systems that use the Wyoming protocol—particularly Home Assistant voice integrations or modular voice pipelines. The protocol is well-maintained, has no external dependencies, and supports current Python versions. Install only if you have a concrete use case requiring Wyoming protocol support; it is not a general-purpose library.

## Install

pip install wyoming
uv add wyoming
poetry add wyoming

## Installing wyoming

Before you install: Low install friction with no runtime dependencies. The package is actively maintained with a recent release and steady commit activity. Supports Python 3.8 through 3.13.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it suitable for both open-source and proprietary projects.

Quickstart:

pip install wyoming

import wyoming.protocol

# Parse a Wyoming protocol message from bytes
message = wyoming.protocol.parse_message(data)

Verify before relying:

- Whether the package provides client/server implementation utilities or only protocol definitions
- What specific voice service implementations are available or required for practical use
- Whether Home Assistant integration is built-in or requires separate configuration

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 134.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

voice assistant protocol, speech recognition integration, peer-to-peer voice communication, PCM audio streaming protocol, home assistant voice services, wake word detection protocol, text-to-speech integration, voice-protocol, home-assistant, audio-streaming

[View on SkillFed](https://skillfed.io/packages/wyoming) · [View on PyPI](https://pypi.org/project/wyoming/)