Voice-first AI nutrition agent for Nigeria (English, Igbo, Hausa, Yoruba) — split from NutriDine
# 🎙️ NutriVoice AI Nigeria
A voice-first AI agent for nutritional consultations, appointment booking, and
healthy food ordering in Nigeria — supporting **English, Igbo, Hausa, and Yoruba**.
Split out of the NutriDine monorepo into
its own standalone repository.
---
## ✨ Features
- **Live voice consultations** — real-time, speech-driven nutrition guidance
- **Appointment booking** — schedule meal-plan reviews and consultations
- **Healthy food ordering** — browse and order local dishes (Jollof Rice, Plantain, etc.)
- **Multilingual** — English, Igbo, Hausa, and Yoruba
- **Location-aware** — suggests nearby restaurants/services
- **Live transcript** — captures and displays the conversation as it happens
---
## 🛠️ Tech Stack
| Layer | Technology |
|-------|-----------|
| Frontend | React 19, TypeScript, Vite 6 |
| AI | Google Gemini (`@google/genai`) |
| Icons | lucide-react |
| Audio | Web Audio API + mic capture |
---
## 📁 Structure
```
nutrivoice/
├── App.tsx # Main application shell
├── index.tsx # React entry point
├── components/
│ ├── LiveConsultation.tsx # Voice consultation session
│ └── AudioVisualizer.tsx # Microphone audio visualization
├── utils/
│ └── audio.ts # Audio capture helpers
├── types.ts # Shared TypeScript types
├── index.html # Vite entry HTML
└── vite.config.ts
```
---
## ⚡ Quick Start
**Prerequisites:** Node.js 18+
```bash
# 1. Clone
git clone
github.com
cd nutrivoice
# 2. Install dependencies
npm install
# 3. Configure the Gemini API key
# Create .env.local with:
# GEMINI_API_KEY=your_gemini_key
# 4. Run the dev server
npm run dev
```
Open
localhost and allow microphone access to start a consultation.
---
## 🧪 Build & Preview
```bash
npm run build # production build (what CI runs)
npm run preview # serve the production build
```
---
## 🔑 Configuration
` …