Skip to content

Latest commit

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

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

🪜 Steps

  1. 📥 Clone the repository
git clone https://github.com/tanishcode-12/ESCANOR.git
cd ESCANOR
  1. 📦 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
  1. ▶️ 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
tkinterGUI framework
pyttsx3Text-to-speech engine
speechrecognitionVoice input
psutilSystem monitoring
pycawVolume control
screen-brightness-controlBrightness control
pandasData handling
plotlyInteractive charts
scikit-learnFake news ML model
nltkNatural language processing
wikipediaWikipedia search
deep-translatorLanguage translation
sumyText summarization
pytesseractOCR (image to text)
pdfplumberPDF text extraction
PillowImage processing
pygameLocal music playback
tkinterwebEmbedded 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!

About

Offline AI virtual assistant with voice recognition, fake news detection, OCR and no external APIs

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages