🤖 N.Y.R.A - Nimble Yet Reliable Assistant

N.Y.R.A (Nimble Yet Reliable Assistant) is a voice-activated Python AI assistant designed to handle everyday tasks like playing music, fetching news, opening websites, and responding with AI-generated replies using Google's Gemini Pro.

---

🚀 Features

• 🎙️ Voice Command Recognition
  Say "Nyra" to activate the assistant and issue voice commands.

• 🌐 Open Websites
  Commands like “open Google”, “open YouTube”, etc.

• 🎵 Play Music
  Ask N.Y.R.A to play a song from your predefined library.

• 🗞️ Fetch Latest News
  Get the latest headlines using NewsAPI.

• 🧠 AI-Powered Conversations
  Chat with N.Y.R.A using Google's Gemini Pro.

• 🔊 Text-to-Speech
  Replies are spoken using Google's gTTS and played with Pygame.

---

🧠 Technologies Used

• speech_recognition – For speech-to-text from your microphone
• google-generativeai – For AI-generated text replies (Gemini Pro)
• gtts – Converts text to speech
• pygame – Plays the MP3 speech output
• requests – For fetching news from NewsAPI
• dotenv – For secure API key management
• webbrowser – Opens web URLs in the default browser

---

📁 Project Structure

AI_ASSIS/
├── .env.example            # Sample environment config
├── hello.mp3               # Sample MP3 file (optional)
├── main.py                 # Main assistant logic
├── musicLibrary.py         # Dictionary of songs mapped to YouTube links
├── requirements.txt        # List of dependencies
└── README.md               # This file

---

🔐 Setup and Usage

1. Clone the Repository

git clone https://github.com/yourusername/nyra-assistant.git
cd nyra-assistant

2. Create a Virtual Environment

python -m venv .venv
# Activate it:
# On Windows:
.venv\Scripts\activate
# On macOS/Linux:
source .venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

4. Set Up Your .env File

Create a .env file with your API keys:

NEWS_API_KEY=your_newsapi_key
GEMINI_API_KEY=your_gemini_api_key

Or copy from example:

cp .env.example .env

5. Run the Assistant

python main.py

Speak "Nyra" to activate voice recognition.

---

📝 Sample Commands

• "Nyra" → Wake word
• "Open Google"
• "Play [song name]"
• "Give me the news"
• "What's the capital of France?"

---

📌 Notes

• You can customize the music list in musicLibrary.py.
• Avoid committing your .env file — keep your API keys safe!
• Internet connection is required for news, AI, and TTS features.

---

📜 License

This project is open-source and available under the MIT License.

---

✨ Credits

Developed with ❤️ by Sarthak Dharmik