everestapi 0.2.1__tar.gz → 0.2.4__tar.gz

{everestapi-0.2.1 → everestapi-0.2.4}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 EverestQuant
+Copyright (c) 2026 Everesteer
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{everestapi-0.2.1/src/everestapi.egg-info → everestapi-0.2.4}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: everestapi
-Version: 0.2.1
-Summary: Python SDK for the EverestQuant prediction tournament platform
-Author-email: EverestQuant <engineering@everestquant.ai>
+Version: 0.2.4
+Summary: Python SDK for the Everesteer prediction tournament platform
+Author-email: Everesteer <support@everesteer.ai>
 License-Expression: MIT
-Project-URL: Homepage, https://everestquant.ai
-Project-URL: Documentation, https://docs.everestquant.ai
+Project-URL: Homepage, https://everesteer.ai
+Project-URL: Documentation, https://docs.everesteer.ai
 Project-URL: Repository, https://github.com/everestquant/everestapi-public
 Keywords: quant,tournament,prediction,staking,machine-learning
 Classifier: Development Status :: 4 - Beta
@@ -26,11 +26,13 @@ Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-httpx>=0.34.0; extra == "dev"
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: viz
+Requires-Dist: plotnine>=0.13; extra == "viz"
 Dynamic: license-file
 
 # everestapi
 
-Python SDK for the [EverestQuant](https://everestquant.ai) prediction tournament platform.
+Python SDK for the [Everesteer](https://everesteer.ai) prediction tournament platform.
 
 ```bash
 pip install everestapi
@@ -109,9 +111,39 @@ api.download_dataset(universe="futures", split="train")
 api.download_benchmark(universe="futures", split="validation")
 api.get_dataset_info(universe="futures")
 api.get_diagnostics(model_id="my-model")
+
+# Validation diagnostics: eiq_validation_example_preds.parquet is the upload template
+# (same `id` set, your own `prediction` column).
+api.download_dataset(universe="futures", split="validation_example_preds")
 api.submit_validation_diagnostics(model_id="my-model", predictions=df)
 ```
 
+### Plotting (optional `viz` extra)
+
+The `viz` extra installs [plotnine](https://plotnine.org/) (a grammar-of-graphics /
+ggplot2 port). Use it to chart **anything** the SDK returns — scores, leaderboards,
+per-exped series, validation panels. `everestapi.plots.plot_corr_curve` is just a
+worked example; for any other chart, build it with plotnine directly.
+
+```bash
+pip install 'everestapi[viz]'
+```
+
+```python
+# Convenience helper — cumulative-CORR curve to a PNG:
+from everestapi.plots import plot_corr_curve
+corr = api.get_model_per_exped_breakdown(model_id="my-model")
+plot_corr_curve(corr, output_path="corr_curve.png")
+
+# Any other chart — plotnine on SDK data (matplotlib Agg backend, headless-safe):
+import matplotlib; matplotlib.use("Agg")
+import pandas as pd, plotnine as p9
+lb = api.get_leaderboard(period="30d")
+df = pd.DataFrame(lb["entries"])
+(p9.ggplot(df, p9.aes("model_name", "total_payout")) + p9.geom_col()
+ + p9.coord_flip()).save("leaderboard.png", verbose=False)
+```
+
 ### Serverless compute
 
 ```python
@@ -178,7 +210,7 @@ with EverestAPI(api_key="...") as api:
 
 ## Disclaimers
 
-- **Not financial advice.** EverestQuant tournaments are prediction competitions. Nothing in this SDK or on the platform constitutes investment advice, a solicitation, or a recommendation to buy or sell any financial instrument.
+- **Not financial advice.** Everesteer tournaments are prediction competitions. Nothing in this SDK or on the platform constitutes investment advice, a solicitation, or a recommendation to buy or sell any financial instrument.
 - **Testnet / beta.** The staking system and compute platform are in beta. Smart contract addresses, API endpoints, and payout mechanics may change without notice.
 - **API stability.** This SDK targets API v1. Breaking changes will be communicated via the platform changelog and will follow semver once the SDK reaches 1.0.
 - **Data is obfuscated.** All features and instrument identifiers served by the API are obfuscated. Attempting to reverse-engineer or de-obfuscate data violates the platform terms of service.

{everestapi-0.2.1 → everestapi-0.2.4}/README.md

@@ -1,6 +1,6 @@
 # everestapi
 
-Python SDK for the [EverestQuant](https://everestquant.ai) prediction tournament platform.
+Python SDK for the [Everesteer](https://everesteer.ai) prediction tournament platform.
 
 ```bash
 pip install everestapi
@@ -79,9 +79,39 @@ api.download_dataset(universe="futures", split="train")
 api.download_benchmark(universe="futures", split="validation")
 api.get_dataset_info(universe="futures")
 api.get_diagnostics(model_id="my-model")
+
+# Validation diagnostics: eiq_validation_example_preds.parquet is the upload template
+# (same `id` set, your own `prediction` column).
+api.download_dataset(universe="futures", split="validation_example_preds")
 api.submit_validation_diagnostics(model_id="my-model", predictions=df)
 ```
 
+### Plotting (optional `viz` extra)
+
+The `viz` extra installs [plotnine](https://plotnine.org/) (a grammar-of-graphics /
+ggplot2 port). Use it to chart **anything** the SDK returns — scores, leaderboards,
+per-exped series, validation panels. `everestapi.plots.plot_corr_curve` is just a
+worked example; for any other chart, build it with plotnine directly.
+
+```bash
+pip install 'everestapi[viz]'
+```
+
+```python
+# Convenience helper — cumulative-CORR curve to a PNG:
+from everestapi.plots import plot_corr_curve
+corr = api.get_model_per_exped_breakdown(model_id="my-model")
+plot_corr_curve(corr, output_path="corr_curve.png")
+
+# Any other chart — plotnine on SDK data (matplotlib Agg backend, headless-safe):
+import matplotlib; matplotlib.use("Agg")
+import pandas as pd, plotnine as p9
+lb = api.get_leaderboard(period="30d")
+df = pd.DataFrame(lb["entries"])
+(p9.ggplot(df, p9.aes("model_name", "total_payout")) + p9.geom_col()
+ + p9.coord_flip()).save("leaderboard.png", verbose=False)
+```
+
 ### Serverless compute
 
 ```python
@@ -148,7 +178,7 @@ with EverestAPI(api_key="...") as api:
 
 ## Disclaimers
 
-- **Not financial advice.** EverestQuant tournaments are prediction competitions. Nothing in this SDK or on the platform constitutes investment advice, a solicitation, or a recommendation to buy or sell any financial instrument.
+- **Not financial advice.** Everesteer tournaments are prediction competitions. Nothing in this SDK or on the platform constitutes investment advice, a solicitation, or a recommendation to buy or sell any financial instrument.
 - **Testnet / beta.** The staking system and compute platform are in beta. Smart contract addresses, API endpoints, and payout mechanics may change without notice.
 - **API stability.** This SDK targets API v1. Breaking changes will be communicated via the platform changelog and will follow semver once the SDK reaches 1.0.
 - **Data is obfuscated.** All features and instrument identifiers served by the API are obfuscated. Attempting to reverse-engineer or de-obfuscate data violates the platform terms of service.

{everestapi-0.2.1 → everestapi-0.2.4}/pyproject.toml

@@ -5,11 +5,11 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "everestapi"
 dynamic = ["version"]
-description = "Python SDK for the EverestQuant prediction tournament platform"
+description = "Python SDK for the Everesteer prediction tournament platform"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"
-authors = [{ name = "EverestQuant", email = "engineering@everestquant.ai" }]
+authors = [{ name = "Everesteer", email = "support@everesteer.ai" }]
 keywords = ["quant", "tournament", "prediction", "staking", "machine-learning"]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -31,13 +31,16 @@ dev = ["pytest>=8.0", "pytest-httpx>=0.34.0"]
 # MCP server (`python -m everestapi.mcp`). Optional — the server falls back to a
 # built-in JSON-RPC stdio loop when the official `mcp` SDK isn't installed.
 mcp = ["mcp>=1.0"]
+# Plotting helpers (`everestapi.plots`). Heavy — pulls matplotlib/pandas/numpy/
+# scipy/statsmodels/mizani. Optional: the SDK and MCP server never import it.
+viz = ["plotnine>=0.13"]
 
 [project.scripts]
 everestapi = "everestapi.cli:cli"
 
 [project.urls]
-Homepage = "https://everestquant.ai"
-Documentation = "https://docs.everestquant.ai"
+Homepage = "https://everesteer.ai"
+Documentation = "https://docs.everesteer.ai"
 Repository = "https://github.com/everestquant/everestapi-public"
 
 [tool.setuptools.packages.find]

{everestapi-0.2.1 → everestapi-0.2.4}/src/everestapi/__init__.py

@@ -1,6 +1,6 @@
-"""EverestAPI — Python SDK for the EverestQuant prediction tournament platform."""
+"""EverestAPI — Python SDK for the Everesteer prediction tournament platform."""
 
-__version__ = "0.2.1"
+__version__ = "0.2.4"
 
 from everestapi.client import EverestAPI, EverestError
 from everestapi.types import (

{everestapi-0.2.1 → everestapi-0.2.4}/src/everestapi/cli.py

@@ -1,4 +1,4 @@
-"""EverestAPI CLI — command-line interface for the EverestQuant tournament platform.
+"""EverestAPI CLI — command-line interface for the Everesteer tournament platform.
 
 Usage:
     everestapi health
@@ -32,7 +32,7 @@ def _print_json(data: dict) -> None:
 @click.group()
 @click.version_option(__version__, prog_name="everestapi")
 def cli() -> None:
-    """EverestQuant tournament CLI."""
+    """Everesteer tournament CLI."""
 
 
 @cli.command()
@@ -69,11 +69,15 @@ def download_data(universe: str, split: str, output: str | None, api_key: str |
 @click.option("--version", "-v", default="v0")
 @click.option("--output", "-o", default=None)
 @click.option("--api-key", envvar=["EIQ_API_KEY", "EVEREST_API_KEY"], default=None)
-def download_benchmark(universe: str, split: str, version: str, output: str | None, api_key: str | None) -> None:
+def download_benchmark(
+    universe: str, split: str, version: str, output: str | None, api_key: str | None
+) -> None:
     """Download benchmark model predictions."""
     api = _get_api(api_key)
     try:
-        path = api.download_benchmark(universe=universe, split=split, version=version, output_path=output)
+        path = api.download_benchmark(
+            universe=universe, split=split, version=version, output_path=output
+        )
         click.echo(f"Downloaded to {path}")
     except EverestError as e:
         click.echo(f"Error: {e}", err=True)
@@ -83,7 +87,9 @@ def download_benchmark(universe: str, split: str, version: str, output: str | No
 @cli.command()
 @click.option("--model", "-m", required=True, help="Model identifier")
 @click.option(
-    "--file", "-f", "file_path",
+    "--file",
+    "-f",
+    "file_path",
     required=True,
     help="Predictions file (.parquet or .csv). Parquet recommended.",
 )
@@ -102,7 +108,9 @@ def submit(model: str, file_path: str, tournament: str, api_key: str | None) ->
     try:
         if ext == "parquet":
             result = api.submit_predictions_file(
-                model_name=model, file_path=file_path, tournament=tournament,
+                model_name=model,
+                file_path=file_path,
+                tournament=tournament,
             )
         elif ext == "csv":
             import csv as _csv
@@ -115,8 +123,7 @@ def submit(model: str, file_path: str, tournament: str, api_key: str | None) ->
                 result = api.submit_futures_predictions(model_id=model, predictions=preds)
             else:
                 preds_list = [
-                    {"ticker": row["ticker"], "score": float(row["score"])}
-                    for row in rows
+                    {"ticker": row["ticker"], "score": float(row["score"])} for row in rows
                 ]
                 result = api.submit_predictions(model_id=model, predictions=preds_list)
         else:
@@ -127,7 +134,7 @@ def submit(model: str, file_path: str, tournament: str, api_key: str | None) ->
             sys.exit(1)
 
         _print_json(result)
-    except (EverestError, KeyError, FileNotFoundError) as e:
+    except (EverestError, KeyError, FileNotFoundError, ValueError) as e:
         click.echo(f"Error: {e}", err=True)
         sys.exit(1)
 
@@ -227,7 +234,7 @@ def register(name: str, email: str) -> None:
         click.echo("Registration successful!")
         click.echo(f"  Agent ID:  {result['agent_id']}")
         click.echo(f"  API Key:   {result['api_key']}  (save this — shown once)")
-        click.echo(f"\nSet your API key:")
+        click.echo("\nSet your API key:")
         click.echo(f"  export EIQ_API_KEY={result['api_key']}")
     except EverestError as e:
         click.echo(f"Error: {e}", err=True)