Lack of DSN should turn client into nop

Author: piotrekno1

README.md

@@ -53,6 +53,8 @@ client.instrument("transformers", hubs=["huggingface"])
 # models loaded after this point are tracked automatically
 ```
 
+If no DSN is configured, the client becomes a no-op and logs a warning.
+
 ## Supported integrations
 
 **On-device**
@@ -90,7 +92,7 @@ For unsupported frameworks, see [Manual tracking](https://github.com/wild-edge/w
 
 | Parameter | Default | Description |
 |---|---|---|
-| `dsn` | - | `https://<secret>@ingest.wildedge.dev/<key>` (or `WILDEDGE_DSN`) |
+| `dsn` | - | `https://<secret>@ingest.wildedge.dev/<key>` (or `WILDEDGE_DSN`). If unset, the client is a no-op. |
 | `app_version` | `None` | Your app's version string |
 | `app_identity` | `<project_key>` | Namespace for offline persistence. Set per-app in multi-process workloads (or `WILDEDGE_APP_IDENTITY`) |
 | `enable_offline_persistence` | `true` | Persist unsent events to disk and replay on restart |

docs/configuration.md

@@ -6,7 +6,7 @@ Full reference for all `WildEdge` client parameters.
 
 | Parameter | Default | Env var | Description |
 |---|---|---|---|
-| `dsn` | - | `WILDEDGE_DSN` | `https://<secret>@ingest.wildedge.dev/<key>` |
+| `dsn` | - | `WILDEDGE_DSN` | `https://<secret>@ingest.wildedge.dev/<key>`. If unset, the client is a no-op. |
 | `app_version` | `None` | - | Your app's version string |
 | `app_identity` | `<project_key>` | `WILDEDGE_APP_IDENTITY` | Namespace for offline persistence. Set per-app in multi-process workloads |
 | `enable_offline_persistence` | `true` | - | Persist unsent events to disk and replay on restart |

docs/manual-tracking.md

@@ -25,7 +25,7 @@ Every model needs a handle before you can track events against it. Pass the mode
 ```python
 import wildedge
 
-client = wildedge.WildEdge()  # set WILDEDGE_DSN env var
+client = wildedge.WildEdge()  # uses WILDEDGE_DSN if set; otherwise no-op
 
 handle = client.register_model(
     my_model,

examples/feedback_example.py

@@ -22,7 +22,7 @@
 CONFIDENCE_THRESHOLD = 0.6
 
 client = wildedge.WildEdge(
-    app_version="1.0.0",  # set WILDEDGE_DSN env var
+    app_version="1.0.0",  # uses WILDEDGE_DSN if set; otherwise no-op
 )
 client.instrument("timm")
 

examples/gguf_example.py

@@ -13,7 +13,7 @@
 import wildedge
 
 client = wildedge.WildEdge(
-    app_version="1.0.0",  # set WILDEDGE_DSN env var
+    app_version="1.0.0",  # uses WILDEDGE_DSN if set; otherwise no-op
 )
 client.instrument("gguf", hubs=["huggingface"])
 

examples/gguf_gemma_example.py

@@ -28,7 +28,7 @@
 FILE = "gemma-2-2b-it-Q4_K_M.gguf"
 
 client = wildedge.WildEdge(
-    app_version="1.0.0",  # set WILDEDGE_DSN env var
+    app_version="1.0.0",  # uses WILDEDGE_DSN if set; otherwise no-op
 )
 
 # --- Download ---

examples/keras_example.py

@@ -28,7 +28,7 @@
     exit(1)
 
 client = wildedge.WildEdge(
-    app_version="1.0.0",  # set WILDEDGE_DSN env var
+    app_version="1.0.0",  # uses WILDEDGE_DSN if set; otherwise no-op
 )
 
 # Load a pre-trained MobileNetV2 model using client to track construction and lifecycle

examples/mlx_example.py

@@ -52,7 +52,9 @@ def main() -> None:
 
     # instrument() patches mlx_lm.load and mlx_lm.generate; must be called
     # before any model is loaded.
-    client = wildedge.WildEdge(app_version="1.0.0")  # set WILDEDGE_DSN env var
+    client = wildedge.WildEdge(
+        app_version="1.0.0"
+    )  # uses WILDEDGE_DSN if set; otherwise no-op
     client.instrument("mlx", hubs=["huggingface"])
 
     print(f"\nLoading {args.model} ...")

examples/onnx_example.py

@@ -14,7 +14,7 @@
 import wildedge
 
 client = wildedge.WildEdge(
-    app_version="1.0.0",  # set WILDEDGE_DSN env var
+    app_version="1.0.0",  # uses WILDEDGE_DSN if set; otherwise no-op
 )
 client.instrument("onnx", hubs=["huggingface"])
 

examples/openai_example.py

@@ -18,7 +18,9 @@
 
 import wildedge
 
-client = wildedge.WildEdge(app_version="1.0.0")  # set WILDEDGE_DSN env var
+client = wildedge.WildEdge(
+    app_version="1.0.0"
+)  # uses WILDEDGE_DSN if set; otherwise no-op
 client.instrument("openai")
 
 openai_client = OpenAI()  # set OPENAI_API_KEY env var or pass api_key= explicitly