Skip to content
/ swerm Public

SWERM – AI Resume Matcher for Engineers

BishalN/swerm

Repository files navigation

SWERM - AI-Powered Resume Tailoring Tool

Transform your resume in minutes, not hours. Upload, customize, and download tailored resumes for any job application.

🚀 What is SWERM?

SWERM is a browser-based AI tool that eliminates the tedious process of manually rewriting resumes for each job application. Instead of spending 2-3 hours tailoring your resume, get a customized version in minutes.

The Problem We Solve

  • Time-consuming: Manually rewriting resumes for each application takes hours
  • Keyword matching: Difficult to identify and emphasize relevant experience
  • Formatting: Maintaining professional formatting while making changes
  • Consistency: Ensuring all versions maintain quality and accuracy

✨ Features

  • 📄 PDF Upload & Parsing: Upload your existing resume and let AI extract structured data
  • ✏️ Editable Fields: Review and edit parsed data (name, experience, skills, projects)
  • 📝 Job Description Input: Paste any job posting to analyze requirements
  • 🤖 AI Tailoring: Intelligent analysis creates an optimized version emphasizing relevant experience
  • 📥 PDF Download: Get your tailored resume in professional PDF format

🎯 How It Works

Upload PDF → Review Data → Enter Job Description → Generate → Download
  1. Upload your existing resume (PDF format)
  2. Review the AI-extracted data and make any necessary edits
  3. Paste the job description you're applying for
  4. Generate a tailored version that emphasizes relevant experience
  5. Download your customized resume as a professional PDF

🛠️ Tech Stack

  • Frontend: React + Tanstack Router + TypeScript + Vite
  • PDF Parsing: unpdf (client-side)
  • AI: Vercel AI SDK + Google Gemini
  • PDF Generation: React PDF Renderer
  • Validation: Zod
  • Styling: Modern UI components

🚀 Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • pnpm (recommended) or npm

Installation

  1. Clone the repository:
git clone https://github.com/bishaln/swerm.git
cd swerm
  1. Install dependencies:
pnpm install
  1. Start the development server:
pnpm dev
  1. Open your browser and navigate to http://localhost:5173

API Key Setup

SWERM uses Google Gemini for AI processing. You'll need to:

  1. Get a Google AI API key from Google AI Studio
  2. Enter your API key when prompted in the application
  3. The app will store your key locally for future use

📱 Usage

  1. Upload Resume: Click "Upload Resume" and select your PDF file
  2. Review Data: Check the parsed information and edit if needed
  3. Job Description: Paste the job posting text in the provided field
  4. Generate: Click "Generate Tailored Resume" and wait for AI processing
  5. Download: Save your customized resume as a PDF

🔧 Development

Available Scripts

  • pnpm dev - Start development server
  • pnpm build - Build for production
  • pnpm preview - Preview production build
  • pnpm lint - Run linter

Project Structure

src/
├── components/          # React components
│   ├── ui/             # UI component library
│   └── ...             # Feature components
├── lib/                # Utility functions
├── routes/             # Application routes
├── stores/             # State management
└── integrations/       # Third-party integrations

🎯 Roadmap

Current Version (MVP)

  • ✅ PDF upload and parsing
  • ✅ AI-powered data extraction
  • ✅ Job description analysis
  • ✅ Resume tailoring
  • ✅ PDF generation and download

Known Issues & Upcoming Fixes

  • Resume Support: Graceful handling of non-software engineer resumes
  • AI Models: Support for different AI models beyond Gemini
  • Performance: Optimize form re-rendering and tailoring speed
  • UX Improvements: Better job description feedback, auto-save functionality
  • Mobile: Responsive text sizing and mobile optimization
  • Editor: WYSIWYG editor for description fields
  • Form Handling: Better dynamic form field management

Future Enhancements

  • User accounts and authentication
  • Resume templates and styling options
  • Version history and management
  • Advanced AI features and scoring
  • Multiple export formats

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📄 License

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

🆘 Support

If you encounter any issues or have questions:

  1. Check the Issues page
  2. Create a new issue with detailed information
  3. Include steps to reproduce any bugs

🙏 Acknowledgments


Made with ❤️ for job seekers everywhere

About

SWERM – AI Resume Matcher for Engineers

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published