Resume-Agent  by kkooww77

AI resume system for professional document generation

Created 8 months ago
253 stars

Top 99.3% on SourcePulse

GitHubView on GitHub
Project Summary

A resume generation system that uses AI to create editable, professional PDF resumes from simple text descriptions. It targets job seekers and developers who need to quickly produce polished resumes without complex formatting, offering a complete workflow from content generation to high-quality PDF export.

How It Works

This project employs a modern web architecture, combining a React/TypeScript frontend (Vite) for a dynamic visual editor and real-time preview with a FastAPI backend (Python) that orchestrates AI agent functionalities. Core AI tasks like content generation, structuring, conversational editing, and OCR are handled by integrating with LLM providers such as DashScope (DeepSeek/Qwen) and Zhipu GLM. PDF generation is achieved server-side using XeLaTeX, ensuring professional rendering for mixed Chinese and English content.

Quick Start & Requirements

  • Primary Install: Clone the repository, install backend dependencies (pip install -r requirements.txt or uv pip install -r requirements.txt), and frontend dependencies (cd frontend && npm install && cd ..).
  • Prerequisites: Python 3.12+, Node.js 16+, XeLaTeX (e.g., sudo apt install texlive-xetex or MacTeX), and CJK fonts (e.g., sudo apt install fonts-noto-cjk). API keys for DashScope and/or Zhipu GLM are required for AI functionality.
  • Running: Start the backend with python -m uvicorn backend.main:app --host 127.0.0.1 --port 9000 and the frontend with cd frontend && npm run dev.
  • Links: Online demo: https://resumegenkk.xyz. API documentation: http://127.0.0.1:9000/docs.

Highlighted Details

  • AI-driven resume generation from a single sentence or raw text.
  • Conversational editing for incremental modifications, including polishing, translation, expansion, and summarization.
  • Intelligent parsing of existing resumes from PDF or image formats.
  • AI-powered resume diagnosis, evaluating JD matching, content completeness, and expression quality.
  • Visual editing interface with left-edit/right-preview and click/scroll editing modes.
  • Support for multiple LaTeX and HTML templates, with capabilities for custom template creation.
  • High-quality PDF export leveraging server-side XeLaTeX compilation.

Maintenance & Community

Contributions are welcomed via Issues and Pull Requests. The project encourages users to star the repository if it proves helpful. Notably, the README indicates that "pure front-end and back-end related content will no longer be updated" as a new repository has been created specifically for Agent work, suggesting a potential shift in focus.

Licensing & Compatibility

The project is released under the MIT License, which is permissive and generally suitable for commercial use and integration into closed-source projects.

Limitations & Caveats

The project's development focus appears to be shifting towards a separate "Agent" repository, with core front-end and back-end resume generation features potentially receiving less future updates. Local deployment requires careful setup of specific software dependencies and obtaining API keys for external AI services.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
0 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.