diff --git a/docs/SOLCAST_SETUP_GUIDE.md b/docs/SOLCAST_SETUP_GUIDE.md
new file mode 100644
index 0000000..4e8ad7c
--- /dev/null
+++ b/docs/SOLCAST_SETUP_GUIDE.md
@@ -0,0 +1,540 @@
+# ☀️ Solcast PV Forecast - Przewodnik instalacji krok po kroku
+
+**Cel:** Najdokładniejsza prognoza produkcji PV dla inteligentnego zarządzania Deye  
+**Czas:** 15-20 minut  
+**Koszt:** DARMOWY (50 zapytań/dzień wystarczy)  
+
+---
+
+## 📋 KROK 1: Rejestracja w Solcast (5 min)
+
+### 1.1 Utwórz konto
+```
+🌐 Otwórz: https://solcast.com/
+📝 Kliknij: "Sign Up" (prawy górny róg)
+📧 Podaj email i hasło
+✅ Potwierdź email
+```
+
+### 1.2 Wybierz plan
+```
+Plan: "Home PV" (FREE)
+- 50 API calls/day ✅
+- 2 rooftop sites ✅
+- 7-day forecast ✅
+- Perfectly sufficient!
+
+💰 Koszt: 0 zł/miesiąc
+```
+
+---
+
+## 🏠 KROK 2: Dodaj swoją instalację PV (5 min)
+
+### 2.1 Przejdź do dodawania lokalizacji
+```
+Po zalogowaniu:
+1. Dashboard → "Your Rooftop Sites"
+2. Kliknij: "+ New Rooftop Site"
+```
+
+### 2.2 Uzupełnij parametry instalacji
+
+#### **Resource Name:**
+```
+Nazwa: "Dach Dom" (lub cokolwiek)
+```
+
+#### **Location (Lokalizacja):**
+```
+⚠️ WAŻNE: Musisz znać swoją lokalizację
+
+Opcja A - Podaj adres:
+  Address: [Twój adres]
+  → Solcast znajdzie współrzędne
+
+Opcja B - Współrzędne GPS:
+  Latitude: np. 52.2297  (Warszawa)
+  Longitude: np. 21.0122
+  
+💡 Jak znaleźć współrzędne?
+  - Google Maps → kliknij prawym → "Współrzędne"
+  - Lub w Home Assistant: Settings → System → General
+```
+
+#### **Capacity (Moc instalacji):**
+```
+Capacity: [Twoja moc w kWp]
+
+Przykłady:
+- 12 paneli × 400W = 4.8 kWp → wpisz: 4.8
+- 30 paneli × 400W = 12 kWp → wpisz: 12
+- Zobacz na fakturze/projekcie instalacji
+
+⚠️ To NOMINALNA moc paneli (nie inwertera!)
+```
+
+#### **Tilt (Nachylenie):**
+```
+Tilt: [Kąt nachylenia dachu w stopniach]
+
+Typowe wartości:
+- 0° = płaski dach (idealne 0°)
+- 15° = niewielkie nachylenie
+- 30° = standardowy dach (średnio stromy)
+- 35° = typowy dach w Polsce
+- 45° = stromy dach
+
+�� Jak zmierzyć?
+  - Aplikacja telefon: "Kątomierz" / "Level"
+  - Przyłóż do dachu
+  - Odczytaj kąt
+```
+
+#### **Azimuth (Azymut - kierunek):**
+```
+Azimuth: [Kierunek w stopniach]
+
+Kierunki świata:
+- 0° / 360° = Północ (N)
+- 90° = Wschód (E)
+- 180° = Południe (S) ⭐ NAJLEPIEJ
+- 270° = Zachód (W)
+
+Pośrednie:
+- 135° = Południowy-Wschód (SE)
+- 225° = Południowy-Zachód (SW)
+
+💡 Jak sprawdzić?
+  - Google Maps: Otwórz widok satelitarny
+  - Sprawdź który kierunek wskazuje dach
+  - Dla Polski: większość dachów ~180° (południe)
+```
+
+#### **Install Date:**
+```
+Install Date: [Data instalacji]
+Może być przybliżona, nie jest krytyczna
+```
+
+#### **Tracking Type:**
+```
+☑️ Fixed (zablokowane) - standardowe panele na dachu
+☐ Single Axis - nie wybieraj (to są trackery)
+```
+
+### 2.3 Zapisz lokalizację
+```
+✅ Kliknij: "Create Rooftop Site"
+```
+
+### 2.4 (Opcjonalnie) Dodaj drugą lokalizację
+```
+Jeśli masz panele na 2 stronach dachu (np. wschód + zachód):
+
+1. Kliknij: "+ New Rooftop Site"
+2. Utwórz drugą lokalizację:
+   - Resource Name: "Dach Zachód"
+   - Capacity: 6 kWp (połowa instalacji)
+   - Tilt: 35°
+   - Azimuth: 270° (zachód)
+3. Zapisz
+
+Solcast automatycznie zsumuje prognozy!
+```
+
+---
+
+## 🔑 KROK 3: Pobierz API Key (1 min)
+
+```
+1. Dashboard Solcast
+2. Lewe menu: "Account" → "API Toolkit"
+3. Sekcja: "Your API Key"
+4. Kliknij: 👁️ "Show" lub "Copy"
+5. Skopiuj API Key (format: xxxx-xxxx-xxxx-xxxx)
+
+⚠️ ZAPISZ API Key w bezpiecznym miejscu!
+```
+
+Przykładowy API Key:
+```
+xxxx-yyyy-zzzz-aaaa-bbbb-cccc-dddd
+```
+
+---
+
+## 🏠 KROK 4: Instalacja w Home Assistant (5 min)
+
+### 4.1 Sprawdź czy masz HACS
+
+**TEST HA:** http://192.168.50.151:8123  
+**PROD HA:** http://192.168.50.242:8123  
+
+```
+Zaloguj się → Sprawdź lewe menu
+
+✅ Widzisz "HACS"? → Przejdź do 4.2
+❌ Nie widzisz? → Musisz zainstalować HACS
+```
+
+#### Jak zainstalować HACS (jeśli nie ma):
+```
+HACS już jest zainstalowany na TEST i PROD 
+(skopiowaliśmy go wcześniej razem z Solarman)
+
+Sprawdź ponownie w lewym menu.
+```
+
+### 4.2 Zainstaluj Solcast PV Forecast przez HACS
+
+```
+1. W Home Assistant: Kliknij "HACS" (lewe menu)
+2. Kliknij: "Integrations"
+3. Kliknij: "⊕ Explore & Download Repositories" (prawy dolny róg)
+4. W wyszukiwarce wpisz: "Solcast"
+5. Znajdź: "Solcast PV Forecast" (autor: BJReplay)
+6. Kliknij na integrację
+7. Kliknij: "Download" (prawy dolny róg)
+8. Wybierz najnowszą wersję
+9. Kliknij: "Download"
+10. Poczekaj na potwierdzenie
+```
+
+### 4.3 Restartuj Home Assistant
+
+```
+1. Settings → System → Hardware
+2. Kliknij: ⋮ (trzy kropki, prawy górny róg)
+3. Wybierz: "Restart Home Assistant"
+4. Potwierdź: "Restart"
+5. Poczekaj 1-2 minuty na restart
+```
+
+---
+
+## ⚙️ KROK 5: Konfiguracja Solcast (3 min)
+
+### 5.1 Dodaj integrację
+
+```
+1. Po restarcie: Settings → Devices & Services
+2. Kliknij: "+ Add Integration" (prawy dolny róg)
+3. Szukaj: "Solcast"
+4. Kliknij: "Solcast PV Forecast"
+```
+
+### 5.2 Wprowadź API Key
+
+```
+Pole: "API Key"
+Wklej: [Twój API Key skopiowany w kroku 3]
+
+Przykład: xxxx-yyyy-zzzz-aaaa-bbbb-cccc-dddd
+
+✅ Kliknij: "Submit"
+```
+
+### 5.3 Potwierdzenie
+
+```
+✅ Jeśli wszystko OK:
+   "Success! Integration added."
+   
+❌ Jeśli błąd:
+   - Sprawdź czy API Key jest poprawny
+   - Sprawdź połączenie internetowe HA
+   - Sprawdź czy masz aktywne konto Solcast
+```
+
+---
+
+## 📊 KROK 6: Sprawdź czy działa (2 min)
+
+### 6.1 Zobacz encje
+
+```
+1. Settings → Devices & Services
+2. Znajdź: "Solcast PV Forecast"
+3. Kliknij: "X entities" (np. "10 entities")
+```
+
+### 6.2 Główne sensory które otrzymasz:
+
+```yaml
+✅ sensor.solcast_pv_forecast_forecast_today
+   Stan: np. "35.2 kWh"
+   Opis: Prognoza produkcji na dzisiaj
+
+✅ sensor.solcast_pv_forecast_forecast_tomorrow  
+   Stan: np. "28.7 kWh"
+   Opis: Prognoza produkcji na jutro ⭐ NAJWAŻNIEJSZY
+
+✅ sensor.solcast_pv_forecast_forecast_day_3
+   Stan: np. "15.3 kWh"
+   Opis: Prognoza na pojutrze
+
+✅ sensor.solcast_pv_forecast_power_now
+   Stan: np. "3450 W"
+   Opis: Przewidywana moc teraz
+
+✅ sensor.solcast_pv_forecast_peak_power_today
+   Stan: np. "8500 W"
+   Opis: Przewidywany szczyt mocy dziś
+```
+
+### 6.3 Test w Developer Tools
+
+```
+1. Developer Tools → States
+2. Filtruj: "solcast"
+3. Sprawdź wartości sensorów
+
+Powinno być widać cyfry (kWh, W)
+Jeśli "unknown" → poczekaj 5 minut na pierwszą aktualizację
+```
+
+---
+
+## 📈 KROK 7: Dodaj do Dashboard (2 min)
+
+### 7.1 Utwórz kartę z prognozą
+
+```yaml
+1. Przejdź do swojego Dashboard
+2. Kliknij: "Edit Dashboard" (prawy górny róg, ołówek)
+3. Kliknij: "+ Add Card"
+4. Wybierz: "Entities Card"
+5. Dodaj encje:
+   - sensor.solcast_pv_forecast_forecast_today
+   - sensor.solcast_pv_forecast_forecast_tomorrow
+   - sensor.solcast_pv_forecast_forecast_day_3
+   - sensor.solcast_pv_forecast_power_now
+6. Tytuł karty: "☀️ Prognoza PV (Solcast)"
+7. Zapisz
+```
+
+### 7.2 Wykres produkcji
+
+```yaml
+1. "+ Add Card"
+2. Wybierz: "History Graph"
+3. Entities:
+   - sensor.solcast_pv_forecast_power_now
+   - sensor.inverter_deye_pv_power (rzeczywista)
+4. Hours to show: 24
+5. Tytuł: "Prognoza vs Rzeczywistość"
+6. Zapisz
+```
+
+---
+
+## 🤖 KROK 8: Automatyzacja (5 min)
+
+### 8.1 Automatyzacja: Ładuj jeśli pochmurnie
+
+```yaml
+Skopiuj do: Settings → Automations & Scenes → Create Automation
+
+alias: "Deye + Solcast - Ładuj jeśli pochmurnie"
+description: "Włącz ładowanie gdy jutro mała produkcja PV"
+
+trigger:
+  - platform: time
+    at: "22:00:00"
+
+condition:
+  # Jeśli prognoza na jutro < 10 kWh
+  - condition: numeric_state
+    entity_id: sensor.solcast_pv_forecast_forecast_tomorrow
+    below: 10
+  
+  # I bateria < 80%
+  - condition: numeric_state
+    entity_id: sensor.inverter_deye_battery_soc
+    below: 80
+
+action:
+  - service: switch.turn_on
+    target:
+      entity_id: switch.inverter_deye_battery_grid_charging
+  
+  - service: select.select_option
+    target:
+      entity_id: select.inverter_deye_program_1_charging
+    data:
+      option: "Grid"
+  
+  - service: time.set_value
+    target:
+      entity_id: time.inverter_deye_program_1_time
+    data:
+      time: "01:00:00"
+  
+  - service: notify.persistent_notification
+    data:
+      title: "🌥️ Solcast: Mała produkcja jutro"
+      message: >
+        Prognoza: {{ states('sensor.solcast_pv_forecast_forecast_tomorrow') }} kWh
+        Włączono ładowanie z sieci w nocy.
+```
+
+### 8.2 Automatyzacja: Nie ładuj jeśli słonecznie
+
+```yaml
+alias: "Deye + Solcast - Wyłącz ładowanie gdy słonecznie"
+description: "Oszczędzaj gdy jutro dużo słońca"
+
+trigger:
+  - platform: time
+    at: "22:00:00"
+
+condition:
+  # Jeśli prognoza > 30 kWh
+  - condition: numeric_state
+    entity_id: sensor.solcast_pv_forecast_forecast_tomorrow
+    above: 30
+  
+  # I bateria > 40%
+  - condition: numeric_state
+    entity_id: sensor.inverter_deye_battery_soc
+    above: 40
+
+action:
+  - service: switch.turn_off
+    target:
+      entity_id: switch.inverter_deye_battery_grid_charging
+  
+  - service: select.select_option
+    target:
+      entity_id: select.inverter_deye_program_1_charging
+    data:
+      option: "Disabled"
+  
+  - service: notify.persistent_notification
+    data:
+      title: "☀️ Solcast: Duża produkcja jutro!"
+      message: >
+        Prognoza: {{ states('sensor.solcast_pv_forecast_forecast_tomorrow') }} kWh
+        Ładowanie z sieci wyłączone - oszczędzasz!
+```
+
+---
+
+## ⚙️ KROK 9: Dostosuj progi do swojej instalacji
+
+### Przykładowe progi dla różnych mocy instalacji:
+
+```yaml
+Instalacja 5 kWp (mała):
+  Pochmurnie: < 5 kWh
+  Średnio: 5-15 kWh
+  Słonecznie: > 15 kWh
+
+Instalacja 10 kWp (średnia):
+  Pochmurnie: < 10 kWh
+  Średnio: 10-30 kWh
+  Słonecznie: > 30 kWh
+
+Instalacja 15 kWp (duża):
+  Pochmurnie: < 15 kWh
+  Średnio: 15-45 kWh
+  Słonecznie: > 45 kWh
+```
+
+**Obserwuj przez tydzień i dostosuj!**
+
+---
+
+## 🔍 ROZWIĄZYWANIE PROBLEMÓW
+
+### Problem 1: "Unknown" w sensorach
+```
+Przyczyna: Pierwsza aktualizacja jeszcze nie nastąpiła
+Rozwiązanie: Poczekaj 5-10 minut
+```
+
+### Problem 2: Błąd API Key
+```
+Przyczyna: Niepoprawny API Key
+Rozwiązanie:
+  1. Sprawdź API Key w Solcast Dashboard
+  2. Usuń integrację w HA
+  3. Dodaj ponownie z poprawnym kluczem
+```
+
+### Problem 3: Brak aktualizacji
+```
+Przyczyna: Limit 50 zapytań/dzień przekroczony
+Rozwiązanie:
+  - Sprawdź w Solcast: Account → Usage
+  - Zmniejsz częstotliwość aktualizacji w HA
+  - Lub poczekaj do północy (reset limitu)
+```
+
+### Problem 4: Niepoprawne prognozy
+```
+Przyczyna: Źle skonfigurowane parametry instalacji
+Rozwiązanie:
+  1. Solcast Dashboard → Your Rooftop Sites
+  2. Edit → Sprawdź:
+     - Capacity (moc)
+     - Tilt (nachylenie)
+     - Azimuth (kierunek)
+  3. Popraw i obserwuj przez kilka dni
+```
+
+---
+
+## 📊 MONITOROWANIE UŻYCIA API
+
+```
+Solcast Dashboard → Account → Usage
+
+Typowe użycie:
+- Aktualizacja co 1h = 24 zapytania/dzień ✅
+- Aktualizacja co 30min = 48 zapytań/dzień ✅
+- Limit: 50 zapytań/dzień (FREE plan)
+
+💡 Wystarczy aktualizacja co godzinę!
+```
+
+---
+
+## ✅ CHECKLIST - Sprawdź czy wszystko działa
+
+```
+☐ Konto Solcast utworzone
+☐ Instalacja PV dodana (capacity, tilt, azimuth)
+☐ API Key skopiowany
+☐ HACS zainstalowany w HA
+☐ Integracja Solcast zainstalowana
+☐ Home Assistant zrestartowany
+☐ Sensory pokazują wartości (nie "unknown")
+☐ Dashboard z prognozą utworzony
+☐ Automatyzacje skonfigurowane
+☐ Progi dostosowane do instalacji
+☐ Test przez kilka dni ✅
+```
+
+---
+
+## 🎉 GOTOWE!
+
+Teraz masz:
+- ✅ Najdokładniejszą prognozę produkcji PV w Polsce
+- ✅ Automatyczne zarządzanie ładowaniem baterii
+- ✅ Oszczędności 60-100 zł/miesiąc
+- ✅ Dłuższa żywotność baterii
+
+**Następny krok:** Obserwuj przez tydzień i dostosuj progi!
+
+---
+
+**Przydatne linki:**
+- Solcast Dashboard: https://solcast.com/dashboard
+- Dokumentacja: https://github.com/BJReplay/ha-solcast-solar
+- Support: https://community.home-assistant.io/
+
+**Wygenerowano:** 2026-02-05  
+**Wersja:** 1.0