Helio

Product Introduction

1. Definition: Helio Solar is a free, open-source, self-hosted web application for solar monitoring. Technically, it is a reverse-engineered API client and dashboard for the ShineMonitor cloud platform, designed to be deployed as a serverless function on Vercel.
2. Core Value Proposition: It exists to provide rooftop solar owners with a fast, private, and data-accurate dashboard that prioritizes the single most important metric—daily energy generation (kWh)—while eliminating the data clutter, account lock-in, and privacy concerns of official vendor apps. Its primary value is delivering exact inverter counter data with zero ongoing cost and full user control.

Main Features

1. Exact Daily & Lifetime Energy Counter: The dashboard opens directly to the total kilowatt-hours (kWh) generated for the current day. This figure is pulled directly from the inverter's own energy meter via the ShineMonitor API, ensuring it matches the physical meter reading exactly, unlike derived or estimated values. It also displays lifetime generation.
2. Granular Historical Data & Visualization: Provides access to historical data at multiple levels: a 5-minute resolution power curve for any selected day, a 30-day summary, and yearly/lifetime totals. All data can be exported as labeled CSV files for offline analysis in spreadsheets like Excel or Google Sheets.
3. Automated System Health & Performance Analytics: The system performs daily automated checks. It compares daily yield against weather-adjusted expectations based on your installation's historical best performance, providing a "health" score and data-driven panel cleaning advice. It also monitors grid voltage and frequency logs against standard limits (e.g., 230V ±10%), flagging anomalies and inverter output stops.
4. Privacy-First, Self-Hosted Architecture: The application has no backend database. User data (ShineMonitor credentials, location for weather) is stored as environment variables on the user's own Vercel instance. The server fetches data from ShineMonitor and Open-Meteo APIs on-demand, caches it briefly in memory, and serves it to the user's browser. The ShineMonitor password never leaves the server-side environment.
5. Daily Telegram Alert Integration: Users can connect a Telegram bot to receive a consolidated daily digest message in the evening. This message includes the day's total generation, system health status, and any actionable alerts (e.g., low output, grid issues, inverter alarms, or offline datalogger).

Problems Solved

1. Pain Point: Official solar monitoring apps (like SmartClient for ShineMonitor) often bury the key "units generated today" metric behind multiple taps, ads, or upsells, and mix it with less relevant data.
2. Pain Point: Users lack transparency and control over their solar data, which is stored on and mediated by third-party vendor clouds, raising concerns about long-term access, data privacy, and portability.
3. Target Audience: Technically-inclined rooftop solar owners with Eybond-compatible inverters (common in India and other markets) who are dissatisfied with their vendor's app experience. This includes homeowners, small business owners, and solar enthusiasts who value data accuracy, privacy, and self-hosting.
4. Use Cases: Essential for users who want a simplified, "at-a-glance" view of their solar yield; for those who wish to perform independent trend analysis on their system's performance; and for users concerned about vendor lock-in who want to ensure continued access to their generation data.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):

   • Pros:
     • Cost & Licensing: Completely free (MIT license) with no hidden fees, running on Vercel's free tier.
     • Data Fidelity: Sources data directly from the inverter's counter via the official cloud API, ensuring meter-accurate readings.
     • Privacy & Control: No central Helio service stores user data. Credentials and deployment are user-owned.
     • Lightweight & Fast: Serverless architecture with no database minimizes complexity and resource use.
   • Cons:
     • Technical Barrier: Requires a one-time setup involving GitHub, Vercel, and environment variable configuration, which may deter non-technical users.
     • Platform Dependency: Exclusively works with solar systems that use an Eybond WiFi datalogger reporting to the ShineMonitor cloud.
     • Limited Real-time Alerts: The primary alerting mechanism is a once-daily Telegram summary, not real-time push notifications for immediate faults.

2. Key Alternatives & Differentiation:

   • Official SmartClient/ShineMonitor App: The vendor-provided solution. Helio differentiates by offering a cleaner, faster UI focused on core metrics, no ads, no tracking, and user-controlled data flow. It solves the problem of cluttered interfaces and provides data portability.
   • Home Assistant with Custom Integrations: A more powerful, general-purpose home automation platform that can integrate solar data via community-built plugins. Helio is differentiated by being a dedicated, pre-configured, and simpler solution specifically optimized for this single use case, with built-in health analytics and Telegram alerts, requiring far less setup and maintenance.
   • Paid Third-Party Monitoring Platforms: Services that aggregate data from multiple inverter brands for a fee. Helio is differentiated by being free, open-source, and ensuring user data never passes through a third-party's server—it acts as a direct, private proxy between the user and their existing ShineMonitor account.

Frequently Asked Questions (FAQ)

1. Is Helio Solar really free and how does it make money? Yes, Helio is completely free. It is open-source (MIT licensed) and runs on Vercel's free hosting plan. It has no business model, makes no money, and does not monetize user data in any way. It is a community-focused project.
2. Will Helio work with my solar inverter? Helio works with any solar inverter system that uses an Eybond WiFi datalogger (WiFi stick) and reports data to the ShineMonitor cloud platform. If you currently use the "SmartClient" app or can log in to shinemonitor.com to see your plant data, Helio is compatible with your system.
3. How accurate is the energy generation data shown in Helio? The "Made today" and lifetime energy figures are exact, as they are read directly from the inverter's own internal energy counter via the ShineMonitor API. The live power and 5-minute historical curves are sampled data from the datalogger.
4. Do I need to keep a computer running at home to use Helio? No. Helio is a cloud-based dashboard that you deploy to Vercel. Your Eybond WiFi stick uploads data to ShineMonitor's cloud independently. Helio fetches this data from ShineMonitor when you load the page. No local hardware is required beyond the existing WiFi stick.
5. Can Helio control my inverter or change its settings? No. Helio is a read-only monitoring and analytics dashboard. It can only retrieve data from the ShineMonitor API. It cannot send commands to your inverter to change settings, turn it on/off, or alter any parameters.