Resume Pro

Resume Pro is an open-source, local-first AI resume editor for managing resumes, previewing multiple templates, improving content with AI, and scoring resume fit against job descriptions.

ResumePro.mp4

Highlights

• Local-first by default, using SQLite out of the box with optional Postgres support.
• Structured resume editing across personal information, summary, work experience, projects, education, skills, and other sections.
• Seven built-in templates: Classic, Modern, Compact, Elegant, Timeline, Creative, and Academic.
• Live preview, resume font selection, section reordering, and print/PDF export.
• AI-assisted editing with Chat, Edit, and Plan modes. Edit and Plan changes are reviewed before they are applied.
• Job fit analysis that compares saved job descriptions against existing resumes and returns a 10-point score, strengths, gaps, and improvement suggestions.
• Eight interface languages, three themes, and bundled multilingual fonts.
• Browser-based local app with Electron packaging support for macOS, Windows, and Linux.

Tech Stack

• Next.js 16
• React 19
• TypeScript
• Tailwind CSS
• Drizzle ORM
• SQLite / Postgres
• AgentScope for the resume assistant
• LangChain for job fit analysis
• OpenAI-compatible AI APIs
• Electron

Prerequisites

• Node.js 20.9 or newer (Node.js 22 recommended)
• npm
• Native build tools if a prebuilt better-sqlite3 binary is unavailable for your platform

Local Development

Install dependencies:

npm ci

Copy the example environment file. .env is used by both the web app and database CLI commands:

cp .env.example .env

Start the local web app:

npm run dev

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

AI And Database Configuration

Resume Pro uses SQLite by default, with the local database stored at ./data/resume-pro.sqlite. To use Postgres instead, configure .env with:

DATABASE_PROVIDER=postgres
DATABASE_URL=postgres://user:password@localhost:5432/resume_pro

AI features use an OpenAI-compatible API:

AI_API_URL=https://api.openai.com/v1
AI_API_KEY=your-api-key
AI_API_MODEL=gpt-4o-mini

Any provider that exposes an OpenAI-compatible base URL can be used. The same settings are shared by the AgentScope resume assistant and LangChain job fit analysis. See .env.example and the AI documentation for optional model, temperature, history, and skill settings.

If AI_API_KEY is not configured, core resume editing still works. The AI assistant and job fit analysis will prompt for AI configuration. Keep secrets out of version control.

Database tables are created automatically during normal startup; db:push is only needed while developing schema changes.

Electron Desktop App

Start Electron in development mode:

npm run dev:electron

Build the desktop app:

npm run build:electron

Create an unpacked build for local inspection:

npm run pack:electron

The packaged app runs its own local Next.js server and stores its configuration and SQLite database under ~/.resume-pro/. AI settings can be changed in System Settings and take effect after restarting the app.

build:electron creates the installer configured for the host platform: DMG on macOS, NSIS on Windows, or AppImage on Linux.

Docker

Pull the published image from GitHub Container Registry and run it:

docker pull ghcr.io/hchen90/resume-pro
docker run --rm -p 3000:3000 \
  --env-file .env \
  -v resume-pro-data:/app/data \
  ghcr.io/hchen90/resume-pro

Common Commands

• npm run dev - Start the Next.js development server.
• npm start - Start a previously built production server.
• npm run dev:electron - Start Next.js and open the Electron development app.
• npm run build - Generate release notes and build the production Next.js app.
• npm run build:electron - Build and package the Electron desktop app.
• npm run pack:electron - Create an unpacked desktop build for inspection.
• npm run lint - Run ESLint.
• npm run typecheck - Run TypeScript type checking.
• npm run test - Run the Vitest test suite.
• npm run test:coverage - Run tests with coverage enforcement.
• npm run db:generate - Generate Drizzle database migration files.
• npm run db:push - Push the current Drizzle schema to the configured database.
• npm run release-notes:generate - Regenerate release notes from Git history.

Documentation

• Documentation index
• Architecture and data flow
• Resume model and patches
• Templates
• AI assistant
• Job matching
• API routes
• Electron runtime and packaging

License

Resume Pro is released under the MIT License.