Metadata-Version: 2.4
Name: lookingeye
Version: 0.2.0
Summary: Substrate-specific operational verdicts for Hugging Face Spaces — detect ZeroGPU silent-fails, worker errors, and quota burn that HF won't tell you about.
Author: LookingEye
License: Apache-2.0
Project-URL: Homepage, https://lookingeye.draftlabs.org
Keywords: huggingface,verdict,zerogpu,sigstore,lookingeye
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-cov>=5; extra == "dev"

# 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`.
