Python Voice Assistant

A virtual voice assistant that can perform tasks like:

• Opening websites (Google, YouTube, Instagram, etc.)
• Telling the time
• Searching Wikipedia
• Conversing with an AI chatbot
• Speech recognition and text-to-speech

This assistant uses:

• SpeechRecognition for voice input
• Google Text-to-Speech (gTTS) for voice output
• Wikipedia API for information retrieval
• Hugging Face Chatbot API for AI conversations

---

🚀 Features

✔ Voice-controlled commands ✔ AI-powered chatbot using Hugging Face API ✔ Wikipedia search integration ✔ Opens websites with voice commands ✔ Supports Windows, macOS, and Linux ✔ Works offline for speech recognition (except chatbot and Wikipedia search)

---

📦 Installation

Step 1: Clone the Repository

# Using Git
git clone https://github.com/Prajjwal2051/Python-Virtual-Assistant.git
cd Python-Virtual-Assistant

Step 2: Set Up a Virtual Environment

It's recommended to use a virtual environment to manage dependencies.

# Create a virtual environment
python -m venv assist

# Activate the virtual environment
# Windows:
assist\Scripts\activate
# macOS/Linux:
source assist/bin/activate

Step 3: Install Dependencies

Install the required Python packages:

pip install -r requirements.txt

If you don’t have pip, install it using:

python -m ensurepip --default-pip

Step 4: Install PortAudio and PyAudio

PyAudio is required for speech recognition. Install it using:

Windows:

pip install pipwin
pipwin install pyaudio

Linux:

sudo apt update
sudo apt install portaudio19-dev python3-pyaudio
pip install pyaudio

macOS:

brew install portaudio
pip install pyaudio

Step 5: Set Hugging Face API Key (Secure Method)

To interact with the chatbot, set up your Hugging Face API key.

Windows (Command Prompt):

set HF_API_KEY=your_api_key_here

Windows (PowerShell):

$env:HF_API_KEY="your_api_key_here"

Linux/macOS:

export HF_API_KEY="your_api_key_here"

---

🎤 How to Use

Run the Script

python main.py

Voice Commands Available

Command	Function
"Open YouTube"	Opens YouTube in the browser
"What is the time?"	Tells the current time
"Wikipedia Elon Musk"	Searches Wikipedia for Elon Musk
"Who is the President of India?"	Asks AI chatbot
"Exit" or "Quit"	Stops the assistant

---

🛠 Troubleshooting

Issue: Speech recognition is not working.
Solution: Make sure your microphone is working, and try increasing adjust_for_ambient_noise() time.

Issue: Hugging Face API returns 401 Unauthorized.
Solution: Ensure your API key is correct and set in the environment variables.

Issue: ModuleNotFoundError: No module named 'pydub'.
Solution: Install ffmpeg:

# Linux
sudo apt install ffmpeg

# macOS (using Homebrew)
brew install ffmpeg

# Windows
choco install ffmpeg

Issue: ModuleNotFoundError: No module named 'pyaudio'.
Solution: Follow Step 4 in the installation guide to install PortAudio and PyAudio.

---

🤝 Contributing

1. Fork the repo
2. Create a new branch (feature-new-command)
3. Commit your changes (git commit -m "Added new command")
4. Push the branch (git push origin feature-new-command)
5. Create a Pull Request

---

📜 License

This project is licensed under the MIT License.

🎯 Developed by Prajjwal Sahu

🚀 Happy Coding!