📝 Productivity Features

• Notes System – Add, view, and delete notes
• Reminders – Set time-based reminders with natural language support
  • Time delay: "remind me to take medicine in 15 minutes"
  • Natural language: "remind me to call mom tomorrow at 5PM"
• Custom Commands – Teach Jarvis new commands: "when i say X, do this Y"
• Chat History – View and save conversation history
• Memory Recall – Ask "what is my name?" or "do you remember my birthday?"

🎵 Media & Entertainment

• Music Player – Play, pause, resume, stop, skip, and shuffle music
• Auto Music Detection – Automatically loads music from your Music folder
• Background Music – Play music while using other features

🌐 Web & System Integration

• Web Browser Control – Open websites (YouTube, Google, GitHub, LinkedIn)
• System Commands – Control your PC with voice/text:
  • Shutdown: "shutdown my pc"
  • Restart: "restart my pc"
  • Sleep: "sleep my pc"
  • Hibernate: "hibernate my pc"
  • Lock: "lock my pc"
• Folder Navigation – Open folders by name
• Application Launcher – Launch applications via custom commands

🌤️ Real-time Information

• Weather Updates – Live weather information with auto-location detection
  • Current temperature, feels-like, humidity
  • Weather description with emoji indicators
  • Auto-refreshes every minute
• Tech News – Latest technology news from NewsAPI and HackerNews
  • Top 5 tech headlines displayed in sidebar
  • Auto-refreshes periodically
• Market Watch – Stock market data display (in right sidebar)

🧮 Utilities & Plugins

• Calculator Plugin – Advanced math calculations via voice/text
  • Supports: addition, subtraction, multiplication, division
  • Percentage calculations: "increase 100 by 10%"
  • Natural language: "what is 25 plus 17?"
• Plugin System – Modular plugin architecture for easy extensions
  • Create custom plugins with simple registration
  • Auto-loads all plugins from plugins/ folder

🎯 Advanced Features

• Auto-Learning Mode – Jarvis learns custom commands from you
• Bold Text Formatting – Text in asterisks automatically becomes bold
• Enter Key Support – Send messages with Enter key
• Unknown Command Logging – Saves unrecognized commands for future learning
• Thread-Safe Operations – All operations run in background threads (no freezing)
• Error Handling – Graceful error handling with user-friendly messages

🧠 Tech Stack

Core Technologies

• Python 3.12+ – Programming language
• CustomTkinter – Modern GUI framework
• Google Gemini API – AI conversation engine
• SpeechRecognition – Voice input processing
• pyttsx3 – Text-to-speech engine

Key Libraries

• Pillow (PIL) – Image processing for avatars
• requests – HTTP requests for APIs
• python-dotenv – Environment variable management
• pygame – Music playback
• OpenCV (cv2) – Video intro playback
• BeautifulSoup4 – Web scraping (if needed)

📁 Project Structure

JARVIS_MARK_21_Beta/
├── JarvisMain.py              # Main entry point
├── video_intro.py             # Startup video handler
├── floating_button.py         # Optional floating button
├── .env                       # API keys (create this file)
├── requirements.txt           # Python dependencies
│
├── GUI/                       # User Interface
│   ├── __init__.py
│   ├── gui_main.py           # Main GUI window
│   ├── avatar.py             # Avatar display handler
│   ├── helper.py             # GUI helper functions
│   └── themes/
│       └── themes.py         # Theme definitions
│
├── core/                      # Core Logic
│   ├── commands.py           # Command processing
│   ├── utils.py              # Utility functions
│   ├── memory.py             # Memory management
│   ├── config.py             # Configuration settings
│   ├── theme_manager.py      # Theme management
│   └── plugin_loader.py      # Plugin system loader
│
├── features/                  # Feature Modules
│   ├── notes.py              # Notes management
│   ├── reminders.py          # Reminder system
│   └── music.py              # Music player
│
├── voice/                    # Speech & Voice
│   ├── tts.py                # Text-to-speech
│   └── stt.py                # Speech-to-text
│
├── api/                       # External API Integrations
│   ├── gemini.py             # Gemini AI integration
│   ├── weather.py            # Weather API
│   ├── news.py               # News API
│   ├── location.py           # Location detection
│   └── stock_data.py         # Stock market data
│
├── plugins/                   # Plugin System
│   ├── __init__.py
│   └── calculator.py         # Calculator plugin
│
├── DATA/                      # User Data Storage
│   ├── notes.json            # Saved notes
│   ├── reminders.json        # Saved reminders
│   ├── chat_log.txt          # Conversation history
│   ├── memory.json           # Persistent memory
│   ├── custom_commands.json  # Learned commands
│   └── unknown_commands.txt  # Unrecognized commands
│
└── assets/                    # Media Assets
    ├── intro.mp4             # Startup video
    ├── avatar*.gif           # Avatar animations
    └── jarvis_bg.*           # Background images

⚙️ Setup Instructions

Prerequisites

• Python 3.12 or higher installed on your system
• Microphone (for voice features)
• Internet connection (for AI and API features)

Step-by-Step Installation

1. Clone the Repository

git clone https://github.com/RootDeveloperDS/J.A.R.V.I.S..git
cd J.A.R.V.I.S.

2. Install Python Dependencies

# Install all required packages
pip install -r requirements.txt

Note for Windows users: If you encounter issues with PyAudio, try:

pip install pipwin
pipwin install pyaudio

3. Set Up API Keys

run JarvisMain.py and enter your API key when asked:

# Required API Keys
GEMINI_API_KEY=your_gemini_api_key_here

# Optional API Keys (for additional features)
WEATHER_API_KEY=your_openweathermap_api_key
NEWS_API_KEY=your_newsapi_key

How to get API keys:

• Gemini API: Visit Google AI Studio to get your free API key
• Weather API (optional): Get from OpenWeatherMap
• News API (optional): Get from NewsAPI

4. Configure Music Folder (Optional)

By default, Jarvis looks for music in your system's Music folder. To change this, edit features/music.py and update the path.

5. Run JARVIS

python JarvisMain.py

First Run:

• You'll see a startup video intro (press ESC to skip)
• The GUI will launch with a welcome message
• Jarvis will check for API keys and create necessary data files

🎮 Usage Guide

Basic Commands

Voice Commands

1. Enable Wake Word: Toggle the "Wake Word" switch in GUI
2. Say "Hey Jarvis" to activate voice mode
3. Speak your command after hearing the activation sound
4. Jarvis will respond both in text and voice

Text Commands

1. Type your message in the input box
2. Press Enter or click Send
3. Jarvis responds in the chat window

Common Commands

Chat & Questions

• Ask any question: "What is artificial intelligence?"
• General conversation: "Tell me a joke"
• Language support: Ask in Hindi for Hindi responses

Notes & Reminders

• "add note [your note]" – Save a note
• "show notes" – View all notes
• "delete note [note text]" – Remove a note
• "remind me to [task] in [X] minutes" – Set a reminder
• "remind me to [task] tomorrow at [time]" – Natural language reminder
• "view reminders" – See all active reminders

Music Control

• "play music" – Start playing music
• "pause music" – Pause playback
• "resume music" – Continue playback
• "stop music" – Stop playback
• "next song" – Skip to next track
• "shuffle music" – Shuffle playlist

System Control

• "shutdown my pc" – Shutdown computer (10 second delay)
• "restart my pc" – Restart computer
• "sleep my pc" – Put computer to sleep
• "hibernate my pc" – Hibernate computer
• "lock my pc" – Lock screen

Web & Apps

• "open youtube" – Open YouTube
• "open google" – Open Google
• "open my github" – Open GitHub
• "open my linkedin" – Open LinkedIn
• "open folder [folder name]" – Open folder from home directory

Memory & Learning

• "remember that my [key] is [value]" – Save personal info
  • Example: "remember that my name is John"
• "what is my [key]" – Recall saved info
• "what do you remember" – See all saved memories
• "when i say [phrase], do this [action]" – Teach custom command
  • Example: "when i say launch mode, do this open Spotify and VS Code"

Calculator

• "calculator [expression]" – Perform calculations
  • Examples:
    • "calculator 25 plus 17"
    • "calculator 100 times 5"
    • "calculator increase 100 by 10%"
    • "calculator 50% of 200"

Voice Settings

• "enable tts" or "turn on tts" – Enable voice responses
• "disable tts" or "turn off tts" – Disable voice responses

Utilities

• "show chat history" – Display conversation history
• "save chat" – Save current chat to file
• "what can you do" – List all available features

🎨 Customization

Changing Themes

1. Click Menu → Themes (or use theme button)
2. Select from available themes
3. Theme is saved and applied on next restart

Custom Background

1. Place your background image in assets/ folder
2. Name it jarvis_bg.png (or .jpg)
3. Restart Jarvis to see the new background

Avatar Customization

1. Replace avatar files in the main directory:
   • avatar2.gif, avatar4.gif,