⚠️ IMPORTANT NOTICE: This project is currently in maintenance mode. The original developer is no longer actively working on new features, but the project remains fully functional and open for community contributions. We welcome pull requests, bug fixes, and feature enhancements from the community!
| Status | Description | Action |
|---|---|---|
| 🔧 Maintenance Mode | Core functionality stable, minimal updates | Community contributions welcome |
| 🐛 Bug Fixes | Issues will be reviewed and merged | Submit pull requests |
| ✨ New Features | Community-driven feature development | Propose and implement |
| 📚 Documentation | Open for improvements and translations | Help improve docs |
Want to contribute? Check our Contributing Guidelines below!
The most advanced Python-based AI assistant with cutting-edge features including real-time web search, AI image generation, natural language processing, and intelligent task automation. Supriya transforms voice commands into powerful actions with a beautiful modern GUI interface.
| Feature Category | Capability | Technology |
|---|---|---|
| 🎤 Voice Processing | Advanced speech recognition with noise cancellation |  |
| 🧠 AI Intelligence | Natural language understanding & context awareness |  |
| 🖼️ Image Generation | Real-time AI image creation from text prompts |  |
| 🌐 Live Search | Real-time web search with intelligent summarization | |
| 🎨 Modern GUI | Beautiful graphical interface with animations |  |
"Transform voice queries into intelligent actions" - Supriya converts your spoken words into three powerful query types:
- 🔍 General Knowledge: Instant answers and information retrieval
- 🌐 Real-time Search: Live web search with summarized results
- 🖼️ Image Generation: AI-powered visual content creation
🧠 AI-Powered Intelligence
- 🎤 Advanced Voice Recognition: Crystal-clear speech processing with noise cancellation
- 💬 Natural Language Processing: Understands context and conversational commands
- 🤖 Smart Query Classification: Automatically categorizes requests into optimal response types
- 🧠 Learning Capabilities: Adapts to user preferences and command patterns
- 🔄 Context Awareness: Remembers previous conversations for better assistance
Voice Command Examples:
- "Generate an image of a sunset over mountains"
- "What's the latest news about artificial intelligence?"
- "Explain quantum computing in simple terms"
🔒 Enhanced Security System
- 🛡️ Multi-layer Authentication: Secure user authentication with hashed passwords
- 🔐 Data Encryption: End-to-end encryption for sensitive information
- 📝 Security Logging: Comprehensive audit trails for all security actions
- 🔑 Secure Credential Management: Encrypted storage of API keys and passwords
- ⚡ Access Control: Operation-level security requirements
- 🚨 Security Monitoring: Real-time threat detection and alerts
Security Features:
- Master password protection
- File encryption/decryption
- Secure deletion with data overwriting
- Failed login attempt tracking
📋 Advanced Task Management
- 🎯 Smart Task Creation: Voice-activated task creation with priorities
- 📅 Due Date Management: Automated reminders and deadline tracking
- 📊 Productivity Analytics: Completion rates and time tracking
- 🏷️ Task Categorization: Organize tasks with tags and priorities
- 🔍 Advanced Search: Find tasks by title, description, or tags
- 📈 Performance Insights: Weekly/monthly productivity reports
Task Commands:
- "Create task buy groceries with high priority due tomorrow"
- "Show my overdue tasks"
- "Mark task as complete"
- "Show productivity stats"
📧 Comprehensive Email Management
- 📨 Multi-Account Support: Manage multiple email accounts (Gmail, Outlook, Yahoo)
- 🔍 Smart Email Search: Search by sender, subject, or content
- 📝 Email Templates: Pre-built templates for common scenarios
- 💾 Draft Management: Save and manage email drafts
- 📊 Email Analytics: Statistics on email volume and patterns
- 🔒 Secure Storage: Encrypted credential storage
Email Commands:
- "Read my unread emails"
- "Send email using meeting template"
- "Show email summary"
- "Search emails from John"
📁 Advanced File Management
- 🗂️ Smart Organization: Automatic file organization by type
- 🔍 Content Search: Search within file contents
- 🔄 Duplicate Detection: Find and manage duplicate files
- 📦 Archive Operations: Compress and extract files
- ⭐ Favorites & Bookmarks: Quick access to important files
- 🗑️ Secure Deletion: Overwrite-based secure file deletion
- 📊 Storage Analytics: Disk usage analysis and recommendations
File Commands:
- "Organize downloads folder"
- "Find duplicate files"
- "Search for budget documents"
- "Show disk usage"
📊 Real-time System Monitoring
- ⚡ Performance Tracking: CPU, memory, and disk usage monitoring
- 🔄 Process Management: View and manage running processes
- 🌐 Network Monitoring: Internet connectivity and speed tests
- 🌡️ Temperature Monitoring: Hardware temperature tracking (if supported)
- 🔋 Battery Monitoring: Battery level and power status
- 🚨 Smart Alerts: Configurable thresholds for system resources
- 📈 Historical Data: Performance trends and analytics
Monitor Commands:
- "Check system status"
- "Show top CPU processes"
- "Check network connection"
- "Monitor performance"
🎵 Advanced Media Controller
- 🎶 Media Library: Comprehensive audio/video library management
- 🎵 Playlist Management: Create and manage custom playlists
- 🎤 Recording Capabilities: Audio/video recording with webcam support
- 🎧 Smart Playback: Shuffle, repeat, and queue management
- 📊 Media Analytics: Play counts and listening statistics
- 🔍 Content Search: Search by artist, album, or title
- 🎬 Multi-format Support: MP3, WAV, MP4, AVI, and more
Media Commands:
- "Play some relaxing music"
- "Create workout playlist"
- "Record voice memo"
- "Show media library stats"
🖼️ AI Image Generation
- 🎨 AI Image Creation: Generate stunning visuals from text descriptions
- ⚡ Real-time Processing: Instant image generation with advanced AI models
- 🎯 Smart Prompting: Optimized prompt engineering for better results
- 💾 Auto-Save: Automatically saves generated images with metadata
- 🔧 Customizable Settings: Adjust image style, quality, and dimensions
Image Generation Examples:
- "Create a futuristic cityscape with flying cars"
- "Generate a logo for a tech startup"
- "Design a minimalist bedroom interior"
🌐 Live Web Search & Information
- 🔍 Real-time Search: Instant access to current web information
- 📊 Intelligent Summarization: AI-powered content summarization
- 📰 News Integration: Latest news and trending topics
- 🌤️ Weather Updates: Current weather and forecasts
- 📈 Stock Market Data: Real-time financial information
- 🔗 Smart Source Selection: Chooses most relevant and reliable sources
Search Examples:
- "What's happening in the stock market today?"
- "Latest developments in renewable energy"
- "Current weather in New York"
🎨 Modern GUI Interface
- 💎 Beautiful Design: Modern, intuitive graphical user interface
- 🌈 Theme Support: Multiple themes including dark and light modes
- 📱 Responsive Layout: Adapts to different screen sizes and resolutions
- 🎭 Smooth Animations: Fluid transitions and micro-interactions
- � Visual Feedback: Real-time status indicators and progress bars
- 🎛️ Customizable Dashboard: Personalized layout and widget arrangement
⚙️ Advanced Automation
- 📋 Smart Task Management: Intelligent task creation and organization
- 📅 Calendar Integration: Seamless schedule management and reminders
- 🔄 Workflow Automation: Custom automation scripts and routines
- 📧 Email Management: Smart email reading and composition
- 💻 System Control: Advanced system operations and file management
- 🎯 Productivity Tools: Time tracking, note-taking, and productivity analytics
🛡️ Security & Privacy
- 🔒 Data Encryption: End-to-end encryption for sensitive information
- 🔑 API Key Management: Secure storage and handling of API credentials
- 👤 Privacy Protection: Local processing whenever possible
- 🛡️ Secure Communication: Encrypted data transmission
- 📋 Access Control: User authentication and permission management
- 🎓 Educational Tools: Interactive learning and knowledge sharing
- 🎮 Entertainment Features: Games, jokes, and interactive content
- 🌍 Multi-language Support: Support for multiple languages and accents
- 🔌 Plugin Architecture: Extensible with custom modules and integrations
- 📱 Cross-platform Compatibility: Works on Windows, macOS, and Linux
| Technology | Purpose | Advanced Implementation |
|---|---|---|
| Python 3.9+ | Core runtime with advanced features | Asyncio, multiprocessing, advanced OOP |
| OpenAI API | AI image generation and NLP | GPT integration, DALL-E image generation |
| Speech Recognition | Advanced voice processing | Noise cancellation, multiple engines |
| Modern GUI Framework | Beautiful user interface | Custom animations, responsive design |
| Web Scraping | Real-time information retrieval | Intelligent parsing, rate limiting |
| API Integrations | Multiple service connections | Weather, news, social media, finance |
| Security Framework | Enterprise-grade protection | Encryption, authentication, audit logging |
| System Monitoring | Real-time performance tracking | CPU, memory, disk, network analytics |
| Media Processing | Audio/video handling | Recording, playback, format conversion |
| File Management | Advanced file operations | Search, organization, duplicate detection |
| Task Management | Productivity optimization | Scheduling, reminders, analytics |
| Email Integration | Communication management | Multi-account, templates, automation |
# AI and Machine Learning
openai>=1.0.0 # AI image generation and NLP
speechrecognition>=3.10.0 # Advanced voice recognition
pyttsx3>=2.90 # Text-to-speech with voice options
# GUI and Interface
tkinter # Modern GUI framework
customtkinter>=5.0.0 # Enhanced UI components
pillow>=9.0.0 # Advanced image processing
# Web and API Integration
requests>=2.28.0 # HTTP requests with advanced features
beautifulsoup4>=4.11.0 # Intelligent web scraping
aiohttp>=3.8.0 # Async HTTP client
# Utilities and Processing
python-dotenv>=0.19.0 # Environment variable management
asyncio # Asynchronous programming
threading # Multi-threading support- 🚀 Async Processing: Non-blocking operations for better responsiveness
- 🧵 Multi-threading: Concurrent task execution
- 💾 Smart Caching: Intelligent caching for frequently used data
- 🔄 Connection Pooling: Optimized API request management
- 📊 Resource Management: Efficient memory and CPU usage
| Component | Minimum | Recommended |
|---|---|---|
| Operating System | Windows 10/11, macOS 10.14+, Linux | Latest versions |
| Python Version | 3.9+ | Python 3.11+ |
| RAM | 4GB | 6GB+ |
| Storage | 2GB free space | 4GB+ |
| Internet | Stable connection | High-speed broadband |
| Microphone | Any USB/built-in mic | High-quality microphone |
🔧 Method 1: Complete Setup (Recommended)
# Clone the advanced repository
git clone https://github.com/Arya182-ui/Modified-Supriya-An-desktop-Assistant-.git
# Navigate to project directory
cd Modified-Supriya-An-desktop-Assistant-
# Create virtual environment (recommended)
python -m venv supriya_env
# Activate virtual environment
# Windows:
supriya_env\Scripts\activate
# macOS/Linux:
source supriya_env/bin/activate
# Install all dependencies
pip install -r requirements.txt
# Setup environment variables
cp .env.example .env
# Edit .env file with your API keys
# Configure system paths
python setup_paths.py
# Launch Supriya
python main.py🚀 Method 2: Docker Setup (Advanced Users)
# Clone repository
git clone https://github.com/Arya182-ui/Modified-Supriya-An-desktop-Assistant-.git
cd Modified-Supriya-An-desktop-Assistant-
# Build Docker container
docker build -t supriya-assistant .
# Run with GUI support
docker run -it --rm \
-v /tmp/.X11-unix:/tmp/.X11-unix \
-e DISPLAY=$DISPLAY \
-v $(pwd)/.env:/app/.env \
supriya-assistant🔐 Required API Keys Setup
Create a .env file in the project root:
# OpenAI API for AI features
OPENAI_API_KEY=your_openai_api_key_here
# Weather API
WEATHER_API_KEY=your_weather_api_key_here
# News API
NEWS_API_KEY=your_news_api_key_here
# Optional: Additional service APIs
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secretHow to get API keys:
- OpenAI: Visit OpenAI Platform
- Weather: Get free key from OpenWeatherMap
- News: Register at NewsAPI
Modified-Supriya-Assistant/
├── 📄 main.py # Main application entry point
├── 📁 core/ # Core functionality modules
│ ├── 🧠 ai_engine.py # AI processing and NLP
│ ├── 🎤 voice_handler.py # Advanced voice recognition
│ ├── 🖼️ image_generator.py # AI image generation
│ ├── 🌐 web_searcher.py # Real-time web search
│ └── 🔒 security.py # Security and encryption
├── 📁 gui/ # Modern GUI components
│ ├── 🎨 main_window.py # Primary interface
│ ├── 🎭 animations.py # UI animations and effects
│ ├── 🌈 themes.py # Theme management
│ └── 📊 widgets.py # Custom UI widgets
├── 📁 services/ # External service integrations
│ ├── 🌤️ weather_service.py # Weather information
│ ├── 📰 news_service.py # News aggregation
│ ├── 📧 email_service.py # Email management
│ └── 📅 calendar_service.py # Calendar integration
├── 📁 utils/ # Utility functions
│ ├── 🔧 config.py # Configuration management
│ ├── 📝 logger.py # Advanced logging
│ └── 🛡️ validators.py # Input validation
├── 📁 data/ # Data and cache
│ ├── 💾 cache/ # Intelligent caching
│ ├── 📊 logs/ # Application logs
│ └── 🖼️ generated_images/ # AI-generated images
├── 📄 requirements.txt # Python dependencies
├── 📄 .env.example # Environment template
├── 📄 setup_paths.py # Path configuration script
└── 📚 docs/ # Comprehensive documentation
| Command Type | Example | Response Type | Processing |
|---|---|---|---|
| 🔍 General Query | "What is machine learning?" | Educational explanation | AI-powered analysis |
| 🌐 Real-time Search | "Latest news about space exploration" | Current web results | Live search + summary |
| 🖼️ Image Generation | "Create a cyberpunk city landscape" | AI-generated image | DALL-E processing |
| ⚙️ System Control | "Open my calendar and add a meeting" | System action | Automated execution |
🧠 Natural Language Processing
- Context Understanding: Maintains conversation context across multiple commands
- Intent Recognition: Automatically determines the best response type
- Emotion Detection: Recognizes emotional context in speech
- Multi-turn Conversations: Handles follow-up questions and clarifications
Example Conversation:
User: "What's the weather like today?"
Supriya: "It's sunny and 75°F in your area."
User: "What about tomorrow?"
Supriya: "Tomorrow will be partly cloudy with a high of 72°F."
🖼️ Image Generation Workflows
- Smart Prompt Enhancement: Automatically improves image prompts for better results
- Style Variations: Generate multiple variations of the same concept
- Resolution Options: Create images in different sizes and qualities
- Batch Generation: Generate multiple images from a single command
Advanced Image Commands:
- "Generate a professional headshot of a businesswoman"
- "Create a minimalist logo with blue and white colors"
- "Design a modern kitchen interior with natural lighting"
📧 Email & Calendar Management
# Voice commands for productivity
"Read my latest emails"
"Schedule a meeting for tomorrow at 2 PM"
"Set a reminder to call John at 5 PM"
"Draft an email to the marketing team"💻 Advanced System Control
# File and system operations
"Create a new folder called 'Projects' on Desktop"
"Search for files containing 'budget' in Documents"
"Take a screenshot and save it as 'meeting-notes'"
"Open Spotify and play my work playlist"| Feature | Basic Version | Advanced Supriya | Super Supriya | Improvement |
|---|---|---|---|---|
| Response Time | 3-5 seconds | <1 second | <0.5 seconds |  |
| Voice Accuracy | 70-80% | 95-98% | 99%+ |  |
| Feature Count | 15+ commands | 100+ commands | 500+ commands |  |
| AI Integration | None | Full AI Suite | Super AI Suite |  |
| User Interface | Console | Modern GUI | Advanced GUI |  |
| Security | None | Basic | Enterprise-Grade |  |
| Task Management | None | None | Full System |  |
| File Operations | Basic | Basic | Advanced |  |
| System Monitoring | None | None | Real-time | |
| Media Control | None | Basic | Professional |  |
- 🎭 Emotion Recognition: Advanced emotional intelligence
- 🌍 Multi-language Support: Support for 20+ languages
- 🔌 Plugin Marketplace: Community-driven extensions
- 📱 Mobile Companion: iOS and Android apps
- 🤝 Team Collaboration: Multi-user support and sharing
- 🧠 Machine Learning: Personalized learning and adaptation
🌟 This project is community-driven! The original developer welcomes contributions from developers worldwide.
📢 MAINTAINER NOTE: While I'm no longer actively developing new features, I review and merge quality contributions. This is a great opportunity for developers to contribute to an established AI project!
We welcome contributions to make Supriya even more powerful! Here's how you can contribute:
🔧 Code Contributions
-
Fork the Repository
git fork https://github.com/Arya182-ui/Modified-Supriya-An-desktop-Assistant-.git
-
Create Feature Branch
git checkout -b feature/amazing-new-feature
-
Development Setup
# Install development dependencies pip install -r requirements-dev.txt # Run tests python -m pytest tests/ # Code formatting black . && flake8 .
-
Commit Guidelines
git commit -m "feat: add advanced image generation with style options" git commit -m "fix: resolve voice recognition timeout issue" git commit -m "docs: update API documentation for new features"
-
Submit Pull Request
- Detailed description of changes
- Include test coverage
- Update documentation
- Link related issues
🐛 Bug Reports & Feature Requests
Bug Report Template:
- OS and Python version
- Steps to reproduce
- Expected vs actual behavior
- Error logs and screenshots
- Supriya version
Feature Request Template:
- Use case description
- Proposed implementation
- Benefits and impact
- Alternative solutions considered
- 🌟 Hall of Fame: Top contributors featured in README
- 🎖️ Badges: Special contributor badges and recognition
- 📚 Documentation: Credit in project documentation
- 🎉 Community: Access to exclusive developer community
- 🐛 Bug Fixes: Critical bugs and stability improvements
- 📚 Documentation: Better guides, tutorials, and API docs
- 🌍 Internationalization: Multi-language support
- ⚡ Performance: Optimization and speed improvements
- 🔌 Integrations: New API integrations and services
- 🎨 UI/UX: Interface improvements and new themes
This project is licensed under the MIT License - see the LICENSE file for details.
- 🛡️ Data Protection: All sensitive data is encrypted and stored locally
- 🔑 API Security: Secure handling of API keys and credentials
- 👤 User Privacy: No personal data is shared without explicit consent
- 🔍 Transparent Processing: Open-source code for full transparency
- 🤖 Responsible AI: Ethical use of AI technologies
- 🌍 Bias Mitigation: Efforts to reduce algorithmic bias
- 📋 Content Guidelines: Appropriate content generation policies
- 🛡️ Safety Measures: Built-in safety checks and content filtering
🎓 Technology Partners
- 🤖 OpenAI: For providing cutting-edge AI APIs
- 🐍 Python Community: For the amazing ecosystem of libraries
- 🎤 Speech Recognition Contributors: For open-source speech processing tools
- 🎨 GUI Framework Developers: For modern interface capabilities
🌟 Inspiration & Support
- 🧠 AI Research Community: For advancing the field of artificial intelligence
- 👥 Open Source Contributors: For building the foundation we stand on
- 🎯 User Community: For feedback, suggestions, and continuous improvement
- 📚 Educational Resources: For knowledge sharing and learning opportunities
Your support helps drive continuous innovation and advanced feature development!
| Action | Impact | Link |
|---|---|---|
| ⭐ Star this repo | Increases project visibility | Give a Star |
| 🍴 Fork & contribute | Helps improve the project | Fork Now |
| 🐛 Report issues | Helps identify and fix bugs | Report Issues |
| 📢 Share project | Reaches more developers | Share on Twitter |
| 📝 Write reviews | Provides valuable feedback | Write Review |
- 🚀 Priority Features: Supporter-requested features get priority development
- 🎯 Direct Access: Direct communication channel for feedback and suggestions
- 📚 Exclusive Content: Access to advanced tutorials and documentation
- 🏆 Recognition: Listed as project supporter in documentation
Created with ❤️ and cutting-edge AI technology
Ayush Gangwar
Original Creator - Now in Maintenance Mode
📧 Contact for Project Handover or Major Contributions: Email
This project is community-maintained and welcomes new contributors!
- ⭐ Star this repository to show your support
- 🍴 Fork and contribute following our guidelines
- � Fix bugs or add features that interest you
- 🤝 Join our community of developers and users
⭐ Don't forget to star the repo if Supriya amazes you! ⭐
