🤖 JARVIS - AI Voice Assistant

An intelligent, multilingual voice assistant with conversational AI, memory, and personality - inspired by Tony Stark's JARVIS.

---

🌟 Features

🎤 Voice Control

• Wake Word Activation - Say "Jarvis" to activate
• Natural Speech Recognition - Powered by Google Speech API
• Text-to-Speech - Natural voice responses with edge-tts
• Multi-Language Support - 13 Indian languages supported

🧠 Conversational AI

• Natural Conversations - Chat like you would with a friend
• Context Memory - Remembers last 50 messages
• Persistent Memory - Saves conversations across sessions
• Emotional Intelligence - Understands emotions and responds appropriately
• Personal Information - Knows about you and your preferences

🌍 Multi-Language Support

• English (Indian)
• Hindi
• Bengali
• Telugu
• Tamil
• Marathi
• Gujarati
• Kannada
• Malayalam
• Punjabi
• Odia
• Assamese
• Urdu

⚡ System Control

• Application Management - Open/close apps
• Browser Automation - Control tabs, windows, history
• System Operations - Shutdown, restart, updates
• File Operations - Search, open files
• Internet Speed Check - Monitor connection
• Battery Status - Check power levels

🎭 Personality

• Witty & Sarcastic - Inspired by Tony Stark's JARVIS
• Helpful - Always ready to assist
• Entertaining - Makes conversations fun
• Loyal - Remembers you and your preferences

---

🚀 Quick Start

Prerequisites

# Python 3.8 or higher
python --version

# Pip package manager
pip --version

Installation

1. Clone the repository

   git clone https://github.com/yourusername/jarvis-ai.git
   cd jarvis-ai

2. Install dependencies

   pip install -r requirements.txt

3. Setup environment variables

   # Copy the example file
   copy .env.example .env
   
   # Edit .env and add your API key
   notepad .env

   Add your Groq API key (get free key from https://console.groq.com):

   GROQ_API_KEY=your_api_key_here
   USER_NAME=Your Name
   

4. Run Jarvis

   python Jarvis.py

First Run

$ python Jarvis.py

Jarvis: "Initializing Jarvis systems."
Jarvis: "Jarvis is online and fully operational."
Jarvis: "🎤 Say 'Jarvis' followed by your command."

# Now speak: "Jarvis how are you?"

---

📋 Requirements

Required Python Packages

speech_recognition>=3.10.0
pyttsx3>=2.90
langdetect>=1.0.9
pyautogui>=0.9.54
psutil>=5.9.0
pygetwindow>=0.0.9
requests>=2.31.0
playsound>=1.3.0
edge-tts>=6.1.0

System Requirements

• OS: Windows 10/11, macOS, Linux
• RAM: 4GB minimum, 8GB recommended
• Microphone: Required for voice input
• Internet: Required for speech recognition and AI features

---

🎯 Usage

Basic Commands

Voice Commands

"Jarvis open chrome"
"Jarvis search on youtube"
"Jarvis play music"
"Jarvis new tab"
"Jarvis battery status"
"Jarvis internet speed"

Conversations

"Jarvis how are you?"
"Jarvis kaise ho?"
"Jarvis main pareshan hu"
"Jarvis what should I do?"
"Jarvis tell me a joke"

Language Switching

"Jarvis switch to hindi"
"Jarvis switch to tamil"
"Jarvis current language"

Memory Management

"Jarvis save memory"
"Jarvis forget everything"
"Jarvis what did we talk about?"

Advanced Features

Browser Automation

• New tab, close tab, switch tabs
• Refresh, duplicate, reopen closed tabs
• Open downloads, history, incognito mode

System Control

• Shutdown/restart computer
• Windows updates
• Battery monitoring
• Internet connectivity alerts

---

⚙️ Configuration

1. API Key Setup (Optional - For Unlimited AI)

For unlimited conversational AI, get a free Groq API key:

1. Go to https://console.groq.com
2. Sign up (free, no credit card)
3. Create an API key
4. Open conversational_ai.py
5. Add your key:

   GROQ_API_KEY = "your-api-key-here"

Note: Jarvis works without API key using built-in responses!

2. Personal Information

Update your information in conversational_ai.py:

USER_INFO = {
    "name": "Your Name",
    "location": "Your City",
    "education": {
        "schooling": "Your School Location",
        "birthplace": "Your Birthplace"
    }
}

3. Memory Settings

Adjust memory capacity in conversational_ai.py:

MAX_HISTORY = 50  # Number of messages to remember

---

📁 Project Structure

jarvis-ai/
├── Jarvis.py                 # Main application
├── STT_Engine.py            # Speech recognition
├── conversational_ai.py     # AI conversation engine
├── Automation/
│   ├── Brain.py             # Command routing
│   ├── app_open.py          # Application control
│   ├── website_open.py      # Website control
│   ├── tab_automation.py    # Browser automation
│   ├── battery.py           # Battery monitoring
│   ├── music.py             # Music playback
│   └── spotify.py           # Spotify integration
├── TextToSpeech/
│   └── fast_tts_bf.py       # Text-to-speech engine
├── Data/
│   ├── dialog.py            # Dialogue responses
│   └── web_data.py          # Website database
├── Time_operation/
│   └── alert.py             # Reminders and alerts
├── feature/
│   └── internet_speed.py    # Speed test
├── internet.py              # Connectivity monitoring
├── jarvis_memory.json       # Conversation memory (auto-generated)
├── requirements.txt         # Dependencies
├── .gitignore              # Git ignore rules
└── README.md               # This file

---

🎓 Documentation

Comprehensive guides are available:

• QUICK_START.md - Quick reference guide
• GET_GROQ_API_KEY.md - API key setup
• CONVERSATIONAL_AI_SETUP.md - AI configuration
• INDIAN_LANGUAGES_GUIDE.md - Multi-language guide
• MEMORY_GUIDE.md - Memory system guide
• TEST_YOUR_JARVIS.md - Testing guide

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

🐛 Troubleshooting

Common Issues

"Microphone not detected"

• Check microphone permissions
• Ensure microphone is connected
• Test with other applications

"Speech recognition not working"

• Check internet connection
• Verify microphone is working
• Speak clearly after "Jarvis"

"API key error"

• Verify API key is correct
• Check internet connection
• Jarvis works without API key (limited conversations)

"Import errors"

• Install all requirements: pip install -r requirements.txt
• Use Python 3.8 or higher
• Create virtual environment if needed

---

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

👨‍💻 Author

Siddhanth

• Creator of JARVIS AI Assistant
• Location: Pune, Maharashtra, India

---

🙏 Acknowledgments

• Inspired by Tony Stark's JARVIS from Iron Man
• Google Speech Recognition API
• Groq AI for conversational capabilities
• Edge TTS for natural voice synthesis
• Open source community

---

🌟 Star History

If you find this project useful, please consider giving it a star! ⭐

---

📞 Support

For issues, questions, or suggestions:

• Open an issue on GitHub
• Check the documentation guides
• Review troubleshooting section

---

🔮 Future Enhancements

• Home automation integration
• Calendar and email management
• Weather forecasts
• News updates
• Smart home device control
• Mobile app companion
• Voice customization
• Plugin system

---

📊 Stats

• Languages Supported: 13
• Commands: 50+
• Conversation Memory: 50 messages
• Response Time: 1-2 seconds
• Accuracy: 95%+

---

💡 Tips

1. Speak Clearly - Enunciate for better recognition
2. Reduce Noise - Quiet environment works best
3. Use Wake Word - Always say "Jarvis" first
4. Be Natural - Talk like you would to a friend
5. Mix Languages - Hinglish works great!

---

🎉 Features Showcase

Voice Control

✅ Wake word activation
✅ Natural language processing
✅ Multi-language support
✅ Context-aware responses

System Integration

✅ Application control
✅ Browser automation
✅ System operations
✅ File management

AI Capabilities

✅ Conversational AI
✅ Memory system
✅ Emotional intelligence
✅ Personality traits

---

Made with ❤️ by Siddhanth

"Sometimes you gotta run before you can walk." - Tony Stark