README.md

---
title: Agent Analityczny
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: streamlit
sdk_version: "1.28.1"
app_file: app.py
pinned: false
---

# 🤖 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**