Incipit - 구조화된 이력서 데이터를 PDF, HTML 등으로 변환하는 CLI 도구 - Insights

<h1 align="center">Incipit</h1> 새로운 경력이 시작되는 곳. 구조화된 이력서 데이터(JSON/Markdown)를 PDF, HTML, LaTeX, DOCX, Markdown 등 세련된 형식으로 변환하는 CLI 도구입니다. AI 기반 검토, 최적화 및 생성이 가능합니다. <a href="https://github.com/urmzd/incipit/releases">다운로드</a> · <a href="https://github.com/urmzd/incipit/issues">버그 신고</a> · <a href="https://github.com/urmzd/incipit/tree/main/assets">예시</a> <a href="https://github.com/urmzd/incipit/actions/workflows/ci.yml"><img src="https://github.com/urmzd/incipit/actions/workflows/ci.yml/badge.svg" alt="CI"></a>   <a href="LICENSE"><img src="https://img.shields.io/github/license/urmzd/incipit" alt="라이선스"></a> <img src="https://raw.githubusercontent.com/urmzd/incipit/HEAD/showcase/demo-cli.gif" alt="CLI 데모" width="80%">

출력 예시

<img src="https://raw.githubusercontent.com/urmzd/incipit/HEAD/showcase/modern-html.png" alt="Modern HTML" width="30%">   <img src="https://raw.githubusercontent.com/urmzd/incipit/HEAD/showcase/modern-latex.png" alt="Modern LaTeX" width="30%">   <img src="https://raw.githubusercontent.com/urmzd/incipit/HEAD/showcase/modern-cv.png" alt="Modern CV" width="30%"> Modern HTML  ·  Modern LaTeX  ·  Modern CV

기능

다중 출력 형식(Multiple Output Formats): LaTeX 또는 HTML 템플릿에서 PDF를 생성할 수 있으며, 네이티브 DOCX 및 Markdown도 지원합니다.
데이터 기반(Data-Driven): 이력서 콘텐츠를 JSON 또는 Markdown으로 제공하면 도구가 렌더링을 처리합니다.
템플릿 시스템(Template System): 임베디드 에셋(embedded assets)을 가진 모듈식 템플릿을 사용하여 사용자 정의하거나 직접 만들 수 있습니다.
AI 프롬프트(AI Prompts): 검토, 최적화 및 이력서 생성을 위한 사용 준비가 된 LLM(Large Language Model) 프롬프트를 생성합니다. 이를 모든 LLM 또는 에이전트(agent)로 파이프할 수 있습니다.
유연한 경로(Flexible Paths): ~ (홈 디렉토리), 상대 경로를 지원하며, 가장 최신 실행을 가리키는 latest/ 인덱스를 가진 날짜별 출력 작업 공간을 생성합니다.
스키마 생성(Schema Generation): IDE 자동 완성 및 유효성 검사를 위해 JSON 스키마(JSON Schema)를 내보낼 수 있습니다.

설치 (Install)

사전 구축된 바이너리 (Pre-built Binary)

curl -fsSL https://raw.githubusercontent.com/urmzd/incipit/main/install.sh | sh

macOS(Intel 및 Apple Silicon)와 Linux(x86_64 & arm64)를 지원합니다. 설치 후, 어디서든 incipit을 실행할 수 있습니다.

소스에서 빌드 (Build from Source)

git clone https://github.com/urmzd/incipit.git
cd incipit
go install ./cmd/incipit

빠른 시작 (Quick Start)

# 특정 템플릿으로 PDF 생성
incipit generate assets/example_resumes/software_engineer.json -t modern-html

...

CLI 사용법 (CLI Usage)

생성(Generate)

# 단일 템플릿으로 생성
incipit generate resume.json -t modern-html

...

각 실행은 <output-dir>/<resume-slug>/ 아래의 타임스탬프가 찍힌 디렉토리에 파일을 작성합니다. 이와 나란히 있는 latest/ 인덱스 디렉토리에는 항상 가장 최근 실행 내용이 반영되어, 최신 파일들은 안정적인 경로에 위치하게 됩니다:

outputs/software_engineer/
├── 2026-06-11_21-44/Jane_Doe.modern-html.pdf   # 이번 실행
└── latest/Jane_Doe.modern-html.pdf             # 항상 최신 버전

AI 명령어 (AI Commands)

ai 하위 명령은 자체 완결형 LLM 프롬프트를 표준 출력(stdout)으로 출력합니다. API 키나 네트워크 접근이 필요하지 않습니다. 생성된 프롬프트를 모든 LLM에 붙여넣거나, claude -p와 같은 CLI 에이전트로 파이프할 수 있습니다.

# 일반 텍스트를 구조화된 JSON(스키마 포함)으로 변환하는 프롬프트
incipit ai create resume.txt | claude -p > resume.json

...

기타 명령어 (Other Commands)

incipit generate resume.json --dry-run  # JSON으로 유효성 검사 및 미리보기
incipit generate --schema               # JSON 스키마 내보내기
incipit templates list                   # 템플릿 목록 보기
...

입력 형식 (Input Formats)

이력서는 JSON 파일로 제공됩니다. 전체 JSON 스키마를 얻으려면 incipit generate --schema를 사용하세요.

비정형 텍스트(freeform text)를 구조화된 JSON으로 변환하려면, 선택한 LLM(대규모 언어 모델)을 위한 변환 프롬프트를 생성하는 데 incipit ai create를 사용하세요.

전제 조건 (Prerequisites)

Go 1.25+
TeX Live (LaTeX 템플릿에만 해당)
Chromium: 첫 사용 시 Rod가 자동 다운로드하거나, ROD_BROWSER_BIN을 설정하세요.
just (선택 사항, 보조 명령어용)

템플릿 (Templates)

내장된 템플릿은 templates/에 있으며, 각 템플릿마다 metadata.yml과 템플릿 파일이 포함된 폴더가 있습니다:

템플릿	형식	출력
`modern-html`	HTML	Chromium을 통한 PDF
...

metadata.yml과 템플릿 파일을 포함하는 templates/<이름>/ 디렉토리를 추가하여 직접 생성할 수 있습니다.

에이전트 스킬 (Agent Skill)

이 저장소의 규칙은 Agent Skills Specification을 따르는 휴대용 에이전트 스킬로 skills/에서 사용할 수 있습니다.

설치 후에는 /resume를 사용하여 에이전트로부터 이력서를 생성, 검토, 최적화하고 만들 수 있습니다.

기여 (Contributing)

기여 환영합니다. 지침은 CONTRIBUTING.md를 참고하세요.

라이선스 (License)

Apache 2.0

Incipit - 구조화된 이력서 데이터를 PDF, HTML 등으로 변환하는 CLI 도구

요약

핵심 포인트

출력 예시

기능

설치 (Install)

사전 구축된 바이너리 (Pre-built Binary)

소스에서 빌드 (Build from Source)

빠른 시작 (Quick Start)

CLI 사용법 (CLI Usage)

생성(Generate)

AI 명령어 (AI Commands)

기타 명령어 (Other Commands)

입력 형식 (Input Formats)

전제 조건 (Prerequisites)

템플릿 (Templates)

에이전트 스킬 (Agent Skill)

기여 (Contributing)

라이선스 (License)

댓글

출력 예시

기능

설치 (Install)

사전 구축된 바이너리 (Pre-built Binary)

소스에서 빌드 (Build from Source)

빠른 시작 (Quick Start)

CLI 사용법 (CLI Usage)

생성(Generate)

AI 명령어 (AI Commands)

기타 명령어 (Other Commands)

입력 형식 (Input Formats)

전제 조건 (Prerequisites)

템플릿 (Templates)

에이전트 스킬 (Agent Skill)

기여 (Contributing)

라이선스 (License)