README.md

metadata

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
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