Zenoh CLI

A command line tool for interacting with a Zenoh session.

Typical use cases include:

Tests
Investigations
Probing
As part of a bash pipeline

zenoh-cli makes use of codecs for encoding and decoding to and from the wire payloads on the zenoh network bus. By default, zenoh-cli bundles the following codecs:

text
base64
JSON

A plugin system is in place to allow for easily extending the available codecs in zenoh-cli, see below.

Installation

pip install zenoh-cli

Usage

usage: zenoh [-h] [--mode {peer,client}] [--connect CONNECT] [--listen LISTEN] [--config CONFIG] [--log-level LOG_LEVEL] {info,network,scout,delete,put,subscribe,get} ...

Zenoh command-line client application

positional arguments:
  {info,network,scout,delete,put,subscribe,get}

options:
  -h, --help            show this help message and exit
  --mode {peer,client}
  --connect CONNECT     Endpoints to connect to. (default: None)
  --listen LISTEN       Endpoints to listen on. (default: None)
  --config CONFIG       A path to a configuration file. (default: None)
  --log-level LOG_LEVEL

Example output of `zenoh network`

Extending with codecs for encoding/decoding values

zenoh-cli comes with a plugin system for easily extending it with custom encoders and decoders (codecs) for the data values. The plugin system makes use of the entrypoints provided by setuptools, see here for details. zenoh-cli gather plugins from two custom "groups":

zenoh_cli.codecs.encoders
zenoh_cli.codecs.decoders

For an example, see example_plugin

Metadata

Release files for zenoh-cli 0.7.0

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

Built distribution (wheel)

Table of built distributions (wheels) for zenoh-cli 0.7.0
File	Interpreter	ABI	Platform	Reset
zenoh_cli-0.7.0-py3-none-any.whl 11.7 kB Jan 12, 2026	Python 3	none	any	Details

Release files / zenoh_cli-0.7.0-py3-none-any.whl

Download URL	zenoh_cli-0.7.0-py3-none-any.whl
Size	11.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f60539f0b70ccc8af49a8ee19683c32c8cd08c521a54a1ef9a9cf40462c1169a`
BLAKE2b-256 checksum How to use checksums	`4532f860467059767fd80af1fc85deb470b15ba83adbaa1742b6e1bf41c77576`
Upload date	Jan 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/RISE-Maritime/zenoh-cli
Publishing commit: github.com/RISE-Maritime/zenoh-cli/tree/194ee3a0d65f7b996014bb88449156ab63da3e47

Workflow

Publishing configuration: github.com/RISE-Maritime/zenoh-cli/blob/194ee3a0d65f7b996014bb88449156ab63da3e47/.github/workflows/release.yml
Publishing logs: github.com/RISE-Maritime/zenoh-cli/actions/runs/20917529003/attempts/1

Artifact

Subject: zenoh_cli-0.7.0-py3-none-any.whl
SHA-256 checksum: f60539f0b70ccc8af49a8ee19683c32c8cd08c521a54a1ef9a9cf40462c1169a Verifying attestations