greenpick 0.1.0__tar.gz → 0.1.2__tar.gz

{greenpick-0.1.0/src/greenpick.egg-info → greenpick-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greenpick
-Version: 0.1.0
+Version: 0.1.2
 Summary: Design-time sustainability co-pilot (MCP server): greener, cheaper cloud infrastructure decisions with carbon + cost + latency tradeoffs.
 Author-email: "Data Science Advisers, LLC" <info@datascienceadvisers.com>
 License-Expression: MIT
@@ -29,7 +29,7 @@ Requires-Dist: ijson>=3.0; extra == "dev"
 Dynamic: license-file
 
 <p align="center">
-  <img src="docs/img/logo.svg" alt="GreenPick logo — a leaf whose veins are circuit traces" width="120" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/logo.svg" alt="GreenPick logo — a leaf whose veins are circuit traces" width="120" />
 </p>
 
 <h1 align="center">GreenPick</h1>
@@ -58,7 +58,7 @@ seconds. (It responds when you ask; auto-nudging on infra-code changes is on the
 > checks — all shipped. Falls back to clearly-labelled mock data offline or without API keys.
 
 <p align="center">
-  <img src="docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
 </p>
 
 *The same 40-GPU-hour training run emits ~0.7 kg CO₂ in Stockholm vs ~19 kg in Sydney — a ~30×
@@ -227,11 +227,50 @@ pytest                          # run tests
 Connect it to an MCP client (e.g. Kiro / Claude Code / Cursor) by pointing the client at
 `python -m greenpick` in this directory. See `.env.example` for switching the data source.
 
+### Turn on live data
+
+GreenPick runs on labelled mock data until you give it two free keys:
+[EIA](https://www.eia.gov/opendata/register.php) (US grid) and
+[ENTSO-E](https://transparency.entsoe.eu/) (EU grid). Pass them as environment variables.
+(A `.env` file works for a source checkout; if you installed with `pip install greenpick`, use one
+of the options below.)
+
+**In an MCP client** (Kiro, Claude Desktop, Cursor…), add an `env` block to the server entry:
+
+```json
+{
+  "mcpServers": {
+    "greenpick": {
+      "command": "python",
+      "args": ["-m", "greenpick"],
+      "env": {
+        "GREENPICK_CARBON_SOURCE": "auto",
+        "EIA_API_KEY": "your-eia-key",
+        "ENTSOE_TOKEN": "your-entsoe-token"
+      }
+    }
+  }
+}
+```
+
+**In a Jupyter notebook or Python script**, set them before you start (or import) the server:
+
+```python
+import os
+os.environ["GREENPICK_CARBON_SOURCE"] = "auto"
+os.environ["EIA_API_KEY"] = "your-eia-key"
+os.environ["ENTSOE_TOKEN"] = "your-entsoe-token"
+```
+
+Every carbon figure includes a `quality` field: `live` means real grid data, `mock` means a
+fallback value. Check it to confirm live data is on.
+
 ## FAQ
 
 **Do I need API keys?** No — GreenPick runs on clearly-labelled mock data out of the box. For *live*
-carbon, set two free keys in `.env` (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
-`GREENPICK_CARBON_SOURCE=auto`. Without them it still works; it just says `quality: "mock"`.
+carbon, set two free keys (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
+`GREENPICK_CARBON_SOURCE=auto` — see [Turn on live data](#turn-on-live-data). Without them it still
+works; it just says `quality: "mock"`.
 
 **Why "directional" and not audited numbers?** Because it's for a *design-time decision*, not a
 compliance report. "Stockholm is ~30× cleaner than Sydney" is what you need to pick a region in

{greenpick-0.1.0 → greenpick-0.1.2}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="docs/img/logo.svg" alt="GreenPick logo — a leaf whose veins are circuit traces" width="120" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/logo.svg" alt="GreenPick logo — a leaf whose veins are circuit traces" width="120" />
 </p>
 
 <h1 align="center">GreenPick</h1>
@@ -28,7 +28,7 @@ seconds. (It responds when you ask; auto-nudging on infra-code changes is on the
 > checks — all shipped. Falls back to clearly-labelled mock data offline or without API keys.
 
 <p align="center">
-  <img src="docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
 </p>
 
 *The same 40-GPU-hour training run emits ~0.7 kg CO₂ in Stockholm vs ~19 kg in Sydney — a ~30×
@@ -197,11 +197,50 @@ pytest                          # run tests
 Connect it to an MCP client (e.g. Kiro / Claude Code / Cursor) by pointing the client at
 `python -m greenpick` in this directory. See `.env.example` for switching the data source.
 
+### Turn on live data
+
+GreenPick runs on labelled mock data until you give it two free keys:
+[EIA](https://www.eia.gov/opendata/register.php) (US grid) and
+[ENTSO-E](https://transparency.entsoe.eu/) (EU grid). Pass them as environment variables.
+(A `.env` file works for a source checkout; if you installed with `pip install greenpick`, use one
+of the options below.)
+
+**In an MCP client** (Kiro, Claude Desktop, Cursor…), add an `env` block to the server entry:
+
+```json
+{
+  "mcpServers": {
+    "greenpick": {
+      "command": "python",
+      "args": ["-m", "greenpick"],
+      "env": {
+        "GREENPICK_CARBON_SOURCE": "auto",
+        "EIA_API_KEY": "your-eia-key",
+        "ENTSOE_TOKEN": "your-entsoe-token"
+      }
+    }
+  }
+}
+```
+
+**In a Jupyter notebook or Python script**, set them before you start (or import) the server:
+
+```python
+import os
+os.environ["GREENPICK_CARBON_SOURCE"] = "auto"
+os.environ["EIA_API_KEY"] = "your-eia-key"
+os.environ["ENTSOE_TOKEN"] = "your-entsoe-token"
+```
+
+Every carbon figure includes a `quality` field: `live` means real grid data, `mock` means a
+fallback value. Check it to confirm live data is on.
+
 ## FAQ
 
 **Do I need API keys?** No — GreenPick runs on clearly-labelled mock data out of the box. For *live*
-carbon, set two free keys in `.env` (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
-`GREENPICK_CARBON_SOURCE=auto`. Without them it still works; it just says `quality: "mock"`.
+carbon, set two free keys (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
+`GREENPICK_CARBON_SOURCE=auto` — see [Turn on live data](#turn-on-live-data). Without them it still
+works; it just says `quality: "mock"`.
 
 **Why "directional" and not audited numbers?** Because it's for a *design-time decision*, not a
 compliance report. "Stockholm is ~30× cleaner than Sydney" is what you need to pick a region in

{greenpick-0.1.0 → greenpick-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "greenpick"
-version = "0.1.0"
+version = "0.1.2"
 description = "Design-time sustainability co-pilot (MCP server): greener, cheaper cloud infrastructure decisions with carbon + cost + latency tradeoffs."
 readme = "README.md"
 requires-python = ">=3.11"

{greenpick-0.1.0 → greenpick-0.1.2}/src/greenpick/__init__.py

@@ -4,4 +4,4 @@ Greener cloud-region choices with honest carbon + cost + latency tradeoffs,
 delivered inside the vibe-coding loop. Directional guidance, not audited accounting.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"

{greenpick-0.1.0 → greenpick-0.1.2}/src/greenpick/server.py

@@ -345,5 +345,5 @@ def explain_methodology_and_limits() -> dict:
         "forecast": "Day-ahead forecast is RELATIVE: upcoming hours ranked by forecast wind+solar output (ENTSO-E A69), not an absolute gCO2/kWh forecast. EU only; US/uncovered zones degrade to the recent historical pattern (labelled 'historical').",
         "data_residency": "GreenPick flags when a recommended move CROSSES a jurisdiction (esp. leaving the EEA) as a geographic heads-up only. It does NOT assess legal/GDPR compliance, does not encode adequacy decisions, and is not legal advice — confirm with your own data governance.",
         "ignored": "Embodied/hardware carbon and provider renewable-energy certificates.",
-        "data_sources": "Electricity Maps free tier (primary); ENTSO-E / EIA / NESO fallbacks; annual averages offline.",
+        "data_sources": "GREENPICK_CARBON_SOURCE=auto routes US regions to EIA-930 and EU regions to ENTSO-E (both free, live); other regions, or any region without a key, use clearly-labelled mock data. Electricity Maps is available when selected explicitly (GREENPICK_CARBON_SOURCE=electricitymaps).",
     }

{greenpick-0.1.0 → greenpick-0.1.2/src/greenpick.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greenpick
-Version: 0.1.0
+Version: 0.1.2
 Summary: Design-time sustainability co-pilot (MCP server): greener, cheaper cloud infrastructure decisions with carbon + cost + latency tradeoffs.
 Author-email: "Data Science Advisers, LLC" <info@datascienceadvisers.com>
 License-Expression: MIT
@@ -29,7 +29,7 @@ Requires-Dist: ijson>=3.0; extra == "dev"
 Dynamic: license-file
 
 <p align="center">
-  <img src="docs/img/logo.svg" alt="GreenPick logo — a leaf whose veins are circuit traces" width="120" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/logo.svg" alt="GreenPick logo — a leaf whose veins are circuit traces" width="120" />
 </p>
 
 <h1 align="center">GreenPick</h1>
@@ -58,7 +58,7 @@ seconds. (It responds when you ask; auto-nudging on infra-code changes is on the
 > checks — all shipped. Falls back to clearly-labelled mock data offline or without API keys.
 
 <p align="center">
-  <img src="docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
 </p>
 
 *The same 40-GPU-hour training run emits ~0.7 kg CO₂ in Stockholm vs ~19 kg in Sydney — a ~30×
@@ -227,11 +227,50 @@ pytest                          # run tests
 Connect it to an MCP client (e.g. Kiro / Claude Code / Cursor) by pointing the client at
 `python -m greenpick` in this directory. See `.env.example` for switching the data source.
 
+### Turn on live data
+
+GreenPick runs on labelled mock data until you give it two free keys:
+[EIA](https://www.eia.gov/opendata/register.php) (US grid) and
+[ENTSO-E](https://transparency.entsoe.eu/) (EU grid). Pass them as environment variables.
+(A `.env` file works for a source checkout; if you installed with `pip install greenpick`, use one
+of the options below.)
+
+**In an MCP client** (Kiro, Claude Desktop, Cursor…), add an `env` block to the server entry:
+
+```json
+{
+  "mcpServers": {
+    "greenpick": {
+      "command": "python",
+      "args": ["-m", "greenpick"],
+      "env": {
+        "GREENPICK_CARBON_SOURCE": "auto",
+        "EIA_API_KEY": "your-eia-key",
+        "ENTSOE_TOKEN": "your-entsoe-token"
+      }
+    }
+  }
+}
+```
+
+**In a Jupyter notebook or Python script**, set them before you start (or import) the server:
+
+```python
+import os
+os.environ["GREENPICK_CARBON_SOURCE"] = "auto"
+os.environ["EIA_API_KEY"] = "your-eia-key"
+os.environ["ENTSOE_TOKEN"] = "your-entsoe-token"
+```
+
+Every carbon figure includes a `quality` field: `live` means real grid data, `mock` means a
+fallback value. Check it to confirm live data is on.
+
 ## FAQ
 
 **Do I need API keys?** No — GreenPick runs on clearly-labelled mock data out of the box. For *live*
-carbon, set two free keys in `.env` (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
-`GREENPICK_CARBON_SOURCE=auto`. Without them it still works; it just says `quality: "mock"`.
+carbon, set two free keys (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
+`GREENPICK_CARBON_SOURCE=auto` — see [Turn on live data](#turn-on-live-data). Without them it still
+works; it just says `quality: "mock"`.
 
 **Why "directional" and not audited numbers?** Because it's for a *design-time decision*, not a
 compliance report. "Stockholm is ~30× cleaner than Sydney" is what you need to pick a region in