Ona SDK Documentation
Typed client libraries for Python and JavaScript, built for the Ona Intelligence Layer — energy forecasting, fault detection, inverter telemetry, and O&M intelligence for solar, wind, and battery storage assets.
New here? Contact support@asoba.org for an API key first.
Quick Start
Python
git clone https://github.com/AsobaCloud/sdk.git
cd sdk/python && pip3 install -e .
Typed client for scripts, notebooks, and backend services.
JavaScript
git clone https://github.com/AsobaCloud/sdk.git
cd sdk/javascript && npm install
Typed client for Node.js and browser applications.
from ona_platform import OnaClient
client = OnaClient()
period = client.inverter_telemetry.get_data_period(site_id="Sibaya")
print(f"Data available from {period['first_record']} to {period['last_record']}")
→ See the full Quickstart Guide for streaming, alerts, and more.
SDK Service Guides
Inverter Telemetry
Query and stream live inverter data
OODA Terminal Alerts
Query and stream fault/diagnostic alerts
Forecasting
Device, site, and customer-level energy forecasts
Freemium Forecasting
No-API-key forecasting with email verification
Terminal OODA Workflow
Full OODA loop: detect → diagnose → decide → act
Partner API
Pre-computed JSON snapshots with ETag caching
Energy Analyst
RAG-powered energy policy queries
Edge Devices
Device discovery and management
Data Ingestion & Training
Upload data and manage ML models
PV Insight Service
RAG-powered O&M recommendations from anomaly detections
ODS-E & Data Architecture
What is ODS-E?
The Open Data Schema for Energy specification
Ona Intelligence Layer Architecture
How ODS-E fits with the platform
ODS-E & the SDK
How ODS-E connects to SDK data flows
Schema Reference
Field-level ODS-E schema definitions
Transform Specs
How raw data maps to ODS-E
Validation Guide
Validating data against the schema