User Guide
Epochly User Guide: Telemetry & Privacy
What Epochly collects, how to configure telemetry, and privacy guarantees. No source code or data values are ever collected.
Epochly collects anonymous telemetry to improve the product. **Telemetry is
enabled by default** — set EPOCHLY_DISABLE_TELEMETRY=1 to opt out.
Community Tier: What We Collect
Community telemetry is fully anonymous — no registration, email, or account required.
| Field | Collected | Description |
|---|---|---|
machine_id | Yes | SHA-256 hash stored at ~/.epochly/machine_id — no PII |
| OS type | Yes | Platform support (e.g., linux, darwin, win32) |
| Python version | Yes | Compatibility |
| Epochly version | Yes | Feature usage tracking |
| CPU count | Yes | Resource analysis |
| CPU architecture | Yes | Platform support |
event_type | Yes | Event category |
| IP address | No | Never stored |
| Source code | No | Never collected |
| Data processed | No | Never collected |
| Personal info | No | Never collected |
Behavior:
- Rate-limited: max 1 report per hour per machine
- Fails silently — never impacts Python execution
Disabling Telemetry (Opt-Out)
Environment Variable (Preferred)
export EPOCHLY_DISABLE_TELEMETRY=1
Alternative
export EPOCHLY_TELEMETRY=false
Configuration File
# epochly.yamltelemetry:enabled: false
Runtime API
import epochlyepochly.configure(telemetry=False)
Data Privacy
- No personal data collected (Community tier)
- No IP address logging
- Community machine_id is a SHA-256 hardware hash — not reversible to PII
- Contact privacy@epochly.com for data requests
Offline Mode
Run completely offline:
export EPOCHLY_OFFLINE_MODE=1export EPOCHLY_DISABLE_TELEMETRY=1