lookingeye 0.1.0

Substrate-specific operational verdicts for Hugging Face Spaces — detect ZeroGPU silent-fails, worker errors, and quota burn that HF won't tell you about.

lookingeye

Substrate-specific operational verdicts for Hugging Face Spaces — detects the runtime failures that HF won't tell you about: ZeroGPU silent worker errors, async deadlocks, quota burn on requests that produced no output.

Install

pipx install lookingeye

Or with pip:

pip install lookingeye

Quickstart

lookingeye --version
lookingeye verify owner/your-hf-model

The first run prints a SHAPE-valid lookingeye-report.json for the model and writes it to ./.lookingeye/<model_id>-<timestamp>.json.

Telemetry (opt-in)

lookingeye never sends telemetry unless you opt in. To enable:

lookingeye --opt-in

You'll be prompted for an email. We SHA-256 the email locally and only send the hash plus the CLI version + invocation event. No model contents, no source code, no raw PII ever leaves your machine.

To revoke:

lookingeye --opt-out

State is stored at ~/.config/lookingeye/state.json (override with LOOKINGEYE_STATE_DIR).

Privacy

Telemetry is governed by .lookingeye/PRIVACY.md in this repository. The SaaS endpoint that receives pings is https://lookingeye.draftlabs.org/api/cli/ping and is documented in experiment/EVENTS.yaml.