Faux-CV

Generate realistic fake resumes for testing and development. Customizable by industry, experience level, and output format.

🚀 Features

• ✨ Realistic content - Professionally written work experience, skills, education, and certifications
• 🏢 Multiple industries - Specialized profiles for tech, finance, healthcare, marketing, and education sectors
• 📊 Experience levels - Generate junior, mid-level, or senior professional profiles
• 📄 Multiple formats - Output in Markdown, JSON, PDF, or all formats
• 🎨 Customizable templates - Use built-in styles or create your own with Mustache templating
• 👥 Batch generation - Create multiple resumes with a single command
• 🔄 Reproducible output - Set random seeds for consistent results

📦 Installation

Install globally:

npm install -g faux-cv

Or use directly with npx:

npx faux-cv

PDF Support

To use the PDF generation feature, install the optional dependencies:

npm install puppeteer showdown

🛠️ Usage

Command Line

npx faux-cv --industry tech --experience 7 --format both

Options

| Option | Alias | Description | Default | |--------|-------|-------------|---------| | --industry <industry> | -i | Industry specialization | tech | | --experience <years> | -e | Years of experience | 5 | | --format <format> | -f | Output format (markdown, json, pdf, both) | both | | --gender <gender> | -g | Gender (male, female) | Random | | --output <filename> | -o | Output file name (without extension) | Person's name | | --no-linkedin | -l | Exclude LinkedIn profile | LinkedIn included | | --no-website | -w | Exclude personal website | Website random | | --template <filepath> | -t | Custom Mustache template file | Default template | | --count <number> | -c | Number of resumes to generate | 1 | | --seed <value> | -s | Random seed for consistent generation | Random | | --pdf-style <style> | -p | PDF style (default, modern, minimal, professional) | default | | --pdf-color <color> | | Primary color for PDF (hex code) | #0066cc | | --batch-pdf | -b | Create a single PDF containing all resumes | false |

Available Industries

• Tech: Software Engineering, IT, Data Science
• Finance: Banking, Investment, Accounting
• Healthcare: Medical, Health Services
• Marketing: Digital Marketing, Content, Branding
• Education: Teaching, Educational Administration

Examples

Generate a tech resume with 3 years of experience:

npx faux-cv -i tech -e 3

Generate 5 healthcare resumes with 10+ years of experience:

npx faux-cv -i healthcare -e 12 -c 5

Generate a finance resume in JSON format only:

npx faux-cv -i finance -f json

Generate a professional PDF resume with custom styling:

npx faux-cv -f pdf -p professional --pdf-color "#336699"