자주 묻는 질문
설치, 실행, 분기 — 핵심만 짧게.
설치
Codex 데스크톱 앱으로도 되나요?
아니요. Codex CLI로 실행됩니다. CLI가 없으면 ima2-gen이 첫 실행 때 설치를 안내하고, 로그인 창을 띄워줍니다. 안내대로 깔면 바로 시작할 수 있습니다.
어떻게 설치하나요?
터미널(macOS / Linux) 또는 PowerShell(Windows)을 엽니다. npm install -g ima2-gen으로 전역 설치하고 ima2 serve로 실행하세요. 브라우저에서 http://localhost:3333을 열면 됩니다.
npm install -g ima2-genima2 serve npm이 뭔가요? 한 번에 설치하는 방법이 있나요?
npm은 Node.js 패키지 매니저입니다. 처음이라면 OS별 설치 스크립트를 사용할 수 있습니다. 스크립트는 Node가 없으면 설치를 안내하고, ima2-gen 설치와 서버 실행을 돕습니다.
curl -fsSL https://lidge-jun.github.io/ima2-gen/install-mac.sh | bash irm https://lidge-jun.github.io/ima2-gen/install-windows.ps1 | iex Windows / PowerShell에서도 되나요?
됩니다. Windows 10 이상, PowerShell 5.1 또는 PowerShell 7을 지원합니다. 공개 설치 스크립트는 GitHub Pages에서 제공되며, 실행 전 모든 명령을 화면에 출력합니다.
사용
Node 모드와 Canvas Mode는 언제 쓰나요?
마음에 든 결과에서 여러 방향을 비교하려면 Node 모드를 씁니다. 이미지가 거의 맞지만 배경 정리, annotation, alpha/matte export 같은 부분 정리가 필요하면 Canvas Mode를 씁니다.
한 번에 몇 장까지 만들 수 있나요?
Classic은 한 번에 최대 8장까지 병렬로 만들 수 있습니다. Node에서는 자식 노드마다 별도 요청이 가니, 할당량이 허용하는 만큼 가지를 펼칠 수 있습니다.
레퍼런스 이미지를 붙일 수 있나요?
프롬프트당 다섯 장까지 붙일 수 있습니다. 컴포저에 끌어 놓거나 붙여 넣으면 끝. 큰 파일은 자동으로 압축돼서 업로드되므로 미리 손볼 필요는 없습니다.
Style sheet은 어떻게 쓰나요?
매체, 구도, 분위기, 팔레트, 제외할 요소를 시트로 묶어 두고 프롬프트에 붙여 쓰면 됩니다. 시트는 세션을 넘겨도 유지되므로 같은 룩을 다음 작업에서도 그대로 가져갈 수 있습니다.
Multimode는 뭔가요?
하나의 프롬프트에서 여러 Classic 후보를 동시에 시작하고 slot별 진행 상황을 보여주는 방식입니다. 진행 도중 특정 슬롯을 취소하거나 중간 결과를 확인한 뒤, 가장 잘 나온 이미지에서 작업을 이어갈 수 있습니다.
GitHub에서 prompt를 가져올 수 있나요?
가능합니다. Prompt library는 로컬 prompt pack, GitHub folder, curated source, GPT-image hint pack을 가져와 로컬 index에 저장하고 검색/ranking에 사용합니다.
기술
OpenAI API key가 필요한가요?
기본 GPT OAuth 경로에는 필요 없습니다. 명시적으로 선택하면 OpenAI API key 경로나 번들 Grok/progrok 경로도 사용할 수 있습니다.
이미지는 어디 저장되나요?
로컬 사용자 데이터 폴더에 이미지와 작업 기록이 저장됩니다. 직접 확인, 동기화, 버전 관리까지 가능합니다. 이미지 파일을 별도 외부 저장소에 올리지 않습니다.
내 컴퓨터에서 어떤 데이터가 나가나요?
이미지 생성 요청은 선택한 provider로 전송됩니다: GPT OAuth/API는 OpenAI, Grok은 번들 progrok을 통한 xAI입니다. 결과 파일과 작업 기록은 로컬에 남습니다.
오프라인에서도 되나요?
이미지 생성은 선택한 provider 네트워크 경로가 필요해 인터넷이 있어야 합니다. 로컬 갤러리 조회, 세션 정리, 스타일 시트 편집은 오프라인에서도 사용할 수 있습니다.
오픈소스인가요?
네. ima2-gen은 MIT 라이선스로 공개되어 있습니다. 코드는 GitHub에서 볼 수 있습니다.
github.com/lidge-jun/ima2-gen