---
id: iterative-telemetry
version: "0.0.10"
license: Apache-2.0
license_treatment: permissive
maintenance: aging
---

# iterative-telemetry — Common library for sending telemetry

License: permissive · Maintenance: aging · Downloads: 2.9M/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 2.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

telemetry collection library, anonymized usage tracking, iterative tools telemetry, opt-out telemetry, user analytics sdk, minimal data collection, telemetry client, telemetry, analytics, opt-out

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