Roomey_AI_Voice_Agent

Roomey AI Voice Agent is a modular, low-latency AI assistant designed to live in your environment and perform a variety of tasks through natural language interactions. It integrates with calendar services, smart home devices, financial data streams, and web search to provide real-time answers and actions. Once running, you can speak to Roomey to set reminders, check stock prices, fetch information from the web, control lights or other connected devices, and manage calendar events. The agent uses a combination of speech-to-text, natural language understanding, and task execution orchestration to determine the best course of action and then runs the appropriate integration or API call to complete the request.

Prerequisites:

• Python 3.9+ installed on your system
• Git installed
• Internet access for dependencies and API access
• Gemini API access key (GEMINI_API_KEY) for advanced NLP features

Installation steps:

1. Clone the repository and navigate into it:

git clone https://github.com/augmentedstartups/Roomey_AI_Voice_Agent.git
cd Roomey_AI_Voice_Agent

2. Create a Python virtual environment:

python -m venv myenv

3. Activate the environment:

# macOS/Linux
source myenv/bin/activate
# Windows (PowerShell)
./myenv/Scripts/Activate.ps1

4. Install dependencies:

pip install -r requirements.txt

5. Set up environment variables (example):

# Create a .env file or export directly
export GEMINI_API_KEY=your_gemini_api_key_here
export PERSONALIZED_PROMPT="You are a helpful assistant. My name is [Your Name], [add personal details here]."

6. Run the main application:

python main_mac.py

Optional: If you need to adapt the prompts or disable certain features, modify the configuration and environment variables accordingly.

• The Roomey agent relies on Gemini API capabilities for advanced NLP features; ensure GEMINI_API_KEY is valid and has necessary access.
• If you update dependencies, re-run the installation step to refresh the virtual environment.
• On some systems, you may need to install system dependencies for audio/video input/output used by the voice interface.
• The PERSONALIZED_PROMPT variable lets you tailor Roomey’s persona and context; keep it concise and relevant to avoid ambiguous responses.
• If running behind a firewall or proxy, ensure outbound access to required APIs is allowed and configure HTTP(S)_PROXY as needed.