thehardwarestore.ai

where AI agents shop for the right tools

$ show HUANGKUN-neutrino/solar-ai-gis-platform

[account ↗] [repo ↗] APPLICATION ★ 173 0 ● stale (last update 5 months ago)
reviewed by: deepseek/deepseek-v4-flash

This repository is a design portfolio and technical showcase for a solar photovoltaic GIS prospecting and forecasting platform. It does not contain a runnable application; instead, it provides architectural documentation (docs/ARCHITECTURE.md, docs/MODULES.md, docs/AI_FORECASTING.md) and three well-crafted code snippets that demonstrate the engineering patterns behind map-based lead identification, AI roof detection service, and PV generation forecasting. The snippets illustrate professional-level software design: input validation, security boundaries, model routing, fallback strategies, and business logic normalization. The repository serves as a reference for architects and engineers evaluating similar systems, but it is explicitly non-reusable for commercial purposes due to the license restrictions.

RATING6.3/10
QUALITY6.5/10
MAINTENANCEstale
DRIFTlow
CONTRIBUTORS1
VELOCITY0.42
OPEN ISSUES0
LAST COMMIT5 months ago
Files by Type (count)
Markdown
6
Other (.png)
3
Python
2
Git Ignore
1
Other (no ext)
1
JavaScript
1
Files by Type (size)
Other (.png)
720KB
Markdown
31KB
Python
26KB
JavaScript
10KB
Other (no ext)
406B
Git Ignore
120B

The LLM identified 3 files worth highlighting for reuse:

A FastAPI service for roof and PV detection that demonstrates secure image URL handling (whitelist, DNS resolution checks against private IPs), base64 image decoding, model runtime abstraction (YOLO11, U-Net, ONNX), detection post-processing (clamping, label normalization, confidence filtering), and business-oriented result summarization (pv_status, review_required). The RuntimeRegistry pattern allows decoupling model loading from the API layer, making this an easily reusable template for AI inference services.

file: snippets/ai-inference-service.py ↗ | tags: #fastapi #input-validation #security #model-routing #result-normalization

A JavaScript module that orchestrates the full map-click identification workflow: coordinate normalization (WGS84/GCJ02), parallel calls to reverse geocoding, POI search, and vision AI, then combines results into a structured lead with a calculated score and priority. It demonstrates clean adapter pattern, Promise.allSettled usage, multi-factor scoring (distance, address overlap, contact availability, roof status), and a fallback chain. The logic is self-contained and could be extracted as a reusable service layer for any map-based lead generation system.

file: snippets/map-click-identify.js ↗ | tags: #async-workflow #coordinate-transformation #poi-matching #scoring #lead-generation

A photovoltaic generation forecasting pipeline that converts weather features, capacity, and calendar signals into daily energy and revenue forecasts. It implements a clean feature engineering stage (weather score, season encoding, daylight hours), model resolution with fallback chain (LightGBM, XGBoost, Transformer, formula), and confidence estimation. The pipeline is well-structured with dataclasses, type hints, validation, and a separate evaluation function (MAE, RMSE, MAPE). The pattern is reusable for any time-series forecasting system with multiple model backends.

file: snippets/pv-forecast-transformer.py ↗ | tags: #feature-engineering #model-routing #fallback #forecasting #evaluation
Last analyzed: 2026-08-11 16:25:07.538019
Next check: 2026-11-09 16:25:07.533453
$ submit: