Marek4321/data-sense-agent

🤖 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. 1.Wklej klucz API - Wprowadź swój klucz DeepSeek API w lewym panelu
2. 2.Wczytaj plik CSV - Aplikacja automatycznie wykryje format i kodowanie
3. 3.Zadawaj pytania - Pisz po polsku: "Pokaż histogram wieku", "Top 10 kategorii"
4. 4.Analizuj wyniki - Otrzymuj kod Python, wykresy i interpretację AI
5. 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. 1.Idź na platform.deepseek.com
2. 2.Załóż bezpłatne konto
3. 3.Wygeneruj klucz API w panelu użytkownika
4. 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