Eve - A Voice Assistant

Eve is a real-time voice assistant that listens to your voice, understands your intent, and responds in a natural-sounding voice.

Features

• Real-time Interaction: Built on LiveKit for low-latency audio processing.
• Multilingual Support: The assistant can understand and respond in multiple languages.
• Speech-to-Text: Utilizes OpenAI's whisper-large-v3 model via Groq for fast and accurate transcription.
• Language Model: Powered by the openai/gpt-oss-20b model via Groq for intelligent and coherent responses.
• Text-to-Speech: Uses ElevenLabs' eleven_multilingual_v2 model for high-quality, natural-sounding voice output.
• Noise Cancellation: Integrated with noise cancellation for clearer audio.

Getting Started

Prerequisites

• Python 3.9+
• uv (recommended for installing dependencies)

Installation

1. Clone the repository:

   git clone https://github.com/code-willow/eve.git
   cd eve

2. Install the dependencies:

   It is recommended to use uv for installation:

   uv pip install -r requirements.txt

   Alternatively, you can use pip:

   pip install -r requirements.txt

Configuration

1. Create a .env.local file in the root of the project.

2. Add the following environment variables to your .env.local file:

   ELEVEN_API_KEY=your_elevenlabs_api_key
   GROQ_API_KEY=your_groq_api_key
   LIVEKIT_URL=your_livekit_url
   LIVEKIT_API_KEY=your_livekit_api_key
   LIVEKIT_API_SECRET=your_livekit_api_secret
   

   • ELEVEN_API_KEY: Your API key for ElevenLabs.
   • GROQ_API_KEY: Your API key for Groq.
   • LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET: Your LiveKit server credentials.

Download the files for the assistant

To download the files for the assistant, run the following command:

uv run main.py download-files

Running the Application

To start the assistant, run the following command:

uv run main.py console

License

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