---
id: pygnmi
version: "0.8.15"
license: bsd-3-clause
license_treatment: permissive
maintenance: aging
---

# pygnmi — Pure Python gNMI client to manage network functions and collect telemetry.

License: permissive · Maintenance: aging · Downloads: 169.6K/mo

## What it is and what it does

pyGNMI is a pure Python implementation of the gNMI (gRPC Network Management Interface) client protocol, used to interact with network devices that expose a gNMI service. It abstracts the gRPC and Protocol Buffer complexity, allowing developers to query device state, push configuration changes, and stream telemetry subscriptions using Python code. The package handles both insecure and secure gRPC channels, automatic encoding detection, and supports all standard gNMI RPCs: Capabilities, Get, Set, and Subscribe.

The package targets network engineers and automation developers working with devices from Arista, Nokia, Cisco, Juniper, and others that implement the gNMI standard. It depends on grpcio, protobuf, cryptography, and dictdiffer to manage gRPC transport, message serialization, TLS encryption, and change tracking. The library includes a command-line tool for ad-hoc device queries and integrates with Nornir for multi-device orchestration workflows.

Use it for:

- Query operational state and configuration from network devices using OpenConfig YANG paths in a Python script.
- Push configuration changes to multiple network devices with atomic Set operations and change tracking.
- Build telemetry collectors that subscribe to device metrics and stream them to monitoring systems.
- Automate network device management tasks via Nornir inventory without writing raw gRPC code.
- Verify device capabilities and automatically select the correct encoding for cross-platform compatibility.

## Worth the install?

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

Pure Python gNMI client for querying and configuring network devices via gRPC, supporting capabilities, get, set, and subscribe operations across multiple network operating systems.

Yes, if you need to automate or query gNMI-capable network devices. The package is production-stable with a permissive license and low install friction. However, the 522-day release gap suggests it is no longer actively maintained—suitable for stable deployments but not for projects requiring active bug fixes or new feature development.

## Install

pip install pygnmi
uv add pygnmi
poetry add pygnmi

## Installing pygnmi

Before you install: Low install friction with pure Python wheels. Maintenance is aging—no release for 522 days despite an active repository with recent commits, suggesting the package is stable but not actively developed.

License in practice: BSD 3-Clause permissive license allows commercial and private use with minimal restrictions, making it suitable for most deployment contexts.

Quickstart:

from pygnmi.client import gNMIclient

with gNMIclient(target=('169.254.255.64', '57400'), username='admin', password='admin', insecure=True) as gc:
    result = gc.get(path=['openconfig-interfaces:interfaces'])
    print(result)

Target device must expose a gNMI service on the specified host and port; requires valid credentials or certificate-based authentication.

Verify before relying:

- Whether the 522-day gap since last release indicates the package is feature-complete or gradually abandoned.
- Support status for Python versions beyond 3.11 listed in classifiers.
- Whether Nornir integration mentioned in description is maintained and documented.

## Package facts

- License: bsd-3-clause (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 169.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gnmi client python, network device management grpc, openconfig telemetry collection, network automation gnmi, grpc network configuration, telemetry subscription network, network device query python, network-automation, grpc-client, telemetry

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