Asoba Ona Documentation

Ona Terminal

AI-powered command-line interface for energy asset management with OODA workflow capabilities.


Overview

Ona Terminal is a powerful CLI tool designed for developers and technical teams who prefer command-line interfaces and automated workflows. It provides comprehensive energy asset management capabilities through an intuitive terminal interface.


Key Features

🚀 OODA Workflow Integration

Energy Asset Management

🔧 Developer-Friendly

📊 Advanced Analytics

🖥️ User-Friendly Dashboard Interface

For non-technical users, Ona Terminal provides an intuitive web dashboard that makes energy asset management accessible to everyone:

Main Dashboard Overview

Ona Terminal Dashboard Overview

The main dashboard provides a comprehensive view of all your energy assets with:

Asset Detail View

Ona Terminal Asset Detail

Drill down into individual assets to see:

Work Order Management

Ona Terminal Work Order Management

Streamlined work order creation with:

AI Assistant Chat

Ona Terminal AI Assistant

Natural language support through:


Getting Started

Installation

# Install Ona Terminal
curl -fsSL https://install.ona.co/terminal | bash

# Or using package managers
# macOS
brew install ona/ona/terminal

# Ubuntu/Debian
sudo apt-get install ona-terminal

# Windows
winget install Ona.Terminal

Quick Start

# Initialize Ona Terminal
ona init

# Connect to your energy assets
ona connect --type solar --location "Solar Farm 1"

# Start monitoring
ona monitor start

# View real-time data
ona data stream

# Generate performance report
ona report generate --type performance --period daily

Core Commands

Asset Management

# List all connected assets
ona assets list

# Add new asset
ona assets add --type inverter --model "SolarEdge SE5000" --location "Site A"

# Monitor specific asset
ona assets monitor --id "inverter-001"

# Update asset configuration
ona assets update --id "inverter-001" --config "optimization.json"

Data Analysis

# Collect historical data
ona data collect --start "2024-01-01" --end "2024-01-31"

# Analyze performance
ona analyze performance --asset "inverter-001" --period "30d"

# Generate forecasts
ona forecast generate --horizon "7d" --confidence "95%"

# Export data
ona data export --format csv --output "performance_data.csv"

OODA Workflow

# Start OODA workflow
ona ooda start --workflow "solar_optimization"

# Observe current state
ona ooda observe --assets all

# Orient analysis
ona ooda orient --analysis "performance_trends"

# Make decisions
ona ooda decide --strategy "optimize_production"

# Execute actions
ona ooda act --action "adjust_inverter_settings"

Configuration

Configuration File

Create a ona-config.yaml file in your project:

# Ona Terminal Configuration
version: "1.0"

# API Configuration
api:
  url: "https://api.ona.co"
  key: "${ONA_API_KEY}"
  region: "us-east-1"

# Asset Configuration
assets:
  solar:
    - id: "inverter-001"
      type: "inverter"
      model: "SolarEdge SE5000"
      location: "Site A"
      coordinates: [40.7128, -74.0060]
  
  battery:
    - id: "battery-001"
      type: "storage"
      model: "Tesla Powerwall"
      capacity: "13.5kWh"

# Monitoring Configuration
monitoring:
  interval: "5m"
  alerts:
    enabled: true
    email: "alerts@company.com"
    webhook: "https://hooks.slack.com/..."

# OODA Workflow Configuration
ooda:
  workflows:
    solar_optimization:
      observe:
        - "collect_inverter_data"
        - "collect_weather_data"
      orient:
        - "analyze_performance"
        - "identify_optimization_opportunities"
      decide:
        - "calculate_optimal_settings"
      act:
        - "adjust_inverter_parameters"

Use Cases

Solar Farm Management

# Monitor entire solar farm
ona farm monitor --site "Solar Farm Alpha"

# Optimize production
ona farm optimize --strategy "maximize_production"

# Generate daily reports
ona farm report --type daily --format pdf

Battery Storage Optimization

# Monitor battery health
ona battery health --id "battery-001"

# Optimize charging schedule
ona battery optimize --strategy "cost_minimization"

# Forecast storage needs
ona battery forecast --horizon "24h"

Grid Integration

# Monitor grid connection
ona grid status --connection "main_grid"

# Optimize power flow
ona grid optimize --strategy "load_balancing"

# Handle grid events
ona grid events --monitor true

Advanced Features

Custom Plugins

Create custom plugins to extend functionality:

# custom_plugin.py
from ona.plugin import Plugin

class CustomOptimizationPlugin(Plugin):
    def optimize_production(self, asset_data):
        # Custom optimization logic
        return optimized_settings

# Register plugin
ona plugin register custom_optimization.py

Automation Scripts

Create automated workflows:

#!/bin/bash
# daily_optimization.sh

# Collect data
ona data collect --period "24h"

# Analyze performance
ona analyze performance --assets all

# Generate optimization recommendations
ona optimize generate --type "production"

# Apply optimizations
ona optimize apply --recommendations "latest"

Integration with External Systems

# Export to external monitoring system
ona export --target "grafana" --format "json"

# Import from SCADA system
ona import --source "scada" --format "csv"

# Sync with cloud platform
ona sync --platform "aws" --bucket "energy-data"

Support & Resources

Documentation

Community

Support


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.