Skip to content

Artisa111/databot-analytics

Repository files navigation

Python 3.10+ Streamlit GitHub Stars PRs welcome

Open Streamlit App Open Telegram Bot Deploy on Railway

🇮🇱 עברית🇺🇸 English


🧠📊 דאטאבוט אנליטיקס

אפליקציית Streamlit ובוט טלגרם לניתוח נתונים

ברוכים הבאים ל־DataBot Analytics — שילוב חכם בין אפליקציית Streamlit ידידותית למשתמש לבין בוט טלגרם שמאפשר לכם לחקור, לנתח ולהמחיש נתונים במהירות, מכל מקום.

✨ תקציר

  • 📊 אפליקציה מתקדמת: הצגת וניתוח נתונים עם Streamlit
  • 🤖 בוט טלגרם חכם: ניתוח נתונים ישירות מהטלפון
  • 📁 העלאת קבצים: תמיכה ב-CSV, Excel, JSON
  • 📈 תרשימים דינמיים: חקירה אינטראקטיבית ותובנות
  • פקודות מהירות: סטטיסטיקה, גרפים ושיתוף

🖼️ גלריה

🏠 מסך הבית של האפליקציה

מסך הבית — DataBot Analytics

מסך בית אינטואיטיבי עם ניווט מהיר וטעינת דוגמאות נתונים

🤖 בוט טלגרם

דוגמת גרף Pair Plot מהבוט

גרפים אוטומטיים ותרשימי ניתוח

פקודות הבוט בטלגרם

ממשק הבוט והפקודות הזמינות

📊 דוגמת ניתוח נתונים

ניתוח Pair Plot

ניתוח מתקדם עם מטריצת קורלציות ותרשימי פיזור

🎯 תכונות האפליקציה

  • 📂 העלאת קבצים: CSV / Excel / JSON
  • 🔍 חקירה מהירה: סינון, מיון, חיתוכים, חיפוש
  • 📈 תרשימים אינטראקטיביים: קווי, עמודות, פאי, מפוזר, היסטוגרמה
  • 📊 סטטיסטיקה תיאורית: ממוצע, חציון, סטיית תקן, קורלציות
  • ניתוח סדרות זמן: אגרגציות לפי תאריך/שעה
  • 💾 ייצוא: הורדת גרפים/טבלאות כתמונה או CSV
  • 📱 ממשק רספונסיבי: ידידותי למובייל ודסקטופ
  • 🤖 עוזר חכם: DataBot לשאלות ותשובות על הנתונים

🤖 פקודות הבוט

  • /start — התחלה מהירה והנחיות שימוש
  • /help — רשימת פקודות והסברים
  • /upload — שליחת קובץ נתונים (CSV/Excel/JSON)
  • /stats — תקציר סטטיסטי מהיר של הקובץ
  • /plot — יצירת גרפים (בחרו עמודות וסוג תרשים)
  • /sample — דוגמת שורות מהנתונים
  • /export — קבלת תרשים/טבלה כקובץ להורדה
  • /settings — הגדרות שפה/פורמט/ברירת מחדל
  • /about — מידע על DataBot Analytics

🛠 התקנה והרצה מקומית

לחץ להרחבת הוראות ההתקנה

1. שכפול הריפו

git clone https://github.com/Artisa111/databot-analytics.git
cd databot-analytics

2. יצירת סביבת פייתון והתקנת חבילות

python -m venv .venv
source .venv/bin/activate  # ב-Windows: .venv\Scripts\activate
pip install -r requirements.txt

3. משתני סביבה

export TELEGRAM_BOT_TOKEN=<הטוקן_שלכם>
export PORT=

4. הרצת האפליקציה

streamlit run app.py --server.port 85_ _ --server.address 0.0.0.0

5. הרצת הבוט

python bot_runner.py

☁️ פריסה ל‑Railway

שלבי הפריסה:

  1. התחברו ל־Railway והקימו פרויקט חדש מהריפו
  2. הגדירו Services נפרדים:
    • Web (Streamlit): streamlit run app.py --server.port $PORT --server.address 0.0.0.0
    • Worker (Bot): python bot_runner.py
  3. הגדירו משתני סביבה: TELEGRAM_BOT_TOKEN, PORT
  4. עקבו אחרי הלוגים עד שהשירותים פעילים

🤝 תרומה

  • 🔄 מזמינים Pull Requests ושיפורים
  • 🐛 פתחו Issue להצעות/באגים
  • 📝 שמרו על קוד נקי ותיעוד קצר ב־PR

📬 יצירת קשר

📣 שתפו את הפרויקט

⭐ תמיכה

אם אהבתם את הפרויקט — תנו כוכב ⭐ לריפו והוסיפו מעקב כדי להתעדכן!

GitHub Stars GitHub Watchers

🧠📊 DataBot Analytics

Streamlit App & Telegram Bot for Data Analysis

Welcome to DataBot Analytics — a friendly Streamlit web app paired with a Telegram bot so you can explore, analyze, and visualize data quickly from anywhere.

✨ Overview

  • 📊 Advanced App: Data visualization and analysis with Streamlit
  • 🤖 Smart Telegram Bot: Data analysis directly from your phone
  • 📁 File Upload: Support for CSV, Excel, JSON
  • 📈 Dynamic Charts: Interactive exploration and insights
  • Quick Commands: Statistics, graphs, and sharing

🖼️ Gallery

🏠 App Home Screen

DataBot Analytics — Home screen

Clean home screen with quick navigation and demo data loaders

🤖 Telegram Bot Interface

Telegram bot — commands

Bot interface and available commands

Telegram bot — pair plot example

Automatic visualizations and analysis charts

📊 Data Analysis Example

Pair Plot Analysis

Advanced analysis with correlation matrix and scatter plots

🎯 App Features

  • 📂 File Upload: CSV / Excel / JSON
  • 🔍 Fast Exploration: Filter, sort, slice, search
  • 📈 Interactive Charts: Line, bar, pie, scatter, histogram
  • 📊 Descriptive Stats: Mean, median, std, correlations
  • Time-Series Analysis: Date/time groupings and aggregations
  • 💾 Export: Download charts/tables as images or CSV
  • 📱 Responsive Design: Mobile and desktop friendly
  • 🤖 Smart Assistant: DataBot for data Q&A

🤖 Bot Commands

  • /start — Quick onboarding and usage guide
  • /help — List of commands and explanations
  • /upload — Send a data file (CSV/Excel/JSON)
  • /stats — Quick statistical summary of your file
  • /plot — Generate charts (choose columns and chart type)
  • /sample — Show a sample of rows from your data
  • /export — Receive chart/table as a downloadable file
  • /settings — Language/format/defaults
  • /about — Info about DataBot Analytics

🛠 Install & Run Locally

Click to expand installation instructions

1. Clone the repository

git clone https://github.com/Artisa111/databot-analytics.git
cd databot-analytics

2. Create virtual environment and install dependencies

python -m venv .venv
source .venv/bin/activate  # on Windows: .venv\Scripts\activate
pip install -r requirements.txt

3. Environment variables

export TELEGRAM_BOT_TOKEN=<your_token_here>
export PORT=

4. Run the app

streamlit run app.py --server.port 85_ _ --server.address 0.0.0.0

5. Run the bot

python bot_runner.py

☁️ Deploy to Railway

Deployment Steps:

  1. Sign in to Railway and create a new project from this repo
  2. Configure separate services:
    • Web (Streamlit): streamlit run app.py --server.port $PORT --server.address 0.0.0.0
    • Worker (Bot): python bot_runner.py
  3. Set environment variables: TELEGRAM_BOT_TOKEN, PORT
  4. Deploy and monitor logs until both services are healthy

🤝 Contributing

  • 🔄 Pull Requests are welcome!
  • 🐛 Open an Issue for feature requests/bug reports
  • 📝 Keep code clean and include concise PR descriptions

📬 Contact

📣 Share this Project

⭐ Support

If you like this project, please star ⭐ the repo and follow for updates!

GitHub Stars GitHub Watchers

🚀 Ready to get started?

Choose your preferred way to explore DataBot Analytics:

Try Web App Chat with Bot Deploy on Railway

💜 נוצר באהבה לאנליטיקת נתונים

About

Telegram bot with web interface for data analytics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors