computefence 0.2.0__tar.gz → 0.2.1__tar.gz

computefence-0.2.1/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: computefence
+Version: 0.2.1
+Summary: Pre-flight validation for GPU training runs on rented infrastructure
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# ComputeFence
+
+Pre-flight safety gate for ML training jobs on rented GPU compute. Built specifically for RunPod, Vast.ai, Lambda Labs, and similar bare metal providers.
+
+## Install
+
+```bash
+pip install computefence
+```
+
+## Usage
+
+```bash
+computefence doctor
+```
+
+With a dataset:
+
+```bash
+computefence doctor --dataset train.csv --input-column text --label-column label
+```
+
+## Example output
+
+ComputeFence v0.1.2 — Pre-flight diagnostic
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+2 WARNINGS · 0 BLOCKERS · 3 PASSED
+
+Environment
+✓ Python 3.11.4
+✓ PyTorch 2.1.0 detected
+✓ CUDA available — NVIDIA A40
+
+Storage
+⚠ HF_HOME is not set. HuggingFace will use default local cache.
+Fix: Set HF_HOME to a persistent volume path before training
+⚠ No mounted persistent volumes detected at /workspace, /runpod-volume, or /vast
+Fix: Attach a network volume before training to persist checkpoints and cache
+
+Dataset
+✓ No dataset path provided — skipping dataset checks
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+2 warning(s) found. Review before launching.
+
+## What it checks
+
+- **CUDA and GPU visibility** — confirms PyTorch can see the GPU and training will not silently fall back to CPU
+- **HuggingFace cache path** — confirms model files go to persistent storage not ephemeral disk
+- **Accelerate GPU count** — confirms your distributed training config matches the GPUs actually on the instance
+- **Dataset integrity** — optional scan for duplicates, missing values, and conflicting labels
+
+## What it does not check
+
+- Training script correctness
+- Model architecture compatibility
+- Learning rate or hyperparameter safety
+- Runtime monitoring during the job
+- Slow dataloader or data pipeline throughput
+
+## Why this exists
+
+I burned approximately £1,000 on GPU training runs that failed silently. CUDA fell back to CPU with no error. Class weights caused loss collapse to 0.693 immediately. My dataset had 28,432 duplicate rows and 312 conflicting labels I only found after the run.
+
+Nothing existed that caught these before the job started. So I built it.
+
+## Real operator results
+
+David at Neuralic ran ComputeFence on a RunPod A100. It caught HF_HOME writing to /root/.cache and an Accelerate GPU count mismatch. He fixed both before launch.
+
+## GitHub
+
+github.com/Francisco-Booth/ComputeFence
+
+## PyPI
+
+pypi.org/project/computefence

computefence-0.2.1/README.md

@@ -0,0 +1,77 @@
+# ComputeFence
+
+Pre-flight safety gate for ML training jobs on rented GPU compute. Built specifically for RunPod, Vast.ai, Lambda Labs, and similar bare metal providers.
+
+## Install
+
+```bash
+pip install computefence
+```
+
+## Usage
+
+```bash
+computefence doctor
+```
+
+With a dataset:
+
+```bash
+computefence doctor --dataset train.csv --input-column text --label-column label
+```
+
+## Example output
+
+ComputeFence v0.1.2 — Pre-flight diagnostic
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+2 WARNINGS · 0 BLOCKERS · 3 PASSED
+
+Environment
+✓ Python 3.11.4
+✓ PyTorch 2.1.0 detected
+✓ CUDA available — NVIDIA A40
+
+Storage
+⚠ HF_HOME is not set. HuggingFace will use default local cache.
+Fix: Set HF_HOME to a persistent volume path before training
+⚠ No mounted persistent volumes detected at /workspace, /runpod-volume, or /vast
+Fix: Attach a network volume before training to persist checkpoints and cache
+
+Dataset
+✓ No dataset path provided — skipping dataset checks
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+2 warning(s) found. Review before launching.
+
+## What it checks
+
+- **CUDA and GPU visibility** — confirms PyTorch can see the GPU and training will not silently fall back to CPU
+- **HuggingFace cache path** — confirms model files go to persistent storage not ephemeral disk
+- **Accelerate GPU count** — confirms your distributed training config matches the GPUs actually on the instance
+- **Dataset integrity** — optional scan for duplicates, missing values, and conflicting labels
+
+## What it does not check
+
+- Training script correctness
+- Model architecture compatibility
+- Learning rate or hyperparameter safety
+- Runtime monitoring during the job
+- Slow dataloader or data pipeline throughput
+
+## Why this exists
+
+I burned approximately £1,000 on GPU training runs that failed silently. CUDA fell back to CPU with no error. Class weights caused loss collapse to 0.693 immediately. My dataset had 28,432 duplicate rows and 312 conflicting labels I only found after the run.
+
+Nothing existed that caught these before the job started. So I built it.
+
+## Real operator results
+
+David at Neuralic ran ComputeFence on a RunPod A100. It caught HF_HOME writing to /root/.cache and an Accelerate GPU count mismatch. He fixed both before launch.
+
+## GitHub
+
+github.com/Francisco-Booth/ComputeFence
+
+## PyPI
+
+pypi.org/project/computefence

computefence-0.2.1/computefence/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.1"

{computefence-0.2.0 → computefence-0.2.1}/computefence/cli.py

@@ -1,19 +1,17 @@
 import sys
 from rich.console import Console
-
 from computefence import __version__
 from computefence.checks.environment import check_environment
 from computefence.checks.storage import check_disk_headroom, check_storage
 from computefence.checks.dataset import check_dataset
+from computefence.telemetry import record_run
 
 console = Console()
 
-
 def print_result(result):
     status = result.get("status")
     message = result.get("message")
     fix = result.get("fix")
-
     if status == "pass":
         console.print(f"  [green]✓[/green] {message}")
     elif status == "warn":
@@ -25,12 +23,10 @@ def print_result(result):
         if fix:
             console.print(f"    [dim]Fix: {fix}[/dim]")
 
-
 def doctor():
     dataset = None
     input_column = None
     label_column = None
-
     args = sys.argv[1:]
     i = 0
     while i < len(args):
@@ -50,8 +46,6 @@ def doctor():
     console.print(f"[bold]ComputeFence v{__version__} — Pre-flight diagnostic[/bold]")
     console.print("━" * 50)
 
-    # Run every check up front so the verdict line can be counted and printed
-    # above the individual results.
     env_results = check_environment()
     storage_results = check_storage() + check_disk_headroom()
     dataset_results = check_dataset(
@@ -61,6 +55,9 @@ def doctor():
     )
 
     all_results = env_results + storage_results + dataset_results
+
+    record_run(all_results)
+
     failures = [r for r in all_results if r["status"] == "fail"]
     warnings = [r for r in all_results if r["status"] == "warn"]
     passed = [r for r in all_results if r["status"] == "pass"]
@@ -71,35 +68,32 @@ def doctor():
         f"[red]{len(failures)} BLOCKERS[/red]  ·  "
         f"[green]{len(passed)} PASSED[/green]"
     )
-
     console.print()
     console.print("[bold blue]Environment[/bold blue]")
     for result in env_results:
         print_result(result)
-
     console.print()
     console.print("[bold blue]Storage[/bold blue]")
     for result in storage_results:
         print_result(result)
-
     console.print()
     console.print("[bold blue]Dataset[/bold blue]")
     for result in dataset_results:
         print_result(result)
-
     console.print()
     console.print("━" * 50)
-
     if failures:
         console.print("[red]" + str(len(failures)) + " error(s) and " + str(len(warnings)) + " warning(s) found. Fix errors before launching.[/red]")
     elif warnings:
         console.print("[yellow]" + str(len(warnings)) + " warning(s) found. Review before launching.[/yellow]")
     else:
         console.print("[green]All checks passed. Safe to launch.[/green]")
-
+    console.print(
+        "[dim]Anonymous usage stats help improve ComputeFence. "
+        "Opt out: touch ~/.computefence_no_telemetry[/dim]"
+    )
     console.print()
 
-
 def main():
     args = sys.argv[1:]
     if not args or args[0] == "doctor":
@@ -108,6 +102,5 @@ def main():
         console.print(f"[red]Unknown command: {args[0]}[/red]")
         console.print("Usage: computefence doctor")
 
-
 if __name__ == "__main__":
     main()

computefence-0.2.1/computefence/telemetry.py

@@ -0,0 +1,64 @@
+import hashlib
+import platform
+import sys
+import threading
+import uuid
+from pathlib import Path
+
+SUPABASE_URL = "https://pidpadpudbcdldyvrlog.supabase.co"
+SUPABASE_ANON_KEY = "sb_publishable_A2zwbfTFiOs63jz8313GXg_elw3F5dy"
+TABLE = "computefence_runs"
+OPT_OUT_FILE = Path.home() / ".computefence_no_telemetry"
+
+
+def _is_opted_out():
+    return OPT_OUT_FILE.exists()
+
+
+def _send(payload: dict):
+    try:
+        import requests
+        requests.post(
+            f"{SUPABASE_URL}/rest/v1/{TABLE}",
+            headers={
+                "apikey": SUPABASE_ANON_KEY,
+                "Authorization": f"Bearer {SUPABASE_ANON_KEY}",
+                "Content-Type": "application/json",
+                "Prefer": "return=minimal",
+            },
+            json=payload,
+            timeout=3,
+        )
+    except Exception:
+        pass
+
+
+def record_run(results: list):
+    if _is_opted_out():
+        return
+
+    warning_count = sum(1 for r in results if r.get("status") == "warn")
+    blocker_count = sum(1 for r in results if r.get("status") == "fail")
+    pass_count = sum(1 for r in results if r.get("status") == "pass")
+
+    try:
+        import torch
+        gpu_count = torch.cuda.device_count()
+    except Exception:
+        gpu_count = 0
+
+    from computefence import __version__
+
+    payload = {
+        "version": __version__,
+        "python_version": f"{sys.version_info.major}.{sys.version_info.minor}",
+        "platform": platform.system(),
+        "gpu_count": gpu_count,
+        "warning_count": warning_count,
+        "blocker_count": blocker_count,
+        "pass_count": pass_count,
+        "opted_in": True,
+    }
+
+    thread = threading.Thread(target=_send, args=(payload,), daemon=True)
+    thread.start()

computefence-0.2.1/computefence.egg-info/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: computefence
+Version: 0.2.1
+Summary: Pre-flight validation for GPU training runs on rented infrastructure
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# ComputeFence
+
+Pre-flight safety gate for ML training jobs on rented GPU compute. Built specifically for RunPod, Vast.ai, Lambda Labs, and similar bare metal providers.
+
+## Install
+
+```bash
+pip install computefence
+```
+
+## Usage
+
+```bash
+computefence doctor
+```
+
+With a dataset:
+
+```bash
+computefence doctor --dataset train.csv --input-column text --label-column label
+```
+
+## Example output
+
+ComputeFence v0.1.2 — Pre-flight diagnostic
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+2 WARNINGS · 0 BLOCKERS · 3 PASSED
+
+Environment
+✓ Python 3.11.4
+✓ PyTorch 2.1.0 detected
+✓ CUDA available — NVIDIA A40
+
+Storage
+⚠ HF_HOME is not set. HuggingFace will use default local cache.
+Fix: Set HF_HOME to a persistent volume path before training
+⚠ No mounted persistent volumes detected at /workspace, /runpod-volume, or /vast
+Fix: Attach a network volume before training to persist checkpoints and cache
+
+Dataset
+✓ No dataset path provided — skipping dataset checks
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+2 warning(s) found. Review before launching.
+
+## What it checks
+
+- **CUDA and GPU visibility** — confirms PyTorch can see the GPU and training will not silently fall back to CPU
+- **HuggingFace cache path** — confirms model files go to persistent storage not ephemeral disk
+- **Accelerate GPU count** — confirms your distributed training config matches the GPUs actually on the instance
+- **Dataset integrity** — optional scan for duplicates, missing values, and conflicting labels
+
+## What it does not check
+
+- Training script correctness
+- Model architecture compatibility
+- Learning rate or hyperparameter safety
+- Runtime monitoring during the job
+- Slow dataloader or data pipeline throughput
+
+## Why this exists
+
+I burned approximately £1,000 on GPU training runs that failed silently. CUDA fell back to CPU with no error. Class weights caused loss collapse to 0.693 immediately. My dataset had 28,432 duplicate rows and 312 conflicting labels I only found after the run.
+
+Nothing existed that caught these before the job started. So I built it.
+
+## Real operator results
+
+David at Neuralic ran ComputeFence on a RunPod A100. It caught HF_HOME writing to /root/.cache and an Accelerate GPU count mismatch. He fixed both before launch.
+
+## GitHub
+
+github.com/Francisco-Booth/ComputeFence
+
+## PyPI
+
+pypi.org/project/computefence

{computefence-0.2.0 → computefence-0.2.1}/computefence.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 computefence/__init__.py
 computefence/cli.py
+computefence/telemetry.py
 computefence.egg-info/PKG-INFO
 computefence.egg-info/SOURCES.txt
 computefence.egg-info/dependency_links.txt

computefence-0.2.0/PKG-INFO

@@ -1,49 +0,0 @@
-Metadata-Version: 2.4
-Name: computefence
-Version: 0.2.0
-Summary: Pre-flight validation for GPU training runs on rented infrastructure
-License-Expression: MIT
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rich>=13.0.0
-Requires-Dist: pandas>=1.5.0
-Requires-Dist: typer>=0.9.0
-Requires-Dist: requests>=2.28.0
-Dynamic: license-file
-
-# ComputeFence
-
-Pre-flight validation for GPU training runs on rented infrastructure.
-Built specifically for RunPod, Vast.ai, Lambda, and similar providers.
-
-## Install
-
-pip install computefence
-
-## Usage
-
-computefence doctor
-computefence doctor --dataset train.csv
-
-## What it checks
-
-- CUDA and GPU availability
-- HuggingFace cache volume path (catches the RunPod /root vs /workspace conflict)
-- Accelerate GPU count vs config
-- Dataset duplicates and missing values
-
-## What it does not yet check
-
-- Training script correctness
-- Model architecture compatibility
-- Learning rate or hyperparameter safety
-- Runtime monitoring during the job
-
-## Why this exists
-
-I burned ~£1,000 on GPU training runs that failed silently. CUDA fell back to 
-CPU with no error. Class weights caused loss collapse. My dataset had 28,432 
-duplicate rows and 312 conflicting labels I only found during the rebuild.
-
-Nothing existed that caught these before the job started. So I built it.

computefence-0.2.0/README.md

@@ -1,35 +0,0 @@
-# ComputeFence
-
-Pre-flight validation for GPU training runs on rented infrastructure.
-Built specifically for RunPod, Vast.ai, Lambda, and similar providers.
-
-## Install
-
-pip install computefence
-
-## Usage
-
-computefence doctor
-computefence doctor --dataset train.csv
-
-## What it checks
-
-- CUDA and GPU availability
-- HuggingFace cache volume path (catches the RunPod /root vs /workspace conflict)
-- Accelerate GPU count vs config
-- Dataset duplicates and missing values
-
-## What it does not yet check
-
-- Training script correctness
-- Model architecture compatibility
-- Learning rate or hyperparameter safety
-- Runtime monitoring during the job
-
-## Why this exists
-
-I burned ~£1,000 on GPU training runs that failed silently. CUDA fell back to 
-CPU with no error. Class weights caused loss collapse. My dataset had 28,432 
-duplicate rows and 312 conflicting labels I only found during the rebuild.
-
-Nothing existed that caught these before the job started. So I built it.

computefence-0.2.0/computefence/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.0"

computefence-0.2.0/computefence.egg-info/PKG-INFO

@@ -1,49 +0,0 @@
-Metadata-Version: 2.4
-Name: computefence
-Version: 0.2.0
-Summary: Pre-flight validation for GPU training runs on rented infrastructure
-License-Expression: MIT
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rich>=13.0.0
-Requires-Dist: pandas>=1.5.0
-Requires-Dist: typer>=0.9.0
-Requires-Dist: requests>=2.28.0
-Dynamic: license-file
-
-# ComputeFence
-
-Pre-flight validation for GPU training runs on rented infrastructure.
-Built specifically for RunPod, Vast.ai, Lambda, and similar providers.
-
-## Install
-
-pip install computefence
-
-## Usage
-
-computefence doctor
-computefence doctor --dataset train.csv
-
-## What it checks
-
-- CUDA and GPU availability
-- HuggingFace cache volume path (catches the RunPod /root vs /workspace conflict)
-- Accelerate GPU count vs config
-- Dataset duplicates and missing values
-
-## What it does not yet check
-
-- Training script correctness
-- Model architecture compatibility
-- Learning rate or hyperparameter safety
-- Runtime monitoring during the job
-
-## Why this exists
-
-I burned ~£1,000 on GPU training runs that failed silently. CUDA fell back to 
-CPU with no error. Class weights caused loss collapse. My dataset had 28,432 
-duplicate rows and 312 conflicting labels I only found during the rebuild.
-
-Nothing existed that caught these before the job started. So I built it.