client_python is the official Prometheus instrumentation library for Python applications, letting Python code expose metrics that a Prometheus server collects, and it is aimed at Python developers and reliability engineers who need their services measurable inside a Prometheus monitoring stack.

What it is

client_python is the official Python client maintained under the Prometheus project on GitHub. It is written in Python, licensed under Apache-2.0, and carries the topics instrumentation, metrics, prometheus, and python, which places it in the Infrastructure & Operations / Monitoring & Observability category of this registry. The repository has 4,375 stars, 876 forks, and 150 open issues, with the most recent push recorded on 2026-09-15. Its purpose is instrumentation: adding the code that produces metrics from inside a running Python process rather than measuring it from outside.

The concrete problem it solves is that a Python application has no built-in way to report its own operational state to Prometheus. Without a client library, a team has to hand-roll its own metrics plumbing and its own export format, which is exactly the kind of application-specific work this library removes. Instead of writing bespoke instrumentation per service, developers install the official client and emit metrics through an interface that the Prometheus ecosystem already understands. The README frames the library as the official client for Prometheus and points to a separate documentation site and to PyPI as the distribution channel.

Key capabilities

• Provides Prometheus instrumentation for Python applications, as stated in the repository description and the telemetry topic list.
• Installs from PyPI with the package name prometheus-client using pip install prometheus-client.
• Is published on PyPI as prometheus_client at https://pypi.python.org/pypi/prometheus_client.
• Ships as the official client for Prometheus rather than a third-party reimplementation, per the README.
• Maintains documentation at https://prometheus.github.io/client_python, separate from the repository README.
• Uses the GitHub Releases page as its changelog and release history.
• Carries Apache-2.0 licensing, which permits use and redistribution under those terms.

Who uses it and how

• Python service teams that need their applications to publish metrics into an existing Prometheus deployment.
• Observability and platform engineers who standardise on the official Prometheus client rather than community forks.
• Developers already inside the Prometheus ecosystem who want instrumentation consistent with the server and other official clients.
• Maintainers who track upgrades through the Releases page, which the README describes as the project history and changelog.

Getting started

Install from PyPI with pip install prometheus-client, then follow the usage documentation at https://prometheus.github.io/client_python. No Docker image, compose file, or hosted option is described in the README.

How it compares

The facts provide no list of paid products this project replaces, and no competing Python metrics libraries are named either, so on the evidence available it stands alone in this registry: the official Prometheus client for Python, distributed freely under Apache-2.0.

When to use it — and when not to

This is a client library, so there is no database, storage layer, or mail service to operate; the operational dependency is a Prometheus server somewhere that scrapes the metrics it emits, and without one the instrumentation produces nothing useful. Teams not running Prometheus, or running a different metrics backend, should look elsewhere rather than adopt it for compatibility reasons alone. The honest weakness here is documentation depth in the repository itself: the README excerpt is sparse, offers no usage example, and defers nearly everything to the external docs site, so the registry entry alone is not enough to get a service instrumented.

pip install prometheus-client