ancv  by alexpovel

CLI tool for rendering JSON resumes/CVs to terminal or web

created 3 years ago
263 stars

Top 97.6% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides a tool to render JSON resumes for display in terminals and online. It targets developers and job seekers who want a simple, customizable way to present their professional profiles. The primary benefit is a visually appealing, portable resume format that can be easily shared and viewed across different environments.

How It Works

The tool parses a resume formatted according to the JSON Resume Schema. It then applies user-defined templates and themes to customize the output's appearance, including colors, text formatting, and layout. This approach allows for significant visual customization without requiring complex rendering engines or web frameworks, focusing on terminal-friendly ANSI escape codes for rich display.

Quick Start & Requirements

  • Install: pip install ancv or docker pull ghcr.io/alexpovel/ancv
  • Prerequisites: Python 3.x, Docker (for container usage). Terminal with Unicode and emoji support recommended for full visual fidelity.
  • Usage: curl -L ancv.povel.dev/<your_github_username> or ancv render resume.json.
  • Docs: JSON Resume Schema

Highlighted Details

  • Supports custom templates, themes, and language translations for output customization.
  • Includes a built-in web server for self-hosting and live previewing of resume changes.
  • Offers an ASCII-only output option for maximum compatibility.
  • Can render resumes directly from public Gists or GitHub URLs.

Maintenance & Community

The project is maintained by alexpovel. Contributions via Pull Requests for templates, themes, or translations are welcomed.

Licensing & Compatibility

The project is licensed under the MIT License, allowing for commercial use and integration into closed-source projects.

Limitations & Caveats

The visual output quality is highly dependent on the user's terminal emulator and installed fonts, particularly for Unicode characters and emojis. The README notes that some LinkedIn export tools may produce output requiring manual correction to conform to the JSON Resume Schema.

Health Check
Last commit

2 months ago

Responsiveness

1 day

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

Explore Similar Projects

Feedback? Help us improve.