Metadata-Version: 2.4
Name: sunchar-core
Version: 0.1.0
Summary: Lightweight, carbon-aware batch compute scheduler and UK National Grid telemetry engine
Author-email: Emmanuel Sunday <sonexis7@gmail.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/Sonexis7/sunchar-core
Project-URL: Repository, https://github.com/Sonexis7/sunchar-core.git
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0

﻿# greenops-client

Autonomous carbon-aware compute scheduling and Scope 2 audit ledger for enterprise data pipelines.

## Installation

bash
pip install greenops-client


## Quickstart

python
from greenops import GreenOpsClient

client = GreenOpsClient(api_key="gop_live_your_key_here")

@client.gate(
    job_name="nightly-batch-risk",
    cluster_power_kw=50.0,
    runtime_hours=2.0,
    max_wait_seconds=1800,
    force_on_timeout=True
)
def run_pipeline():
    print("Executing workload under optimal grid conditions...")

## Features
- **Active Gating:** Delays non-urgent compute until renewable power floods the grid.
- **SLA Fallback:** `force_on_timeout=True` guarantees execution if windows do not clear within buffer.
- **Scope 2 Ledger:** Writes microsecond-level grid audit records to MotherDuck automatically.
