---
id: scarf-sdk
version: "0.2.1"
license: unclear
license_treatment: unclear
maintenance: aging
---

# scarf-sdk — Python bindings for Scarf telemetry

License: unclear · Maintenance: aging · Downloads: 165.0K/mo

## What it is and what it does

scarf-sdk is a lightweight Python client for sending telemetry events to a Scarf endpoint. It wraps HTTP requests to a configurable endpoint, accepting JSON payloads with arbitrary event data and supporting nested structures. The client depends only on requests and provides a simple ScarfEventLogger class that accepts an endpoint URL and optional timeout, then logs events via a log_event() method that returns success/failure status.

The package is designed for integration into other tools or libraries that want to send usage telemetry. It respects user privacy settings via DO_NOT_TRACK and SCARF_NO_ANALYTICS environment variables, and supports verbose logging for debugging. Timeouts are configurable both at initialization (default 3 seconds) and per-call, allowing flexibility in network conditions.

Use it for:

- Track package downloads or installations by logging events when your package is installed or used.
- Send custom telemetry from a CLI tool to understand user behavior and feature adoption.
- Monitor application usage patterns by logging events at key points in your application flow.
- Debug telemetry integration with verbose logging mode to verify events are reaching the endpoint.

## Worth the install?

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

A Python client for sending telemetry events to a Scarf endpoint via JSON payloads, with support for configurable timeouts and Do Not Track settings.

Yes, if you have a Scarf endpoint and need a minimal telemetry client. The package is simple, has low install friction, and respects privacy settings. However, the aging maintenance status (4 stars, no recent releases) and unclear license metadata warrant caution in production—verify the Apache 2.0 license is actually applied and consider whether the project's low activity level is acceptable for your use case.

## Install

pip install scarf-sdk
uv add scarf-sdk
poetry add scarf-sdk

## Installing scarf-sdk

Before you install: Low install friction with a single runtime dependency (requests). Maintenance status is aging—the repository has 4 stars, last commit on 2026-01-07, and no releases since 2025-12-31, so expect slower response to issues or updates.

License in practice: License treatment is unclear: no SPDX identifier or raw license string is recorded in the package metadata, despite the description mentioning Apache 2.0. Verify the actual license terms before use in proprietary or restricted contexts.

Quickstart:

pip install scarf-sdk

from scarf import ScarfEventLogger

logger = ScarfEventLogger(endpoint_url="https://your-endpoint.com")
success = logger.log_event({"event": "test", "data": "value"})

Requires Python >=3.7 and a reachable Scarf endpoint URL to initialize the logger.

Verify before relying:

- Whether the Apache 2.0 license mentioned in the description is actually enforced in the package metadata or if there is a mismatch.
- Whether the aging maintenance status and low star count indicate active community use or potential abandonment.
- Whether the package respects Do Not Track and SCARF_NO_ANALYTICS environment variables reliably in production.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 165.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

telemetry event logging, scarf analytics client, json event tracking, telemetry sdk python, analytics event sender, scarf telemetry, event logging api, telemetry, analytics, event-logging

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