Skip to content

Arjunhg/wemakedevs

Repository files navigation

WiseHire - AI Interviews. Real Market Data. Unstoppable Preparation.

wisehire Landing Page

n8n Automation via Cerebras

🏆 WeMakeDevs Hackathon - Productivity & Workflow Tool
An AI-powered interview preparation platform built with Cerebras AI, n8n, and Next.js.

🚀 Live Demo

🎯 What WiseHire Does

wisehire revolutionizes interview preparation by:

  • 🔍 Real-Time Market Intelligence: Scrapes current Google Link job postings using Search API to generate relevant interview questions
  • 📝 Adaptive Question Generation: Creates personalized questions based on uploaded resumes or manual job descriptions via Cerebras Inference
  • 💡 Intelligent Feedback System: Provides comprehensive performance analysis and improvement suggestions
  • 🔐 Secure User Management: Implements Clerk authentication with personalized interview history tracking

🏗️ Architecture

Technology Stack

  • Frontend: Next.js 15 with React 19, TypeScript, Tailwind CSS
  • Backend: Next.js API routes with Convex database
  • AI Integration: Cerebras AI, Murf AI, AssemblyAI
  • Authentication: Clerk for secure user management
  • File Storage: ImageKit for PDF resume uploads
  • Rate Limiting: Arcjet for API protection and credit management

n8n Workflow Integration

Our "unstoppable workflow" leverages n8n's automation capabilities:

Webhook → Resume Check → Branch Logic:
├── With Resume: Upload → Extract PDF → Parse with Cerebras → Scrape Google Links → Generate Questions
└── Without Resume: Scrape Google Link → Clean Data → Generate Questions

Key Components:

  • n8n AI Agent Nodes: Cerebras Llama for question generation + and for resume parsing
  • Search API Integration: Two instances scraping Google link job postings based on job titles
  • Dynamic Processing: Custom code nodes for HTML cleaning and data optimization
  • Intelligent Branching: Different workflow paths based on user input type

🔧 Getting Started

Prerequisites

  • Node.js 18+
  • npm/yarn/pnpm
  • n8n Cloud account (or self-hosted)
  • Required API keys (see Environment Variables)

Installation

  1. Clone the repository

    git clone https://github.com/Arjunhg/wemakedevs.git
    cd wisehire
  2. Install dependencies

    npm install
    # or
    yarn install
    # or
    pnpm install
  3. Set up environment variables Create a .env.local file with:

    # n8n Webhook URLs
    N8N_URL_ENDPOINT=your_n8n_webhook_url
    
    MURF_API_KEY=your_murf_api_key
    ASSEMBLYAI_API_KEY=your_assemblyai_api_key
    
    # ImageKit
    IMAGEKIT_URL_PUBLIC_KEY=your_imagekit_public_key
    IMAGEKIT_URL_PRIVATE_KEY=your_imagekit_private_key
    IMAGEKIT_URL_ENDPOINT=your_imagekit_endpoint
    
    # Clerk Authentication
    NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
    CLERK_SECRET_KEY=your_clerk_secret_key
    NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
    NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
    NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/
    NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/
    
    # Convex Database
    NEXT_PUBLIC_CONVEX_URL=your_convex_url
    CONVEX_DEPLOYMENT=your_convex_deployment
    
    # Arcjet Rate Limiting
    ARCJET_KEY=your_arcjet_key
  4. Set up Convex database

    npx convex dev
  5. Run the development server

    npm run dev

    Open http://localhost:3000 to see the application.

🤖 n8n Workflows

Enhanced Question Generation Workflow

  • Features: Dual-path processing for resume-based and manual job description flows
  • AI Nodes: Cerebras llama model for question generation and resume parsing
  • Scraping: Scrapes Google links via search API job postings for market-relevant questions

Interview Feedback Generator

  • Features: Analyzes interview conversations and provides detailed performance feedback
  • AI Processing: Uses Cerebras llama to generate personalized improvement suggestions

📱 Features

Core Functionality

  • Resume Upload & Analysis: PDF processing with AI-powered content extraction
  • Job Description Input: Manual job details for targeted question generation
  • Voice-Based Interviews: Natural conversation flow with AI avatars
  • Real-Time Feedback: Instant performance analysis and suggestions
  • Interview History: Track progress and previous sessions
  • Credit Management: Rate limiting with user credit system

User Experience

  • Responsive Design: Mobile-first approach with dark/light theme support
  • Progressive Loading: Smooth transitions and loading states
  • Accessibility: WCAG compliant interface design
  • Error Handling: Comprehensive error states and recovery options

🔗 API Endpoints

  • POST /api/generate-interview-question - Triggers n8n workflow for question generation
  • POST /api/interview-feedback - Processes interview conversation for feedback
  • POST /api/akool-session - Manages AI avatar session creation
  • POST /api/akool-knowledge-base - Handles knowledge base operations
  • POST /api/murf-tts - Generates speech using Murf AI
  • POST /api/assemblyai-stream - Transcribes audio using AssemblyAI

🚀 Deployment

This project is deployed on Vercel. To deploy your own instance:

  1. Deploy to Vercel

    npm run build
  2. Configure environment variables in your Vercel dashboard

  3. Set up n8n webhooks and update the URLs in your environment

🤝 Contributing

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

📄 License

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

🙏 Acknowledgments

  • Cerebras for providing the AI infrastructure
  • n8n for providing the automation platform and AI Agent nodes
  • murf for voice synthesis
  • Vercel for seamless deployment and hosting

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors