# amprex

> Forecast-driven, privacy-preserving Smart Energy Management System (EMS).

amprex is a highly stable, intelligent, and secure local energy management system built on advanced hardware. By utilizing real-time solar generation predictions, load consumption forecasts, and dynamic grid tariff schedules, amprex optimizes your battery storage, EV charging, and HVAC operations. It maximizes cost savings and guarantees grid compliance while ensuring physical device safety and full offline preservation.

---

## Core Capabilities

### Forecast-Driven Optimization
Performs advanced predictive dispatch using high-resolution weather radiation projections, local solar generation capability, historical household consumption telemetry, and multi-window dynamic grid pricing.

### Physical Safety & Extreme Stability
Operates directly on-premise (e.g., Raspberry Pi 5 core). Implements strict fail-safe state machines that automatically protect equipment and battery cells even during total internet or cloud outages.

### Modular Device Integration
Coordinates seamlessly with major hardware components using standardized driver templates:
- **BESS (Battery Energy Storage Systems)**
- **PV Inverters (Solar Systems)**
- **EV Chargers**
- **HVAC (Heat Pumps and Smart Heating)**
- **Grid and Consumption Smart Meters**

---

## Technical Specifications

### Telemetry Signage Logic
To ensure mathematical consistency across all dashboards, automation rules, and models:
- **Directional Metrics**: `_IMPORT`, `_EXPORT`, `_CHARGE`, and `_DISCHARGE` represent absolute energy flows and are strictly non-negative (`>= 0`).
- **Cumulative Sums**: `_TOTAL` is a signed value. A positive sign (`+`) indicates importing/charging (drawing from grid or charging battery), while a negative sign (`-`) indicates exporting/discharging (exporting to grid or discharging battery).

### Tariff Window Scheduling
Schedules are stored dynamically under `time_ranges` within the `TariffScheduleRuleEntity` database scheme. Rules supports multi-range daily timeframes allowing complex peak, off-peak, and shoulder optimizations.

---

## Licensing Tiers

### LITE (Effective locally when unpaired)
- Configuration of up to 5 local devices.
- Basic, local rule-based HVAC controls.
- Basic local weather forecasts.
- Real-time telemetry dashboard.

### PLUS
- Local, on-device Machine Learning (ML) solar and load forecasts.
- Advanced HVAC Smart-Mode temperature scheduling.
- Unlimited device integrations.
- Cloud alerts and email notification suite.

### PRO & INDUSTRIAL
- Cloud-scale ML+AI predictive forecasts.
- Multi-controller cluster coordination.
- Comprehensive REST and MCP developer API access.
- High-frequency industrial telemetry streaming.

---

## Machine Readable Integrations

AI agents, developer pipelines, and LLM integrations can discover our services via:
- **MCP Server Card**: `https://amprex.app/.well-known/mcp/server-card.json`
- **REST API OpenAPI Specification**: `https://api.amprex.app/openapi.json`
- **General API Catalog**: `https://amprex.app/.well-known/api-catalog`
- **System Documentation**: `https://amprex.app/llms.txt`

---

## Get in Touch

For inquiries, support requests, or enterprise licensing:
- **Website**: [https://amprex.app](https://amprex.app)
- **Email**: [hello@ksoft.tech](mailto:hello@ksoft.tech)
- **Company**: KSoft.TECH (Slovenia, EU)