🤖 Luisquisite Robot Waitress Voice Agent

A voice-powered AI waitress for Luisquisite restaurant in Cartagena, Colombia. This agent can take orders via voice commands in both Spanish and English.

🍽️ Menu

1. Salmon Bowl: Raw salmon, sushi rice, asparagus, avocado, broccoli
2. Kiwi Brunch: 3 kiwis, 3 raw oatmeal spoons, 2 fried eggs, 2 brazil nuts
3. Tuna Bowl: Raw tuna, sushi rice, beet, spinach, kale

🚀 Testing the Voice Agent

There are two ways to test the voice agent:

Option 1: Web Interface (Easiest - Recommended for Testing) 🌐

The easiest way to test is using the web interface. No microphone setup needed!

1. Install dependencies:

pip install -r requirements.txt

2. Run the web app:

streamlit run app.py

3. Open your browser to the URL shown (usually http://localhost:8501)

4. Start chatting!

   • Voice Input: Click the "🎤 Click to Speak" button and speak your order (works in Chrome, Edge, Safari)
   • Text Input: Type your message in the text field
   • Hear Responses: Click the "🔊 Speak" button on any waitress message to hear it read aloud

Deploy to Streamlit Cloud (Share with Others)

1. Push your code to GitHub (already done! ✅)
2. Go to share.streamlit.io
3. Sign in with GitHub
4. Click "New app"
5. Select your repository: ledp1/luisquisite
6. Set the main file path: app.py
7. Click "Deploy"

Your app will be live at a public URL that anyone can access!

Option 2: Local Voice Agent (Full Voice Experience) 🎤

For the full voice experience with speech recognition and text-to-speech:

Prerequisites:

• Python 3.7 or higher
• Microphone connected to your computer
• Internet connection (for speech recognition)

Installation:

1. Install base dependencies:

pip install -r requirements.txt

2. Install voice agent dependencies (requires system libraries):

pip install -r requirements-voice.txt

Note for macOS users: You may need to install PortAudio first:

brew install portaudio
pip install -r requirements-voice.txt

Note for Linux users: You may need to install:

sudo apt-get install portaudio19-dev python3-pyaudio
pip install -r requirements-voice.txt

Note for Windows users: PyAudio should install directly, but if you have issues, download the appropriate wheel from here.

3. Run the voice agent:

python main.py

🎤 Usage

1. Start the program - the waitress will greet you
2. Speak your order naturally (e.g., "I'd like a salmon bowl")
3. Ask for the menu by saying "menu" or "menú"
4. Confirm your order by saying "that's all" or "eso es todo"
5. The waitress will confirm your order and you can place another or exit

Example Interactions

• Customer: "Hola, can I see the menu?"

• Waitress: Reads the menu

• Customer: "I want a salmon bowl and a kiwi brunch"

• Waitress: "Great! I've added Salmon Bowl, Kiwi Brunch to your order. Anything else?"

• Customer: "That's all"

• Waitress: "Perfect! Your order is confirmed..."

🌍 Language Support

The agent supports both Spanish and English, perfect for Cartagena's international visitors!

🛠️ Technical Details

• Speech Recognition: Google Speech Recognition API (works offline with fallback)
• Text-to-Speech: pyttsx3 (offline TTS engine)
• Language: Configured for Colombian Spanish (es-CO) with English support

📝 Project Structure

luisquisite/
├── main.py              # Main entry point (voice agent)
├── app.py               # Web interface (Streamlit)
├── voice_agent.py       # Speech recognition and TTS
├── order_handler.py     # Order processing logic
├── menu.py              # Menu configuration
├── requirements.txt     # Python dependencies
└── README.md           # This file

🔧 Customization

You can customize the menu in menu.py and adjust TTS settings (voice speed, volume) in voice_agent.py.

⚠️ Troubleshooting

• Microphone not working: Check your system's microphone permissions
• Speech not recognized: Speak clearly and ensure there's not too much background noise
• PyAudio installation issues: See installation notes above for platform-specific solutions

📄 License

This project is created for Luisquisite restaurant.