🤖 ESCANOR — AI Powered Virtual Assistant

🚀 ESCANOR is a feature-rich, voice-controlled AI virtual assistant built with Python and Tkinter. With a sleek dark-themed GUI, animated orb, and a powerful set of built-in tools — ESCANOR is your all-in-one desktop AI companion.

---

📌 Overview

💡 ESCANOR combines speech recognition, text-to-speech, machine learning, and a suite of productivity tools into a single desktop application. It listens to your voice, understands your commands, and responds intelligently — all from a beautiful animated interface.

🖥️ Named after the mighty lion of the Seven Deadly Sins, ESCANOR stands tall as a powerful assistant ready to serve at your command.

---

✨ Features

• 🎤 Voice Control — Speak commands using your microphone; ESCANOR listens and responds
• 🔊 Text-to-Speech — Responses are spoken aloud using a built-in TTS engine
• 🎵 Music Player — Play local MP3/WAV/OGG files or stream from YouTube Music
• 🗺️ Maps — Search and view any location with an embedded OpenStreetMap
• 💻 System Monitor — View real-time CPU, RAM, battery, volume, and brightness info
• 📊 Data Dashboard — Load CSV/Excel files and generate interactive charts (bar, pie, line, scatter, etc.)
• 📰 Fake News Detector — Detects whether a news article is real or fake using a trained ML model
• 🌐 Language Translator — Translate text into any language using Google Translate
• 🎙️ Voice File Manager — Open, list, create, or delete files and folders via voice
• 📝 Smart Reminder — Set date and time-based reminders with voice input
• 🤖 AI Summarizer — Summarize long articles or documents using NLP
• 📖 Wikipedia Search — Search and read Wikipedia articles instantly
• 🔍 OCR Scanner — Extract text from images and PDFs using Tesseract OCR

---

🗂️ Project Structure

🤖 ESCANOR/
├── 📁 ESCANOR/
│   ├── 🐍 escanor.py          # Main application — all features & GUI
│   └── 🎞️ escanor_orb.gif    # Animated orb (optional visual)
├── 📄 Fake.csv                # Fake news dataset for ML model
├── 📄 True.csv                # Real news dataset for ML model
└── 📝 README.md

---

⚙️ Installation

🧰 Prerequisites

Make sure you have the following installed:

• 🐍 Python 3.8+
• 📦 pip
• 🔤 Tesseract OCR (for OCR feature)

🪜 Steps

1. 📥 Clone the repository

git clone https://github.com/tanishcode-12/ESCANOR.git
cd ESCANOR

2. 📦 Install dependencies

pip install tkinter pyttsx3 speechrecognition psutil screen-brightness-control pycaw pandas plotly scikit-learn nltk wikipedia deep-translator sumy pytesseract pdfplumber Pillow pygame tkinterweb

3. ▶️ Run the application

python ESCANOR/escanor.py

---

🚀 Usage

🎤 Voice Commands

Once launched, click 🎤 Mic or type in the search bar and press Enter. Here are some example commands:

🗣️ Command	🤖 Action
"Play Believer"	🎵 Opens YouTube Music and plays the song
"Show map of Mumbai"	🗺️ Opens embedded map of Mumbai
"Check battery"	💻 Shows system stats
"Is this news fake?"	📰 Runs Fake News Detector
"Translate to Hindi"	🌐 Opens Language Translator
"Set a reminder"	📝 Opens Reminder panel
"What is Python"	📖 Searches Wikipedia
"Summarize this"	🤖 Summarizes input text
"Open file"	🎙️ Opens Voice File Manager
"Scan image"	🔍 Runs OCR on image/PDF

🖱️ Feature Buttons

Use the ⚡ FEATURES panel on the right side of the app to directly access any tool with a single click.

---

📦 Dependencies

📚 Library	🔧 Purpose
tkinter	GUI framework
pyttsx3	Text-to-speech engine
speechrecognition	Voice input
psutil	System monitoring
pycaw	Volume control
screen-brightness-control	Brightness control
pandas	Data handling
plotly	Interactive charts
scikit-learn	Fake news ML model
nltk	Natural language processing
wikipedia	Wikipedia search
deep-translator	Language translation
sumy	Text summarization
pytesseract	OCR (image to text)
pdfplumber	PDF text extraction
Pillow	Image processing
pygame	Local music playback
tkinterweb	Embedded browser

---

🤝 Contributing

🙌 Contributions are welcome! Here's how you can help:

1. 🍴 Fork the repository
2. 🌿 Create a new branch (git checkout -b feature/your-feature)
3. 💾 Make your changes and commit (git commit -m 'Add your feature')
4. 📤 Push to the branch (git push origin feature/your-feature)
5. 🔁 Open a Pull Request

✅ Please make sure your code is clean and well-commented.

---

👤 Author

Tanish — @tanishcode-12

---

⭐ If you found ESCANOR helpful, consider giving it a star on GitHub!