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"