Skip to content

Commit 50ad2c4

Browse files
committed
Voice Assistant Added
1 parent cbf65e3 commit 50ad2c4

File tree

3 files changed

+513
-0
lines changed

3 files changed

+513
-0
lines changed
Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
# Jarvis - A Personal Voice Assistant 🗣️💻
2+
3+
This **Jarvis Personal Assistant** is a Python-based virtual assistant that can execute commands, automate tasks, and provide information at your request. It can help you manage files, open applications, search Wikipedia, forecast weather, and much more—all through voice commands.
4+
5+
## 🚀 Features
6+
7+
1. **Voice & Text Interaction**
8+
- Provides **voice recognition** using Google Speech Recognition API.
9+
- Users can **switch to text mode** if speech recognition fails.
10+
11+
2. **Application Management**
12+
- Open or close **Notepad** and **Command Prompt**.
13+
- Manage system **battery levels** with alerts and suggestions.
14+
15+
3. **Information Retrieval**
16+
- Get **Wikipedia summaries** for any topic.
17+
- **Weather forecasts** by city or location-based.
18+
- Check your **IP address** using an online API.
19+
20+
4. **Entertainment & Media**
21+
- Search for **movie details** via IMDb, including cast, plot, and ratings.
22+
- Open **YouTube** and automate subscriptions.
23+
24+
5. **System Control**
25+
- Adjust **volume controls**: Increase, decrease, or mute.
26+
- Minimize or maximize windows using **keyboard automation**.
27+
- Track **internet speed** with Speedtest integration.
28+
29+
6. **Utility Features**
30+
- Control **Webcam** access and capture videos.
31+
- Perform calculations using **Wolfram Alpha**.
32+
- Automatically **open websites** using Chrome.
33+
- Monitor **system processes** and terminate them on command.
34+
35+
---
36+
37+
## 🔧 Setup Instructions
38+
39+
1. **Clone the Repository**
40+
```bash
41+
git clone https://github.com/yourusername/jarvis-assistant.git
42+
cd jarvis-assistant
43+
```
44+
45+
2. **Install Dependencies**
46+
Install all necessary Python packages using:
47+
```bash
48+
pip install -r requirements.txt
49+
```
50+
51+
3. **Add Paths for Applications**
52+
Set the paths for:
53+
- **Chrome browser**: `"C:/Program Files/Google/Chrome/Application/chrome.exe"`
54+
- **Notepad**: `"C:/Windows/System32/notepad.exe"`
55+
- **Visual Studio Code** (optional): Adjust the path as per your installation.
56+
57+
4. **Get API Keys**
58+
- **OpenWeather API**: [Sign up here](https://openweathermap.org/) and replace `apiKey` in the code.
59+
- **Wolfram Alpha API**: Get an API key [here](https://products.wolframalpha.com/api/).
60+
61+
---
62+
63+
## 🧑‍💻 Usage Instructions
64+
65+
1. **Launch the Assistant**
66+
Run the script:
67+
```bash
68+
python jarvis.py
69+
```
70+
71+
2. **Speak Commands**:
72+
- "Open Notepad" – Launches Notepad.
73+
- "What is the weather report?" – Gives the weather of your current location.
74+
- "Search for Titanic on Wikipedia" – Provides a brief Wikipedia summary.
75+
- "Close Command Prompt" – Terminates the Command Prompt if running.
76+
- "What's my IP address?" – Provides your public IP address.
77+
78+
3. **Text Mode**
79+
If the voice input isn't recognized, type your queries when prompted.
80+
81+
4. **Pause or Stop Listening**:
82+
- Say **"Stop listening"**: Pauses the assistant.
83+
- Resume by pressing **Ctrl + Alt + K**.
84+
- Say **"No query, thanks"** to exit the assistant.
85+
86+
---
87+
88+
## 🌦️ Example Queries
89+
90+
- **"How are you, Jarvis?"**
91+
→ Jarvis responds and continues the conversation.
92+
93+
- **"Open Command Prompt"**
94+
→ Opens the Command Prompt window.
95+
96+
- **"Mute the volume"**
97+
→ Mutes system volume.
98+
99+
---
100+
101+
## 🎯 Known Issues and Limitations
102+
103+
- Some queries require accurate phrasing.
104+
- Voice recognition may fail in noisy environments.
105+
- Web automation depends on having Chrome installed.
106+
- Weather reports return temperature in **Kelvin** by default (can be adjusted).
107+
108+
---
109+
110+
## 💡 Future Improvements
111+
112+
- Add **Gmail** integration to send emails.
113+
- Support for **natural conversations** with chat history.
114+
- **Alarm feature** implementation.
115+
116+
---
117+
118+
## 🤖 Contribution
119+
120+
Feel free to submit pull requests or report bugs/issues. Contributions are welcome to make this assistant smarter and more responsive!
121+
122+
---
123+
124+
125+
## 🛠️ Prerequisites
126+
127+
- **Python 3.7+**
128+
- Required Packages (install via `pip`):
129+
```bash
130+
pip install -r requirements.txt
131+
132+
---
133+
## 🛠️ Api Credits
134+
135+
Wolfram Api
136+
OpenWheather Api
137+
138+
139+
- **Python 3.7+**
140+
- Required Packages (install via `pip`):
141+
```bash
142+
pip install -r requirements.txt
143+
144+
Enjoy using **Jarvis Personal Assistant**! 😊

0 commit comments

Comments
 (0)