https://github.com/urmzd/incipit
Here begins the new career. A template-driven CLI that transforms structured resume data into polished PDFs, DOCX, HTML, LaTeX, and Markdown — with pluggable templates and multi-agent AI assessment.
https://github.com/urmzd/incipit
agent-skill ai automation career-tools cli cv docx go html incipit latex markdown ollama pdf resume resume-builder template template-engine
Last synced: 3 months ago
JSON representation
Here begins the new career. A template-driven CLI that transforms structured resume data into polished PDFs, DOCX, HTML, LaTeX, and Markdown — with pluggable templates and multi-agent AI assessment.
- Host: GitHub
- URL: https://github.com/urmzd/incipit
- Owner: urmzd
- License: apache-2.0
- Created: 2022-09-18T20:54:10.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2026-04-09T03:16:18.000Z (3 months ago)
- Last Synced: 2026-04-09T05:03:11.876Z (3 months ago)
- Topics: agent-skill, ai, automation, career-tools, cli, cv, docx, go, html, incipit, latex, markdown, ollama, pdf, resume, resume-builder, template, template-engine
- Language: Go
- Homepage:
- Size: 54.7 MB
- Stars: 11
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
Incipit
Here begins the new career.
A CLI tool that converts structured resume data (JSON/Markdown) into polished PDFs, HTML, LaTeX, DOCX, and Markdown — with AI-powered review, optimization, and creation.
Download
·
Report Bug
·
Examples
## Output Examples
Modern HTML · Modern LaTeX · Modern CV
## Features
- **Multiple Output Formats** — generate PDFs from LaTeX or HTML templates, plus native DOCX and Markdown
- **Data-Driven** — provide resume content as JSON or Markdown; the tool handles rendering
- **Template System** — modular templates with embedded assets; customize or create your own
- **AI-Powered Tools** — review, optimize, and create resumes using multi-provider LLMs (Anthropic, OpenAI, Google, Ollama)
- **Flexible Paths** — supports `~`, relative paths, and creates dated output workspaces
- **Schema Generation** — export JSON Schema for IDE autocompletion and validation
## Install
### Pre-built Binary
```bash
curl -fsSL https://raw.githubusercontent.com/urmzd/incipit/main/install.sh | bash
```
Supports **macOS** (Apple Silicon) and **Linux** (x86_64). After installation, run `incipit` from anywhere.
### Build from Source
```bash
git clone https://github.com/urmzd/incipit.git
cd incipit
go install ./cmd/incipit
```
## Quick Start
```bash
# Generate PDF with a specific template
incipit generate assets/example_resumes/software_engineer.json -t modern-html
# Generate with all templates
incipit generate assets/example_resumes/software_engineer.json
# Generate an editable DOCX
incipit generate resume.json -t modern-docx
# Validate input data
incipit generate resume.json --dry-run
# List available templates
incipit templates list
# AI: create resume from plain text
incipit ai create resume.txt -o resume.json
# AI: review a resume
incipit ai review resume.json
# AI: optimize for a job description
incipit ai optimize resume.json --job "Senior Go developer..."
```
## CLI Usage
### Generate
```bash
# Single template
incipit generate resume.json -t modern-html
# Multiple templates
incipit generate resume.json -t modern-html -t modern-latex
# Custom output directory
incipit generate resume.json -o outputs/custom -t modern-html
```
### AI Commands
AI commands support multiple providers, auto-detected from API keys (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_API_KEY`) or falling back to local Ollama.
```bash
# Create structured JSON from plain text
incipit ai create resume.txt -o resume.json
# Review/score a resume (multi-agent analysis)
incipit ai review resume.json
# Optimize resume for a specific role
incipit ai optimize resume.json --job "Senior Go developer at a startup..."
incipit ai optimize resume.json --job job-description.txt -o optimized.json
# Specify provider explicitly
incipit ai review resume.json -p anthropic -m claude-sonnet-4-6-20250514
incipit ai review resume.json -p ollama -m qwen3.5:4b
```
### Other Commands
```bash
incipit generate resume.json --dry-run # Validate and preview as JSON
incipit generate --schema # Export JSON Schema
incipit templates list # List templates
incipit templates engines # Check LaTeX engines
```
## Input Formats
Resumes are provided as **JSON** files. Use `incipit generate --schema` to get the full JSON Schema.
To convert freeform text to structured JSON, use `incipit ai create`.
## Prerequisites
- **Go 1.25+**
- **TeX Live** (only for LaTeX templates)
- **Chromium** — auto-downloaded by Rod on first use, or set `ROD_BROWSER_BIN`
- [just](https://github.com/casey/just) (optional, for helper commands)
- An LLM provider for AI commands: [Anthropic](https://anthropic.com), [OpenAI](https://openai.com), [Google](https://ai.google.dev), or [Ollama](https://ollama.com)
## Templates
Built-in templates live in `templates/`, one folder per template with a `metadata.yml` and template file:
| Template | Format | Output |
|----------|--------|--------|
| `modern-html` | HTML | PDF via Chromium |
| `modern-latex` | LaTeX | PDF via TeX Live |
| `modern-cv` | LaTeX | PDF via TeX Live |
| `modern-docx` | DOCX | Word document |
| `modern-markdown` | Markdown | `.md` file |
Create your own by adding a `templates//` directory with `metadata.yml` + template file.
## Agent Skill
This repo's conventions are available as portable agent skills in [`skills/`](skills/), following the [Agent Skills Specification](https://agentskills.io/specification).
Once installed, use `/resume` to create, review, optimize, and generate resumes from your agent.
## Contributing
Contributions welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## License
Apache 2.0