BondsAI Student is an AI-powered interview practice platform designed specifically for university students and recent graduates preparing for internships, graduate roles, and part-time jobs. Transform your interview skills through gamified practice sessions with detailed feedback and a visual journey tracking your progress.

• Gamified Learning Journey: Track your progress with a roadmap showing your practice sessions as landmarks
• Visual Progress Tracking: See your growth over time with skill statistics, streaks, and session history
• Practice Limit: Up to 5 practice interviews to focus on quality improvement

• Formal Interview Experience: Practice with AI interviewers that conduct realistic, professional mock interviews
• Adaptive Question Sets: Questions tailored to your field, year level, and target role type
• Multiple Question Types: Behavioral (STAR), motivational, and role-specific questions
• 10-15 Question Sessions: Realistic interview length to build stamina and confidence

• Comprehensive Skill Assessment: Get scored (0-100) across multiple categories:

  • Technical Skills (Quantitative Reasoning, Programming, Market Knowledge, Data Analysis)
  • Behavioral Traits (Problem-solving, Teamwork, Initiative, Resilience, Adaptability)
  • Cultural Fit (Collaborative Thinking, Continuous Learning, Challenge-seeking, Entrepreneurial Spirit)
  • Soft Skills (Communication, Decision-making, Time Management, Leadership)

• Student-Focused Coaching: Detailed feedback report with:

  • What you did well (with specific examples)
  • Areas for improvement (with why it matters and how to fix it)
  • Recommended future steps (actionable practice actions)
  • Common student interview mistakes and how to avoid them
  • STAR framework coaching and answer structure guidance

• Visual Roadmap: See your interview journey with landmarks representing each practice session
• Skill Statistics: Track your performance across different skill categories
• Session History: Review past practice sessions with detailed breakdowns
• Growth Plan: Turn feedback into actionable improvement plans

• Python 3.8+
• OpenAI API key
• pip or uv package manager

1. Clone the repository

   git clone <repository-url>
   cd BondsAI-Student

2. Install dependencies

   pip install -r requirements.txt
   # OR using uv
   uv pip install -r requirements.txt

3. Set up environment variables

   cp env.example .env

   Edit .env and add your OpenAI API key:

   OPENAI_API_KEY=your_api_key_here
   

4. Run the server

   python api_server.py

   The server will start at http://localhost:8000

1. Open http://localhost:8000/applicant in your browser
2. Start a practice interview session
3. Answer questions naturally - the AI will conduct a formal mock interview
4. Complete 10-15 questions
5. Review your detailed feedback report

1. Open http://localhost:8000/journey to see your progress
2. Click on landmarks to view detailed session feedback
3. Explore skill categories and improvement recommendations
4. Track your growth over time

BondsAI-Student/
├── api_server.py              # Flask API server
├── src/
│   ├── bondsai/
│   │   ├── job_screening.py  # Interview assistant & assessment logic
│   │   └── config.py         # Configuration management
│   └── server/
│       ├── ApplicantManager.py      # Session management
│       ├── AIAssessmentCompiler.py  # Assessment formatting
│       ├── AssessmentFileLoader.py  # Parse assessment files
│       └── DeltaTimeRecorder.py     # Time tracking
├── static/
│   ├── applicant.html        # Interview practice page
│   ├── journey.html          # Progress journey page
│   ├── scripts/
│   │   ├── script.js         # Interview chat logic
│   │   └── journeyscript.js # Journey page logic
│   └── styles/
│       ├── styles.css        # Main styles
│       └── journeystyles.css # Journey page styles
└── assessments/              # Generated assessment reports

• Quantitative Reasoning: Analytical thinking and problem-solving
• Programming Skills: Technical capabilities relevant to your field
• Market/Industry Knowledge: Understanding of your target industry
• Data Analysis: Ability to work with information and draw insights

• Problem-solving: Approach to challenges and obstacles
• Teamwork: Collaboration and working with others
• Initiative: Proactive behavior and self-direction
• Resilience: Handling setbacks and bouncing back
• Adaptability: Flexibility and adjusting to change

• Collaborative Thinking: Working together to achieve goals
• Continuous Learning: Growth mindset and skill development
• Challenge-seeking: Embracing difficult problems
• Entrepreneurial Spirit: Taking ownership and initiative

• Communication: Clarity, structure, and conciseness
• Decision-making: Approach to making choices
• Time Management: Organization and prioritization
• Leadership: Influence and taking charge

After each practice interview, a detailed assessment report is generated and saved in the assessments/ directory. Reports include:

• Session metadata: Date, duration, number of exchanges
• Skill scores: Detailed breakdown across all categories
• Strengths: What you did well with examples
• Areas for improvement: Specific weaknesses with actionable fixes
• Recommended steps: Concrete practice actions for next session
• Full interview transcript: Complete conversation for review

• Landmarks: Each practice session appears as a clickable landmark on your journey
• Progress Tracking: See your path from first practice to interview-ready
• Stars & Scores: Visual indicators of your performance on each session
• Locked Content: Future landmarks show what's ahead

• Streak Counter: Track your practice consistency
• Total Sessions: Number of completed practice interviews
• Average Score: Overall performance across all sessions

• Skill Breakdown: View scores for each category
• Category Feedback: Click skill categories to see detailed feedback
• Improvement Areas: Specific weaknesses and how to address them
• Future Steps: Actionable recommendations for next practice

• OPENAI_API_KEY: Your OpenAI API key (required)
• OPENAI_MODEL: Model to use (default: gpt-4)
• OPENAI_TEMPERATURE: Response randomness (default: 0.7)
• OPENAI_MAX_TOKENS: Maximum response length (default: 500)

• Modify src/bondsai/job_screening.py to adjust interview style or assessment criteria
• Update static/styles/journeystyles.css to customize the journey page appearance
• Edit assessment prompts in generate_assessment_report() to change feedback format

1. Be Honest: Answer questions based on your real experiences
2. Use STAR Framework: Structure behavioral answers (Situation, Task, Action, Result)
3. Quantify Impact: Include numbers and metrics when possible
4. Practice Regularly: Complete multiple sessions to see improvement
5. Review Feedback: Focus on the "Areas for Improvement" and "Recommended Steps"

• Prepare 3-5 STAR stories covering different scenarios
• Practice your "Tell me about yourself" answer (keep it under 2 minutes)
• Research the role and company before practice sessions
• Be concise - avoid rambling
• Ask thoughtful questions at the end

python api_server.py

Server runs with debug mode enabled by default.

• GET /applicant - Start a practice interview session
• POST /applicant/chat - Send message during interview
• POST /applicant/end - End interview session
• GET /journey - View progress journey page
• GET /api/recruiter/applicants - Get all practice sessions (for journey page)
• GET /api/assessment/raw/<filename> - Get raw assessment text

Built for students, by students. Practice makes perfect! 🎓✨