Polish Energy Prices
Projekt oblicza bieżącą cenę brutto 1 kWh dla gospodarstw domowych
przyłączonych do jednego z pięciu największych OSD: TAURON, PGE, ENERGA, Stoen
i ENEA. Można go używać jako natywnej integracji Home Assistant albo jako
niezależnej usługi Docker z HTTP i MQTT dla openHAB oraz innych systemów.
W Home Assistant encja ma jednostkę PLN/kWh i może zostać wskazana w panelu
Energia jako encja z bieżącą ceną. Kontener publikuje tę samą cenę wraz ze
składnikami przez API HTTP i retained MQTT.
Silnik łączy cenę energii czynnej sprzedawcy z urzędu z właściwym dla
aktualnej godziny składnikiem sieciowym, opłatą jakościową, OZE,
kogeneracyjną i VAT-em. Co 12 godzin sprawdza cenę sprzedaży energii oraz
urzędowe źródła wszystkich zmiennych składników rachunku. Ostatni poprawny,
kompletny zestaw jest zapisywany lokalnie; przy awarii źródła używany jest
cache, a przy pierwszym uruchomieniu — zweryfikowane stawki wbudowane.
[!IMPORTANT]
Stawki wbudowane są bezpiecznym punktem startowym na okres 1.01–31.12.2026,
ale nie są już jedynym źródłem. Integracja wykrywa dokument na bieżący rok,
sprawdza kompletność wszystkich stref i dopiero wtedy aktywuje nowy zestaw.
Jeżeli nowa taryfa nie zostanie opublikowana albo zmieni się układ dokumentu,
wygasły zestaw nie jest używany po swojej dacie końcowej. Sensor albo profil
kontenera staje się niedostępny i pokazuje błąd źródła.
Docker, openHAB i inne systemy
Publiczny obraz działa na amd64 i arm64. Nie wymaga Home Assistanta ani
logowania do GHCR:
ghcr.io/jchrzaniuk/polish-energy-prices:latest
ghcr.io/jchrzaniuk/polish-energy-prices:v1.5.0
Uruchomienie gotowego obrazu
Potrzebujesz Docker Engine z poleceniem docker compose oraz działającego
brokera MQTT.
-
Pobierz repozytorium i przejdź do jego katalogu:
git clone https://github.com/jchrzaniuk/PolishEnergyPrices.git
cd PolishEnergyPrices
-
Utwórz własny plik konfiguracji:
cp service/config.example.yaml service/config.yaml
-
W service/config.yaml ustaw operatora, taryfę i źródło ceny. Zmień też
mqtt.host z przykładowego mqtt na adres brokera widoczny z kontenera.
W razie potrzeby wpisz użytkownika i hasło przez zmienne opisane w
pełnej instrukcji usługi.
-
Uruchom kontener:
docker compose up -d