https://github.com/franciscomoretti/ai-mock-interview

Practice interviews with AI - Elevenlabs conversational AI
https://github.com/franciscomoretti/ai-mock-interview

conversational-ai elevenlabs interview-preparation mock-interviews

Last synced: about 1 month ago
JSON representation

Practice interviews with AI - Elevenlabs conversational AI

• Host: GitHub
• URL: https://github.com/franciscomoretti/ai-mock-interview
• Owner: FranciscoMoretti
• License: mit
• Created: 2025-04-08T17:45:49.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2025-04-17T17:49:40.000Z (2 months ago)
• Last Synced: 2025-05-08T23:56:18.681Z (about 1 month ago)
• Topics: conversational-ai, elevenlabs, interview-preparation, mock-interviews
• Language: TypeScript
• Homepage:
• Size: 10.1 MB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 🎯 AI Mock Interview

An AI-powered interview practice platform built with [ElevenLabs Conversational AI SDK](https://www.npmjs.com/package/@11labs/react).

https://github.com/user-attachments/assets/2f967812-ca03-4d1f-bf62-6c516df6c453

## Features

- 🎯 Any interview topic and difficulty level

- ⚡️ Instant feedback on your answers

- ✨ Personalized suggestions to improve your answers

- 📊 Final score and a detailed report of your interview

## Prerequisites

- Node.js 16 or higher

- pnpm installed globally

- An [ElevenLabs](https://elevenlabs.io) account

## Setting up the Agent

1. Set-up a Conversational AI agent in ElevenLabs [Guide](https://elevenlabs.io/docs/conversational-ai/docs/agent-setup).

2. Enable overrides in agent Settings => Security => Enable overrides.

3. Add the following client-tools:

  - name: `triggerName`

    - Description: When the person tells you their name, call this function to store in memory.

    - Parameter 1:

      1. Data type: String

      2. Identifier: name

      3. Description: The name of the user.

  - name: `triggerQuestionAsked`

    - Description: When you ask a new interview question, call this function.

    - Parameter 1:

      1. Data type: String

      2. Identifier: questionId

      3. Description: A unique identifier for the question (e.g., "q1").

    - Parameter 2:

      1. Data type: String

      2. Identifier: questionText

      3. Description: The full text of the question being asked.

  - name: `triggerAnswerFeedback`

    - Description: After getting an answer from the user, call this function.

    - Parameter 1:

      1. Data type: String

      2. Identifier: questionId

      3. Description: The ID of the question being answered.

    - Parameter 2:

      1. Data type: String

      2. Identifier: answer

      3. Description: The answer provided by the user.

    - Parameter 3:

      1. Data type: String

      2. Identifier: feedback

      3. Description: Your feedback on the answer.

    - Parameter 4:

      1. Data type: Number

      2. Identifier: score

      3. Description: A score from 1-10 for the answer.

    - Parameter 5:

      1. Data type: Array

      2. Identifier: suggestions

      3. Description: Specific suggestions for improving the answer.

      4. Array items:

        - Data type: String

        - Description: A suggestion for improving the answer.

  - name: `triggerInterviewComplete`

    - Description: When providing the final assessment, call this function.

    - Parameter 1:

      1. Data type: Number

      2. Identifier: overallScore

      3. Description: The overall interview score (1-10).

    - Parameter 2:

      1. Data type: Array

      2. Identifier: strengths

      3. Description: Key strengths demonstrated during the interview.

      4. Array items:

        - Data type: String

        - Description: A strength demonstrated by the candidate.

    - Parameter 3:

      1. Data type: Array

      2. Identifier: areasForImprovement

      3. Description: Areas where the candidate needs improvement.

      4. Array items:

        - Data type: String

        - Description: An area where the candidate needs improvement.

    - Parameter 4:

      1. Data type: Array

      2. Identifier: nextSteps

      3. Description: Recommended next steps for preparation.

      4. Array items:

        - Data type: String

        - Description: A recommended next step for preparation.

## Setting up the Project

1. `pnpm install`

2. `cp .env.example .env`

3. Add your `AGENT_ID` & `XI_API_KEY` to the `.env` file

3. `pnpm run dev`

## 📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.