---
id: etelemetry
version: "0.3.1"
license: Apache License, 2.0
license_treatment: permissive
maintenance: dormant
---

# etelemetry — Etelemetry python client API

License: permissive · Maintenance: dormant · Downloads: 511.8K/mo

## What it is and what it does

Etelemetry is a client library for communicating with a remote telemetry server to fetch project metadata, specifically current version numbers and lists of known bad versions. It is designed to be embedded in other Python projects so they can notify users at runtime if they are running an outdated or problematic release.

The package provides two main entry points: `get_project()` to retrieve raw version data for a project identified by its GitHub organization and name (e.g., "nipy/nipype"), and `check_available_version()` to compare a user's current version against the remote record and print human-readable warnings if an update is available or if the version is flagged as buggy. Projects that adopt etelemetry typically call it on import in interactive environments (notebooks, REPLs) to alert users without disrupting normal execution.

Use it for:

- Embed in a scientific Python package to notify users of critical bug-fix releases at import time.
- Check for deprecated versions in a Jupyter notebook or IPython session to warn about known issues.
- Query the etelemetry server in a CI/CD pipeline to validate that a deployed version is not on a blocklist.
- Build a version-monitoring dashboard that polls etelemetry for multiple projects to track adoption and flag problems.
- Integrate into a package manager or installer to warn users before installing a known-bad release.

## Worth the install?

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

Etelemetry is a lightweight Python client that queries a remote server for project version information and checks whether the current version is outdated or flagged as problematic.

Yes, if you maintain a Python package and want a lightweight, zero-configuration way to notify users of critical updates or known bugs at runtime. The permissive license and low dependency footprint make it easy to embed. However, be aware the package is dormant (last release over a year ago) and the remote server's availability and long-term support are not documented; verify the etelemetry infrastructure is stable for your use case before relying on it in production.

## Install

pip install etelemetry
uv add etelemetry
poetry add etelemetry

## Installing etelemetry

Before you install: Low install friction with three lightweight dependencies (packaging, requests, ci-info). The package is dormant—last release was 2023-10-13, over a year ago—but the repository remains active and there are no known security vulnerabilities.

License in practice: Licensed under Apache License 2.0 (permissive), which allows commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install etelemetry

import etelemetry
result = etelemetry.get_project("nipy/nipype")
print(result)  # {'version': '1.4.2', 'bad_versions': [...]}

# Or check current version against remote:
etelemetry.check_available_version("nipy/nipype", "1.2.1")

Requires Python 3.7 or later. The remote server must be accessible and the target project must be registered with etelemetry.

Verify before relying:

- Whether the etelemetry server is actively maintained and reliably available for queries.
- Performance characteristics when querying many projects or in high-frequency scenarios.
- Whether the package works with private or self-hosted version registries.

## Package facts

- License: Apache License, 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 511.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

version checking client, project telemetry, remote version lookup, bad version detection, update notification, github project version info, deprecation warnings, version-checking, telemetry-client, scientific-python

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