ImgGen2는 Codex 구독 경로로 이미지를 만들고, 레퍼런스가 필요한 작업은 원본과 비교하며, 실패한 컷만 다시 만드는 에이전트 스킬입니다. 정확한 수량, 이어서 작업하기, 실제 파일 확인까지 한 흐름으로 다룹니다.
MPW는 프롬프트를 만드는 별도 플러그인 mpw@heituz입니다. 2.0.0부터 ImgGen2 설치기는 ImgGen2만 설치합니다. MPW는 HeiTuz 마켓플레이스에서 설치하세요.
bunx --package github:HeiTuz/ImgGen2 imggen-imggen2일반 터미널에서 실행하면 설치할 에이전트 호스트(Codex 또는 Claude Code)를 고릅니다. 이미지 스킬, QC 설정, imggen 도우미를 설치하고, Codex CLI가 없으면 함께 설치합니다.
Node.js 18 이상과 Git이 필요합니다. 이미지 제작에는 Python과 로그인된 공식 Codex CLI가 필요하며, CI는 Python 3.12에서 검증합니다. 스킬 설치만으로 이미지 생성이 시작되거나 계정에 로그인되지는 않습니다.
프롬프트 작성까지 함께 쓰려면 MPW 플러그인을 추가합니다.
# Codex
codex plugin marketplace add HeiTuz/heituz-plugins && codex plugin add mpw@heituz
# Claude Code
claude plugin marketplace add HeiTuz/heituz-plugins && claude plugin install mpw@heituzBun이 없는 새 환경에서는 아래 명령이 공식 설치기로 최신 안정판을 설치하고 곧바로 ImgGen2를 설치합니다. 이미 Bun이 있으면 그대로 사용합니다. imggen update도 Bun이 없으면 공식 설치기를 자동 실행합니다.
bun_cmd="$(command -v bun || true)"; if [ -z "$bun_cmd" ]; then curl -fsSL https://bun.com/install | bash; bun_cmd="${BUN_INSTALL:-$HOME/.bun}/bin/bun"; fi; "$bun_cmd" x --package github:HeiTuz/ImgGen2 imggen-imggen2Windows PowerShell:
$bun = (Get-Command bun -ErrorAction SilentlyContinue).Source; if (!$bun) { irm https://bun.com/install.ps1 | iex; $root = if ($env:BUN_INSTALL) { $env:BUN_INSTALL } else { "$HOME\.bun" }; $bun = Join-Path $root 'bin\bun.exe' }; & $bun x --package github:HeiTuz/ImgGen2 imggen-imggen2CI·비대화형 실행과 --dry-run은 질문하지 않습니다. 자동화에서는 --agent를 지정하세요. 이미 설치된 스킬을 교체할 때만 --force를 붙입니다.
호스트 선택 · 직접 경로
# Codex에 설치
bunx --package github:HeiTuz/ImgGen2 imggen-imggen2 -- --agent codex
# 파일을 쓰기 전에 계획 확인
bunx --package github:HeiTuz/ImgGen2 imggen-imggen2 -- --agent codex --dry-run--agent |
ImgGen2 경로 |
|---|---|
codex |
~/.codex/skills/ImgGen2 |
claude |
~/.claude/skills/ImgGen2 |
--agent all은 감지한 호스트 전체를 뜻합니다. 비대화형 호스트 자동 감지는 claude > codex 순서이며, 감지 결과가 없으면 Codex를 사용합니다. Hermes 대상은 2.0.0에서 제거됐습니다.
직접 경로는 --target을 사용합니다. --skip-codex는 Codex CLI 설치를 생략합니다. 이전 옵션 --component mpw|all과 --mpw-target은 MPW를 설치하지 않고 플러그인 설치 방법만 안내합니다. --skip-mpw는 호환용으로 남아 있습니다.
| 작업 | 요청 예시 | ImgGen2가 챙기는 것 |
|---|---|---|
| 한 장의 장면 | “파란 도자기 컵, 린넨 위의 부드러운 자연광” | 파일 생성, PNG 형식·크기·해시 확인 |
| 레퍼런스 편집 | “제품의 색과 봉제는 그대로, 배경만 바꿔줘” | 원본의 관찰 가능한 특징과 변경 범위 |
| 인물 시리즈 | “이 사람 전신 6장. 인물은 같게, 장소만 다르게” | 동일 인물, 전신 구도, 첫 장 검수 후 나머지 제작 |
| 상품 사진 세트 | “앞·뒤·포켓·소재 컷을 한 세트로 정리해줘” | 제품 구조, 컷별 목적, 누락 없는 결과 목록 |
| 아이디어 탐색 | “독립잡지풍 고양이 이미지 100장” | MPW 프롬프트 변주, 제한된 동시 실행, 실패한 컷만 재시도 |
v1.13.0 릴리스 파일럿 · Codex 구독 경로 · 1402 × 1122 PNG. 파일 구조·해시·픽셀 디코딩과 화면 확인을 마친 실제 생성물입니다. 레퍼런스 재현력이나 종합 화질의 비교 평가를 뜻하지는 않습니다.
스킬이 설치된 에이전트에게 작업을 요청하세요.
ImgGen2로 이 제품 사진을 상세페이지용 6장으로 만들어줘.
색·실루엣·소재·로고는 유지해.
포켓과 원단 디테일을 각각 한 장 포함하고, 흰 배경으로 통일해.
d1 포켓 컷만 다시 만들어줘. 나머지는 유지해.
전체 앞모습 대신 포켓의 봉제와 여밈이 보이는 클로즈업으로.
flowchart LR
A[요청과 원본 확인] --> B[컷 계획]
B --> C[첫 장 생성]
C --> D{검수 필요?}
D -->|레퍼런스·편집·광고| E[원본과 비교]
D -->|단순 텍스트| F[나머지 생성]
E -->|통과| F
E -->|수정 필요| C
F --> G[결과 검수·실패 컷 복구]
G --> H[파일 확인·전달]
첫 장부터 실패하면 같은 문제를 여러 장으로 늘리지 않습니다. 중간에 끊긴 작업은 기록과 파일 해시로 재개하고, 이미 통과한 컷은 보존합니다. 생성 성공, 검수 통과, 최종 전달을 구분합니다.
CLI로 한 장 만들기 · 배치 실행
아래 명령은 설치된 스킬 디렉터리에서 실행합니다. --execute가 없으면 계획만 확인합니다.
python scripts/codex_subscription_transport.py --prompt "A blue ceramic cup on natural linen" --output ./cup.png
python scripts/codex_subscription_transport.py --prompt "A blue ceramic cup on natural linen" --output ./cup.png --execute레퍼런스 편집은 --image ./original.png을 추가합니다. 단순 텍스트 프롬프트는 MPW가 설치돼 있으면 보강할 수 있고, --mpw off로 끕니다.
python scripts/codex_subscription_batch.py --manifest ./jobs.jsonl --output-root ./results --workers auto --execute배치의 completion_state와 next_action을 확인하세요. awaiting_pilot_qc는 첫 장을 검수할 차례라는 뜻이며, 전체 완료가 아닙니다. 상세 절차는 배치 계약에 있습니다.
MPW를 사용하는 텍스트 아이디어 대량 변주는 다음과 같습니다.
python scripts/creative_batch.py --prompt "독립잡지풍 검은 고양이" --style "editorial, muted palette" --count 100 --output-root ./cats --execute이 프리셋은 텍스트 아이데이션용입니다. 실제 상품을 원본과 동일하게 보정하려면 레퍼런스 기반 상품 제작 절차를 사용하세요.
- 필요할 때 검수. 기본
auto는 레퍼런스·편집·상품·광고 작업과 명시적 검수 요청에 적용합니다. 단순 텍스트 생성은 파일 무결성만 확인합니다. - 파일도 확인. PNG 구조·CRC·크기·해시와 현재 세션의 소유권을 검사합니다. 파일이 있다고 무조건 성공으로 처리하지 않습니다.
- 좋은 컷은 보존. 실패한 컷만 원본에서 다시 생성합니다. 제품 구조, 동일 인물, 텍스트, 디테일 목적을 따로 확인합니다.
- 설정은 유지. 재설치 시 기존 QC 설정을 보존합니다. 변경하려면
--vision-qc auto또는--vision-qc off를 명시하세요.
off는 시각 검수를 끄며 로컬 파일 검사는 유지합니다. QC는 호스트의 기본 Vision 도구를 사용합니다. Astra는 작업을 진행하는 모델이며, 그 이름을 이미지 생성 모델의 증거로 사용하지 않습니다.
# 등록된 ImgGen2 갱신
imggen update
# 실행 계획만 확인
imggen update --dry-runimggen update는 Bun으로 공개 ImgGen2를 갱신합니다. Bun이 없으면 공식 설치기를 통해 최신 안정판을 먼저 설치합니다. 1.x에서 MPW까지 등록했다면 첫 업데이트 때 설치 기록에서 MPW 항목을 지우고 플러그인 설치 방법을 안내합니다. MPW는 codex plugin marketplace upgrade heituz 또는 claude plugin update mpw@heituz로 갱신합니다.
다시 등록하면 이번에 고른 호스트가 imggen의 갱신 대상으로 저장됩니다.
--codex를 추가하면 공식 Codex CLI도 갱신합니다. 1.x에서 Hermes에 등록한 설치는 갱신하지 않고 --agent codex 또는 --agent claude로 다시 설치하라고 안내합니다.
설치 문제 해결 · 오프라인 · Windows
imggen status로 실제 경로·버전·등록 상태를 확인합니다. MPW 플러그인 설치 여부는 ImgGen2 상태에 영향을 주지 않습니다.- 온라인 ImgGen2 설치는 필요하면 공식 Codex CLI와 Pillow 설치를 시도합니다. 로그인은 사용자의 Codex 환경에서 진행합니다.
--offline은 네트워크 설치 없이 ImgGen2 파일만 복사합니다.--no-register는 전역 도우미·설치 기록·셸 설정 등록을 생략합니다. 오프라인에서 등록까지 하려면--register를 명시하세요.- GitHub 패키지 실행이 패키지 매니저 정책에 막히면 스킬 검색 경로 밖에 소스를 내려받아 설치기를 실행하세요.
git clone https://github.com/HeiTuz/ImgGen2.git ./ImgGen2-source
node ./ImgGen2-source/scripts/install.mjs --agent codexWindows는 PowerShell·cmd·Git Bash에서 사용할 수 있습니다. 공백·한글·UNC 경로를 지원하며, 다른 OS의 /Users/... 경로를 Windows 경로로 추측하지 않습니다. 구형 launcher 복구는 다음 명령을 사용합니다.
npx --yes --allow-git=all --package github:HeiTuz/ImgGen2 imggen-imggen2 -- --agent codex --force --register| 더 알아보기 | 내용 |
|---|---|
| 작업별 제작 절차 | 초상, 상품, 의류, 배치, 검수 |
| Astra 실행 설계 | 문서 분리, 상태 판단, 완료 증거 |
| 배치 안정성·확장성 | 워커 제한, 공유 해시, 재개, 실패 처리 |
| 명시적 Grok 경로 | Codex·Claude에서는 공식 Grok CLI, Hermes에서는 xAI OAuth 네이티브 도구 사용 |
| 호스트 오버레이 | Codex·Claude Code 설치 표면 |
| MPW | 프롬프트 작성 플러그인 mpw@heituz (설치) |
기본 생성은 Codex 구독 경로입니다. Grok·Wan 등 다른 제공자는 명시적으로 요청하고 해당 환경이 준비된 경우에만 사용하며, 실패했다고 다른 제공자로 조용히 전환하지 않습니다.
병렬 Codex 워커는 이미지마다 CLI를 한 번씩 실행하고, 결과는 세션 소유권·검수·재개·게시 검증으로 확인합니다. 배치 설계 결정
MIT · HeiTuz