iterative-telemetry

What it is and what it does

Iterative Telemetry is a shared library that collects and sends anonymized usage data from Iterative tools. It gathers minimal information—tool name, version, OS details, and a persistent anonymized user ID—and transmits it via HTTP requests. The package is designed to be unobtrusive: users can disable all telemetry collection across all Iterative projects by setting the ITERATIVE_DO_NOT_TRACK environment variable.

The library depends on requests for HTTP communication, appdirs for platform-specific data directories, filelock for safe concurrent access, and distro for OS detection. It supports Python 3.8 through 3.11 and is distributed under the Apache 2.0 license. While maintenance is aging (no release in 549 days), the repository remains active.

Use it for:

• Embed in Iterative tools to collect anonymous usage patterns and inform product development decisions
• Track adoption and feature usage across a suite of related command-line or programmatic tools
• Maintain a consistent user identity across multiple Iterative projects without storing personally identifiable information
• Allow users to opt out of all telemetry collection via a single environment variable across all dependent tools

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Sends anonymized telemetry data from Iterative tools, collecting minimal usage information like tool name, version, OS details, and a persistent user ID that can be disabled via environment variable.

Yes, if you are building or maintaining an Iterative tool and need a lightweight, opt-out-friendly telemetry layer. The package is permissively licensed, has low install friction, and collects only minimal anonymized data. The aging maintenance status is a minor concern but not a blocker given the stable, narrow scope of the library.

Install

iterative-telemetry on PyPI

pip install iterative-telemetry

uv add iterative-telemetry

poetry add iterative-telemetry

Installing iterative-telemetry

Before you install

Low install friction with a pure Python wheel and four lightweight runtime dependencies. Maintenance is aging—549 days since last release—but the repository remains active with a recent commit in December 2025.

License in practice

Apache 2.0 permissive license means you can use, modify, and redistribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install iterative-telemetry

from iterative_telemetry import send_telemetry

send_telemetry(tool_name='my_tool', tool_version='1.0.0')

Requires Python 3.8 or later; telemetry is disabled if ITERATIVE_DO_NOT_TRACK=1 environment variable is set.

Verify before relying

• Exact API surface and method signatures for sending telemetry events beyond the basic example shown
• Whether the package handles network failures or offline scenarios gracefully
• Performance impact of telemetry collection on host applications

Package facts

Evidence: iterative_telemetry-0.0.10-py3-none-any.whl

Tags

More Monitoring packages