Asoba Ona Documentation

Start Forecasting in 5 Minutes

Get up and running with Ona’s energy forecasting API in minutes. Choose your preferred integration method and make your first forecast.


Choose Your Path

🐍 Python Script

Upload data and get forecasts with a simple Python script

Start with Python

πŸ“¦ SDK

Use our official SDK for seamless integration

Use the SDK

🌐 REST API

Direct API calls for maximum flexibility

Use REST API

Learn More

Explore Ona’s two interfaces designed for different workflows and user preferences. Choose the one that best fits your technical requirements and team structure.

Ona Terminal Interface

Ona Terminal

AI-powered infrastructure automation tool for terminal users with OODA workflow capabilities and energy asset management. Perfect for developers who prefer command-line interfaces and automated workflows.

Explore Ona Terminal
Ona On Demand Interface

Ona On Demand

Web-based demand forecasting and dispatch scheduling application with intuitive interface for business users. Designed for easy access through your browser with visual tools and dashboards.

Launch Web App

Python Quickstart

1. Install Dependencies

pip install requests python-dotenv

2. Set Up Your Environment

Create a .env file with your API credentials:

ONA_API_URL=https://yn058ezh38.execute-api.af-south-1.amazonaws.com/prod
ONA_API_KEY=your-api-key-here

3. Upload Historical Data & Train Model

import os
import requests
from dotenv import load_dotenv

load_dotenv()

def upload_and_train():
    # Upload historical data
    url = f"{os.getenv('ONA_API_URL')}/upload_historical"
    headers = {"x-api-key": os.getenv('ONA_API_KEY')}
    
    params = {
        "customer_id": "your-customer-id",
        "filename": "historical_data.csv",
        "manufacturer": "SolarEdge", 
        "location": "CapeTown",
        "region": "af-south-1"
    }
    
    with open('historical_data.csv', 'rb') as file:
        response = requests.post(url, params=params, headers=headers, data=file)
        print(f"Upload: {response.status_code}")
    
    # Train forecasting model
    train_url = f"{os.getenv('ONA_API_URL')}/train"
    train_params = {
        "customer_id": "your-customer-id",
        "location": "CapeTown",
        "manufacturer": "SolarEdge",
        "serial_number": "SE123456",
        "region": "af-south-1",
        "testing": "True"
    }
    
    train_response = requests.post(train_url, params=train_params, headers=headers)
    print(f"Training: {train_response.status_code}")
    return train_response.json()

# Run it
result = upload_and_train()
print("βœ… Model training started! Check your email for results.")

SDK Quickstart

1. Install the SDK

pip install ona-sdk  # Python
# or
npm install ona-sdk  # JavaScript

2. Quick Example

from ona_sdk import OnaClient

# Initialize client
client = OnaClient(api_key="your-api-key")

# Upload and train in one step
result = client.upload_and_train(
    file_path="energy_data.csv",
    customer_id="your-id",
    location="CapeTown",
    manufacturer="SolarEdge"
)

print("βœ… Training started! Results will be emailed to you.")

REST API Quickstart

1. Upload Historical Data

curl -X POST "https://yn058ezh38.execute-api.af-south-1.amazonaws.com/prod/upload_historical" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/octet-stream" \
  -F "customer_id=your-customer-id" \
  -F "filename=data.csv" \
  -F "manufacturer=SolarEdge" \
  -F "location=CapeTown" \
  -F "region=af-south-1" \
  --data-binary @your-data.csv

2. Start Model Training

curl -X POST "https://yn058ezh38.execute-api.af-south-1.amazonaws.com/prod/train" \
  -H "x-api-key: YOUR_API_KEY" \
  -G \
  -d "customer_id=your-customer-id" \
  -d "location=CapeTown" \
  -d "manufacturer=SolarEdge" \
  -d "serial_number=SE123456" \
  -d "region=af-south-1" \
  -d "testing=True"

What’s Next?

🎯 New to Ona? β†’ Read Getting Started for detailed onboarding
πŸ“š Need to understand the concepts? β†’ Core Concepts
πŸ”§ Ready to integrate? β†’ API Reference
πŸ’‘ Want to see examples? β†’ Use Cases
πŸ–₯️ Prefer a web interface? β†’ Try Ona On-Demand


Need Help?

Get Help & Stay Updated

Contact Support

For technical assistance, feature requests, or any other questions, please reach out to our dedicated support team.

Email Support Join Discord

Subscribe to Updates

* indicates required

Β© 2025 Asoba Corporation. All rights reserved.