Lucy is an advanced Python-based virtual assistant designed to automate everyday desktop tasks using voice commands.
It integrates AI, automation, natural language processing, and real-time APIs — functioning much like a personal AI secretary.

Whether you want to send an email, search Wikipedia, download YouTube videos, read PDFs aloud, or control system functions (like opening apps or taking screenshots) — Lucy does it all through voice.

⚙️ Core Features

• 🎙️ Voice Recognition & Response – Uses speech_recognition and pyttsx3 for natural voice input/output.

• 🌐 Web Automation – Opens websites, performs Google searches, and browses online content.

• 🧠 Knowledge Integration – Fetches summaries from Wikipedia and real-time news headlines via APIs.

• 📧 Email & WhatsApp Automation – Sends messages and emails directly from voice commands.

• 🧾 PDF Reader – Reads any page of a PDF file aloud using PyMuPDF (fitz) and text extraction.

• 📺 YouTube Downloader – Download HD videos using pytube module.

• 🎮 Fun Mode – Includes mini games like Stone-Paper-Scissors and Joke Mode for entertainment.

• 🖼️ Screenshot & File Operations – Takes screenshots, hides/unhides folders, and controls files.

• 💡 System Control – Lock PC, restart, sleep, or shut down with just one voice command.

• 📰 News Updates – Reads latest headlines or topic-based news through News API.

• 📸 Instagram Integration – Fetches and downloads profile pictures directly using instaloader.

• 🕹️ App Launcher – Opens VS Code, PyCharm, Control Panel, CapCut, or any custom app instantly.

🧰 Tech Stack

• Language: Python 3.12+

• Speech: speech_recognition, pyttsx3

• Automation: pyautogui, os, webbrowser, sys

• AI / Data: wikipedia, requests, json, fitz, PyPDF2

• Media: cv2, pytube, instaloader, pywhatkit

• Notifications: win11toast

• Libraries: OpenCV, PyPDF2, PyMuPDF, Instaloader, pywhatkit, pyttsx3, SpeechRecognition

🧩 Highlights

• Works completely offline for core operations.

• Handles real-time speech input with contextual responses.

• Fully customizable command system.

• Functions as a desktop automation suite + chatbot hybrid.

• Designed with modular code for easy expansion (add new commands easily).

🏁 Why It Stands Out

Lucy isn’t just another “Hello World” assistant — it’s a multi-module, voice-driven automation ecosystem.
It demonstrates real-world integration of APIs, NLP, voice recognition, system automation, and GUI interaction — making it a portfolio centerpiece for any advanced Python developer.