Update README.md

README.md

@@ -1,20 +1,111 @@
+---
 title: Agent Analityczny
 emoji: 🤖
 colorFrom: blue
 colorTo: green
 sdk: streamlit
-sdk_version: 1.28.1
+sdk_version: "1.28.1"
 app_file: app.py
 pinned: false
-license: mit
-🤖 Agent Analityczny
-Inteligentna analiza danych CSV z wykorzystaniem AI. Wczytaj plik CSV, zadawaj pytania w naturalnym języku, a aplikacja automatycznie wygeneruje kod Python i utworzy wykresy!
-Funkcje:
-
-🔍 Automatyczne wykrywanie formatu CSV
-🧠 Analiza przez AI (DeepSeek)
-📊 Automatyczne tworzenie wykresów
-💬 Pytania w naturalnym języku
-📜 Historia analiz
-
-Potrzebujesz klucza API DeepSeek - załóż konto na platform.deepseek.com
+---
+
+# 🤖 Agent Analityczny
+
+**Inteligentna analiza danych CSV z pomocą sztucznej inteligencji!**
+
+Agent Analityczny to zaawansowane narzędzie wykorzystujące DeepSeek AI do automatycznej analizy plików CSV. Zadawaj pytania w naturalnym języku, a AI wygeneruje kod Python i utworzy profesjonalne wykresy!
+
+## 🎯 Funkcjonalności
+
+* **🔍 Inteligentne wczytywanie** - Automatyczne wykrywanie formatu CSV (separator, kodowanie)
+* **🧠 Analiza przez AI** - Zadawaj pytania po polsku, otrzymuj kod Python i interpretację
+* **📊 Automatyczne wykresy** - Histogramy, wykresy słupkowe, scatter plots generowane przez AI
+* **⚡ Szybkie analizy** - Gotowe przyciski dla podstawowych statystyk
+* **📜 Historia sesji** - Śledź wszystkie wykonane analizy i buduj na poprzednich wynikach
+* **🛡️ Bezpieczne wykonanie** - Kod wykonywany w sandboxie z pełnym logowaniem
+* **🎨 Ręczne ustawienia** - Możliwość manualnej konfiguracji formatu pliku
+
+## 📁 Obsługiwane formaty
+
+* **Separatory:** `;` `,` `tab` `|`
+* **Kodowania:** UTF-8, CP1250, Latin1, ISO-8859-1
+* **Pliki:** CSV, TXT z danymi tabelarycznymi
+* **Automatyczne wykrywanie** najlepszych ustawień
+
+## 🚀 Jak używać
+
+1. **Wklej klucz API** - Wprowadź swój klucz DeepSeek API w lewym panelu
+2. **Wczytaj plik CSV** - Aplikacja automatycznie wykryje format i kodowanie
+3. **Zadawaj pytania** - Pisz po polsku: "Pokaż histogram wieku", "Top 10 kategorii"
+4. **Analizuj wyniki** - Otrzymuj kod Python, wykresy i interpretację AI
+5. **Buduj dalej** - Korzystaj z historii analiz do kolejnych pytań
+
+## 💬 Przykłady pytań
+
+### Podstawowe statystyki
+* "Ile jest wierszy w danych?"
+* "Pokaż podstawowe statystyki numeryczne"
+* "Jakie są unikalne wartości w kolumnie zawód?"
+
+### Wykresy i wizualizacje
+* "Stwórz histogram dla kolumny balance"
+* "Wykres słupkowy najczęstszych zawodów"
+* "Scatter plot: wiek vs balans"
+* "Rozkład kategorii edukacji"
+
+### Zaawansowane analizy
+* "Top 10 klientów z najwyższym balansem"
+* "Średni balans według zawodu z wykresem"
+* "Porównaj grupy wiekowe"
+* "Znajdź korelacje między kolumnami liczbowymi"
+
+## 🔧 Technologie
+
+* **Streamlit** - Interaktywny interface użytkownika
+* **DeepSeek AI** - Generowanie kodu Python i interpretacja wyników
+* **Pandas** - Analiza i manipulacja danych
+* **Matplotlib** - Tworzenie wykresów i wizualizacji
+* **NumPy** - Obliczenia numeryczne
+
+## 🔑 Klucz API DeepSeek
+
+Aby korzystać z aplikacji, potrzebujesz klucza API DeepSeek:
+
+1. Idź na [platform.deepseek.com](https://platform.deepseek.com)
+2. Załóż bezpłatne konto
+3. Wygeneruj klucz API w panelu użytkownika
+4. Wklej klucz w aplikacji (lewy panel)
+
+## 🎓 Dla kogo?
+
+* **Analitycy danych** - Szybka eksploracja nowych zbiorów danych
+* **Badacze** - Automatyczna analiza wyników badań
+* **Studenci** - Nauka analizy danych przez praktykę
+* **Przedsiębiorcy** - Analiza danych sprzedażowych i klientów
+* **Dziennikarze** - Analiza danych do artykułów i reportaży
+
+## 🛡️ Bezpieczeństwo
+
+* **Sandbox wykonania** - Kod wykonywany w bezpiecznym środowisku
+* **Filtrowanie operacji** - Automatyczne usuwanie potencjalnie niebezpiecznych komend
+* **Tylko analiza** - Brak możliwości zapisywania/modyfikacji plików
+* **Szczegółowe logi** - Pełna transparentność wykonywanych operacji
+
+## 💡 Wskazówki
+
+* **Używaj słów kluczowych**: "histogram", "wykres", "rozkład", "porównanie"
+* **Bądź konkretny**: "histogram kolumny wiek" zamiast "pokaż wykres"
+* **Eksperymentuj**: Aplikacja radzi sobie z różnymi stylami pytań
+* **Korzystaj z historii**: Buduj analizy na poprzednich wynikach
+
+## ⚠️ Disclaimer
+
+Wyniki analizy są generowane przez AI i mogą wymagać weryfikacji przez eksperta. Aplikacja jest narzędziem wspomagającym analizę danych, nie zastępuje profesjonalnej wiedzy statystycznej.
+
+## 🤝 Wsparcie
+
+Jeśli masz pytania lub sugestie dotyczące aplikacji, skontaktuj się poprzez Hugging Face Discussions.
+
+**Powered by DeepSeek AI** 🚀
+
+Check out the configuration reference at **https://huggingface.co/docs/hub/spaces-config-reference**