git clone https://github.com/danieladdisonorg/AI-Voice-Assitant.git

2. Navigate to project directory

cd AI-Voice-Assitant

3. Create virtual environment

python -m venv venv

4. Activate virtual environment

source venv/bin/activate

5. Install dependencies

pip install -r requirements.txt

Configuration

Environment Variables

Create a .env file in the project root:

# Google Services
GOOGLE_API_KEY=your_google_api_key
GEMINI_API_KEY=your_gemini_api_key

# Speech Processing
DEEPGRAM_API_KEY=your_deepgram_api_key

# Web Search
TAVILY_API_KEY=your_tavily_api_key

# Language Model
GROQ_API_KEY=your_groq_api_key

Google API Setup

1. Visit the Google Cloud Console
2. Create a new project or select an existing one
3. Enable the following APIs:
   • Google Calendar API
   • Google Contacts API
   • Gmail API
4. Create service account credentials
5. Download the credentials JSON file
6. Update the credentials path in your configuration

API Key Acquisition

• Deepgram: Sign up for speech-to-text services
• Tavily: Register for web search API access
• Groq: Get API key for Llama3 model access
• Google Gemini: Available through Google AI Studio

Usage

Starting the Assistant

python main.py

Voice Commands Examples

Calendar Management

• "Schedule a team meeting for tomorrow at 3 PM"
• "Book a doctor's appointment for Friday at 10 AM"

Contact Management

• "Add Sarah Johnson to my contacts, phone number 555-0123"
• "What's Mike's email address?"

Email Communication

• "Send an email to Jennifer about the quarterly report"
• "Compose a message to the development team"

Information Retrieval

• "Search for the latest news on renewable energy"
• "Find my notes about the marketing strategy"

Session Management

• Say "goodbye" to end the conversation

Project Structure

AI-Voice-Assitant/
├── main.py                 # Application entry point
├── requirements.txt        # Python dependencies
├── .env                   # Environment variables (create this)
├── files/                 # Personal knowledge base documents
├── tools/                 # Tool implementations
└── README.md              # Project documentation

Contributing

We welcome contributions! Please follow these steps:

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

Development Guidelines

• Follow PEP 8 style guidelines
• Add unit tests for new features
• Update documentation for API changes
• Ensure all tests pass before submitting

Troubleshooting

Common Issues

Authentication Errors

• Verify all API keys are correctly set in .env
• Check Google Cloud credentials and permissions

Speech Recognition Issues

• Ensure microphone permissions are granted
• Verify Deepgram API key is valid

Tool Integration Problems

• Confirm Google APIs are enabled in Cloud Console
• Check service account permissions

License

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

Support

For questions, issues, or suggestions:

• Email: aymenMir1001@gmail.com
• Issues: GitHub Issues
• Discussions: GitHub Discussions

Acknowledgments

• Deepgram for speech processing capabilities
• Google Cloud for productivity service integrations
• Tavily for web search functionality
• Groq for language model inference

Built with ❤️ for seamless AI-human interaction