WaveGuard is a general-purpose anomaly detection API. Send it any data — server metrics, financial transactions, log files, sensor readings, time series — and get back anomaly scores, confidence levels, and explanations of which features triggered the alert.
No training pipelines. No model management. No state. One API call.
Python SDK for WaveGuard physics-based anomaly detection API. One call. Any data.
ดาว
4
เครื่องมือ
—
อัปไทม์
—
Your data → WaveGuard API (GPU) → Anomaly scores + explanations
Under the hood, it uses GPU-accelerated wave physics instead of machine learning. You don't need to know or care about the physics — it's all server-side.
Modal dashboard vs API endpoints
If you look at Modal, you will see deployed functions (for example fastapi_app, gpu_scan, gpu_fingerprint).
Those are compute/runtime units, not the HTTP route list.
Your data is encoded onto a 64³ lattice and run through coupled wave equation simulations on GPU. Normal data produces stable wave patterns; anomalies produce divergent ones. A 52-dimensional statistical fingerprint is compared between training and test data. Everything is torn down after each call — nothing is stored.
The key advantage over ML: no training data requirements (2+ samples is enough), no model drift, no retraining, no hyperparameter tuning. Same API call works on structured data, text, numbers, and time series.
Benchmarks (v2.2)
WaveGuard v2.2 vs scikit-learn across 6 real-world scenarios (10 training + 10 test samples each).
TL;DR: WaveGuard v2.2 wins 4 of 6 scenarios and averages 0.76 F1 — competitive with sklearn methods while requiring zero ML expertise.
F1 Score (balanced precision-recall)
Scenario
WaveGuard
IsolationForest
LOF
OneClassSVM
Server Metrics (IT Ops)
0.87
0.71
0.87
0.62
Financial Fraud
0.83
0.74
0.77
0.77
IoT Sensors (Industrial)
0.87
0.69
0.69
0.65
Network Traffic (Security)
0.82
0.61
0.77
0.61
Time-Series (Monitoring)
0.46
0.77
0.80
0.67
Sparse Features (Logs)
0.72
0.90
0.82
0.78
Average
0.76
0.74
0.79
0.68
What's new in v2.2
Multi-resolution scoring tracks each feature's local lattice energy in addition to global fingerprint distance. This catches subtle per-feature anomalies (like 3 of 10 IoT sensors drifting) that v2.1's global averaging missed. IoT F1 improved from 0.30 → 0.87.
When to choose WaveGuard over sklearn
Choose WaveGuard when...
Choose sklearn when...
False alarms are expensive (alert fatigue, SRE pages)
The API doesn't know your domain. It just knows what "normal" looks like (your training data) and flags anything that deviates. This makes it general — you bring the context, it brings the detection.
Supported Data Types
All auto-detected from data shape. No configuration needed:
Type
Example
Use When
JSON objects
{"cpu": 45, "memory": 62}
Structured records with named fields
Numeric arrays
[1.0, 1.2, 5.8, 1.1]
Feature vectors, embeddings
Text strings
"ERROR segfault at 0x0"
Logs, messages, free text
Time series
[100, 102, 98, 105, 99]
Metric windows, sequential readings
Examples
Every example is a runnable Python script that hits the live API:
Azure Anomaly Detector retires October 2026. WaveGuard is a drop-in replacement:
# Before (Azure) — 3+ API calls, stateful, time-series only
client = AnomalyDetectorClient(endpoint, credential)
model = client.train_multivariate_model(request) # minutes
result = client.detect_multivariate_batch_anomaly(model_id, data)
client.delete_multivariate_model(model_id)
# After (WaveGuard) — 1 API call, stateless, any data type
wg = WaveGuard(api_key="YOUR_KEY")
result = wg.scan(training=normal_data, test=new_data) # seconds
Returns ScanResult with .results (per-sample) and .summary (aggregate).
wg.health() / wg.tier()
Health check (no auth) and subscription tier info.
Advanced intelligence methods (v3.3.0)
wg.counterfactual(...)
wg.trajectory_scan(...)
wg.instability(...)
wg.phase_coherence(...)
wg.interaction_matrix(...)
wg.cascade_risk(...)
wg.mechanism_probe(...)
wg.action_surface(...)
wg.multi_horizon_outlook(...)
These map directly to /v1/* intelligence endpoints and return the raw JSON payload
for maximal compatibility with rapidly evolving server-side response schemas.
Error Handling
from waveguard import WaveGuard, AuthenticationError, RateLimitError
try:
result = wg.scan(training=data, test=new_data)
except AuthenticationError:
print("Bad API key")
except RateLimitError:
print("Too many requests — back off and retry")