A React-based frontend application that connects directly to ElevenLabs Conversational AI agents for interactive interview coaching sessions.
- 🎙️ Direct ElevenLabs Integration - Connects directly to your ElevenLabs agent (no backend required)
- 🗣️ Voice & Text Modes - Switch between voice and text input during interviews
- 📊 Real-time Status - Visual feedback showing when the AI is speaking, listening, or idle
- 💾 Built-in Database - Uses ElevenLabs agent's built-in database
- 🎨 Modern UI - Beautiful, responsive interface with real-time animations
- Node.js (v14 or higher)
- npm or yarn
- ElevenLabs API credentials (API Key and Agent ID)
-
Clone the repository
-
Navigate to the frontend directory:
cd frontend -
Install dependencies:
npm install
or
yarn install
-
Create
.envfile in thefrontend/directory:REACT_APP_ELEVENLABS_API_KEY=sk_your_api_key_here REACT_APP_ELEVENLABS_AGENT_ID=your_agent_id_here REACT_APP_ELEVENLABS_BRANCH_ID=your_branch_id_here # Optional
-
Start the development server:
npm run dev
or
yarn dev
-
Open http://localhost:3000 in your browser
.
├── frontend/ # React frontend application
│ ├── src/
│ │ ├── pages/ # Page components
│ │ ├── services/ # ElevenLabs service integration
│ │ ├── components/ # UI components
│ │ └── styles/ # CSS styles
│ ├── public/ # Static assets
│ └── package.json # Dependencies
├── .gitignore # Root gitignore
└── README.md # This file
- Frontend README - Frontend setup and usage
- ElevenLabs Setup Guide - Detailed setup instructions
- ElevenLabs Integration Guide - Technical integration details
- API Key: Get from ElevenLabs API Keys
- Agent ID: Get from ElevenLabs Conversational AI Dashboard
- Branch ID (Optional): If using branches in your agent
- Frontend → ElevenLabs Agent (via
@11labs/clientSDK) - No backend server required
- Built-in database handled by ElevenLabs agent
All environment variables are configured in frontend/.env:
REACT_APP_ELEVENLABS_API_KEY- Your ElevenLabs API keyREACT_APP_ELEVENLABS_AGENT_ID- Your agent IDREACT_APP_ELEVENLABS_BRANCH_ID- Optional branch ID
cd frontend
npm run buildThe build artifacts will be stored in the frontend/build/ directory.
[Your License Here]