data-sense-agent / README.md
Marek4321's picture
Update README.md
9eacc90 verified
---
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**