Technical Excellence

• Type-Safe Development - Built with TypeScript on Deno runtime
• Production-Ready - Error handling, validation, and graceful degradation built-in
• Comprehensive Logging - Detailed diagnostic logging for troubleshooting API issues

🚀 Quick Start

Prerequisites

1. Install Deno:

   curl -fsSL https://deno.land/install.sh | sh
   

2. Configure API Keys:

   Groq (Recommended - Free & Fast)

   Uses LLaMA (Meta's open-source LLM) with Groq's high-performance inference API.

   export GROQ_API_KEY="gsk-your-groq-api-key-here"
   export GROQ_MODEL="llama-3.1-8b-instant"  # Optional - defaults to LLaMA 3.1 8B Instant
   

   Get your key: https://console.groq.com/keys

   Tavily (For Job Search)

   export TAVILY_API_KEY="your-tavily-key"
   

   Get your key: https://tavily.com

   OpenAI (Alternative)

   export OPENAI_API_KEY="sk-your-api-key-here"
   export OPENAI_MODEL="gpt-4o-mini"  # Optional - defaults to gpt-4o-mini
   

   Get your key: https://platform.openai.com/api-keys

   Note: Groq is recommended for development (free tier available). OpenAI is used as a fallback if Groq API key is not configured. Tavily is optional—without it, the app uses mock data for demonstration.

Running the Application

deno task run:server

Open http://localhost:8000 in your browser.

Note: The interface features a futuristic dark mode design with prominent animated gradients, glowing effects, and modern AI aesthetics. The design includes dynamic gradient animations (8-10s cycles), shimmer effects on the logo and "JobMatch AI" text (2s cycles), glowing borders, scanline overlays, and sophisticated glassmorphism effects for a cutting-edge user experience. The layout is optimized for desktop screens with drag-to-resize panels for side-by-side content.

Usage Flow

1. Add your resume (required for all features) - You can either:

   • Paste your resume text directly into the textarea, or
   • Upload a file using the "📄 Upload Your Resume - I'll Take It From Here!" button:
     • PDF files (.pdf) - Full support
     • Word documents (.docx, .doc) - DOCX fully supported, DOC with limited support
     • Text files (.txt) - Full support
   • Text will be automatically extracted and populated into the textarea
   • Button shows "✅ Upload Successful! Your Resume is Ready" after successful upload

2. Start JobMatch AI:

   • Click "🚀 Let's Get Started! I'm Ready to Help You Find Your Dream Job"
   • The resume input disappears with a smooth fade-out transition
   • Resume Strength Analysis appears on the left (runs automatically)
   • Job Search appears on the right (runs automatically without keywords)
   • Both features run simultaneously and display results side-by-side

3. Refine Job Search (optional):

   • Scroll down to see the "🎯 Refine Your Job Search" section
   • Enter optional keywords: Job Type/Role, Location, Additional Keywords
   • Click "🔍 Perfect! Let me find amazing opportunities that match exactly what you're looking for"
   • New job results appear in the scrollable wrapper above the refine section
   • Input fields clear automatically after search

4. Analyze Match & Generate Cover Letter:

   • Click "💼 Excited about a specific role? Share the job description with me and I'll dive deep into analyzing your perfect match, then craft a compelling cover letter that showcases your strengths!"
   • This button appears immediately but is disabled until the initial job search completes
   • Once enabled, click it to reveal a full-page job description input
   • Paste the job description and click "✨ Let's Do This! Analyze My Match & Create My Perfect Cover Letter"
   • Analyze Match results appear on the left
   • Cover Letter appears on the right with a copy-to-clipboard button
   • Both results are displayed side-by-side with resizable panels

5. Navigation:

   • Use "🔄 Found Another Great Opportunity? I'm Ready to Analyze It for You!" to analyze a different job
   • Use "🔁 Want to review your resume strengths or search more jobs? Let's jump back." to return to the main results view

Note: The interface uses progressive disclosure - features appear and disappear smoothly as you progress through the workflow. All content fits within one page with internal scrolling for job results and long content areas.

🏗️ Architecture

Project Structure

jobmatch-ai/
├── src/
│   ├── agent.ts              # Core Zypher agent logic (analysis, job search, resume strength, cover letter)
│   ├── server.ts             # HTTP server & routing
│   └── tools/
│       ├── file_parser.ts    # Multi-format file text extraction (PDF, Word, TXT)
│       ├── job_search.ts     # Tavily integration
│       └── local_parser.ts   # Fallback skill parser
├── sample/                   # Sample data files
├── index.html                # Modern responsive web interface
├── deno.json                 # Configuration
└── README.md

Technology Stack

Core Framework

• Zypher (@corespeed/zypher) - CoreSpeed's AI agent framework
• LLaMA (Meta's open-source LLM) - Large language model for intelligent analysis (via Groq)
• Groq API - High-performance inference provider for LLaMA (fast, free tier available, recommended)
• OpenAI API - Alternative LLM provider (fallback if Groq is not configured)
• Tavily API - AI-optimized web search with content extraction

Runtime & Language

• Deno - Modern TypeScript runtime
• TypeScript - Type-safe development
• RxJS (rxjs-for-await) - Reactive event streams

Additional Libraries

• pdf-parse - PDF text extraction for resume uploads
• mammoth - Word document (DOCX) text extraction

How It Works

1. Resume Input

   • Users can paste resume text or upload a file (PDF, Word, or TXT)
   • Files are automatically parsed to extract text content:
     • PDF: Uses pdf-parse library
     • Word (DOCX): Uses mammoth library
     • Word (DOC): Limited support, may require conversion to DOCX
     • TXT: Direct text extraction
   • Extracted text is populated into the resume textarea

2. Agent Initialization

   • Creates Zypher context and initializes model provider
   • Uses LLaMA (Meta's open-source LLM) via Groq inference API for fast, cost-effective analysis
   • Falls back to OpenAI if Groq API key is not configured
   • Configures streaming support for real-time responses

3. Analysis Pipeline

   • Structured prompt engineering for consistent JSON output
   • Streaming response processing with event accumulation
   • Post-processing: filters non-technical terms, validates skill matches, auto-corrects errors
   • Comprehensive error handling with detailed logging

4. Job Discovery

   • Tavily API searches web for relevant positions
   • Intelligent filtering by job board name (catches all domain variations: .com, .ca, .co.uk, etc.)
   • Automatically filters out 36+ job boards including LinkedIn, Indeed, Glassdoor, Eluta, Levels.fyi, Workopolis, and more
   • AI analysis ranks top 3 matches by resume fit
   • Returns structured results with match breakdowns

5. Resume Strength Analysis

   • Comprehensive resume quality assessment
   • ATS compatibility scoring
   • Identifies strengths, weaknesses, and improvement areas
   • Provides actionable suggestions for enhancement