AI Voice Assistant

This repository contains an AI Voice Assistant application built with Python and React.

This project is intended for personal use and demonstration purposes.

Structure

The repository is organized into two main folders:

• backend/: Contains the Python FastAPI backend code.
• frontend/: Contains the React Next.js frontend code.

Installation

Prerequisites ✅

• Python 3.11 or higher
• Node.js 18.17 or higher

Backend

1. Navigate to the backend folder and install the Python dependencies. If you are using pip, you can use the provided requirements.txt file.

   cd backend
   pip install -r requirements.txt

2. Create a .env file in the backend folder and set the required environment variables:

   • GROQ_API_KEY: Your Groq API key.
   • DEEPGRAM_API_KEY: Your Deepgram API key.

Frontend

1. Navigate to the frontend folder and install the JavaScript dependencies:

   cd frontend
   npm install

2. Create a .env file in the frontend folder with the required environment variable:

   • NEXT_PUBLIC_WEBSOCKET_URL: The WebSocket URL to connect to the backend API.

Running the Application

To run the full-stack web application:

1. Start the backend server:

   cd backend
   fastapi dev app/main.py

2. In a separate terminal, start the frontend server:

   cd frontend
   npm run dev

3. Open your web browser and visit http://localhost:3000 to access the application.