A minimal, easy-to-use AI-powered interview simulator that helps users practice interviews, receive real-time feedback, and improve interview skills.

simple-ai-interviewer is a lightweight multi-agent system built with Autogen. It simulates a complete interview process with three core roles:

• Interviewer: Asks targeted questions (technical skills, problem-solving, cultural fit) based on the job position.
• Candidate: You (the user) respond to interview questions interactively.
• Career Coach: Provides constructive feedback on your answers and summarizes performance after the interview.

Designed for simplicity and learnability—perfect for students, job seekers, or anyone looking to practice interview skills.

• Multi-Role Collaboration: Automated interviewer + real user candidate + AI career coach.
• Lightweight & Fast: Uses gpt-4o-mini for balance of performance and cost.
• Real-Time Feedback: Career coach offers instant suggestions after each response.
• Controlled Flow: Automatically ends after 3 interview questions (via TERMINATE signal).
• Easy Customization: Modify job position, interview questions, or model with minimal code changes.

• Python 3.9+
• An OpenAI API key (sign up here)
• git (for cloning the repo)

git clone https://github.com/XiaomingX/simple-ai-interviewer.git
cd simple-ai-interviewer

Create a virtual environment (optional but recommended) and install required packages:

# Create virtual env (Windows)
python -m venv venv
venv\Scripts\activate

# Create virtual env (macOS/Linux)
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Create a requirements.txt file in the project root with these dependencies:

autogen>=0.2.0
python-dotenv>=1.0.0
asyncio>=3.4.3

Create a .env file in the project root to store your OpenAI API key (never commit this file to GitHub!):

# .env file
OPENAI_API_KEY=your-openai-api-key-here

1. Run the Interview

   python main.py

2. Interview Flow

   1. The interview starts automatically with the interviewer asking the first question.
   2. Type your answer when prompted (as the candidate) and press Enter.
   3. The career coach will provide feedback on your answer.
   4. Repeat until the interviewer asks 3 questions and ends with TERMINATE.
   5. The career coach will then summarize your overall performance.

Tweak the tool to fit your needs by modifying main.py:

• Core Framework: Autogen (multi-agent collaboration)
• LLM: OpenAI GPT-4o-mini (configurable)
• Environment Management: python-dotenv
• Async Handling: asyncio

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Make your changes and commit (git commit -m "Add your feature").
4. Push to the branch (git push origin feature/your-feature).
5. Open a Pull Request.

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

If you run into issues:

1. Check the Autogen Documentation for common problems.
2. Open an Issue in the repo with details about your problem.