# Ona SDK Documentation

> The Ona SDK provides typed client libraries (Python & JavaScript) for integrating with the Ona Intelligence Layer — energy forecasting, fault detection, inverter telemetry, and O&M intelligence for solar, wind, and battery storage assets. The Ona Intelligence Layer uses ODS-E (Open Data Schema for Energy) as its native data format.

Documentation is available at https://docs.asoba.org

## Getting Started

- [Quickstart](https://docs.asoba.org/get-started): Install the SDK and make your first call in 5 minutes — query inverter telemetry, stream live data, and get OODA alerts

## SDK

- [SDK Overview](https://docs.asoba.org/sdk/overview): Architecture, Python vs JavaScript comparison, full service map, and design philosophy
- [Installation](https://docs.asoba.org/sdk/installation): Install both SDKs, environment variables, and constructor configuration
- [Authentication](https://docs.asoba.org/sdk/authentication): API keys, environment variables, multi-endpoint configuration, and the auth service
- [Error Handling](https://docs.asoba.org/sdk/error-handling): Error class hierarchy, retry logic, rate limiting, and cost protection

## SDK Service Guides

- [Inverter Telemetry](https://docs.asoba.org/sdk/services/inverter-telemetry): Query historical and stream live inverter data with cursor-based pagination
- [OODA Terminal Alerts](https://docs.asoba.org/sdk/services/ooda-terminal-alerts): Query and stream fault/diagnostic alerts from terminal devices
- [Forecasting](https://docs.asoba.org/sdk/services/forecasting): Device, site, and customer-level energy forecasts
- [Freemium Forecasting](https://docs.asoba.org/sdk/services/freemium-forecasting): No-API-key CSV-based solar forecasting with email verification
- [Terminal OODA Workflow](https://docs.asoba.org/sdk/services/terminal-ooda-workflow): Full OODA loop — detect, diagnose, schedule, build BOM, create orders
- [Partner API](https://docs.asoba.org/sdk/services/partner-api): Pre-computed JSON snapshots with ETag-based conditional GETs (sub-100ms)
- [Energy Analyst](https://docs.asoba.org/sdk/services/energy-analyst): RAG-powered energy policy and regulatory compliance queries
- [Edge Devices](https://docs.asoba.org/sdk/services/edge-devices): Device discovery, registration, capability detection, and management
- [Data Ingestion & Training](https://docs.asoba.org/sdk/services/data-ingestion-training): Upload data, train ML models, standardize against ODS-E, detect gaps, interpolate
- [PV Insight Service](https://docs.asoba.org/sdk/services/pv-insight): JEPA anomaly detection → O&M recommendation via hybrid RAG and Nehanda 27B (preview)

## ODS-E & Architecture

- [Overview](https://docs.asoba.org/odse/overview): What is ODS-E — the Open Data Schema for Energy specification, components, and quick start
- [Ona Intelligence Layer Architecture](https://docs.asoba.org/odse/architecture): How ODS-E fits with the Ona Intelligence Layer — three-layer architecture and data flow
- [ODS-E & the SDK](https://docs.asoba.org/odse/sdk-integration): How ODS-E connects to the SDK — standardization service, data ingestion, and validate-then-upload workflow
- [Schema Reference](https://docs.asoba.org/odse/schemas): Energy-timeseries, asset-metadata, equipment-register schemas and the 7-category error taxonomy
- [Transform Specifications](https://docs.asoba.org/odse/transforms): Declarative YAML OEM-to-ODS-E mappings for 20+ vendors
- [Validation Guide](https://docs.asoba.org/odse/validation): Schema, semantic, temporal validation levels and 6 conformance profiles

## Code Examples

- [Overview](https://docs.asoba.org/examples/overview): Index of all 17 example files across Python and JavaScript
- [Complete Workflow](https://docs.asoba.org/examples/complete-workflow): Multi-service integration walkthrough — forecast, detect, diagnose, schedule
- [Python vs JavaScript](https://docs.asoba.org/examples/language-comparison): Side-by-side comparison for common SDK operations

## Repositories

- [Ona SDK](https://github.com/AsobaCloud/sdk): Python & JavaScript SDK source, examples, and tests
- [ODS-E Protocol](https://github.com/AsobaCloud/odse): Open data schema specification, transforms, and reference runtime