시작하기

빠른 시작

npx로 실행하고 인증 방식을 고르면 바로 이미지와 영상을 만들 수 있습니다. 기본 OAuth 경로에는 API 키가 필요 없습니다.

실행

npx ima2-gen serve

그다음 http://localhost:3333을 엽니다.

포트 탐색. 3333이 사용 중이면 ima2-gen이 다음 빈 포트에 바인딩하고 실제 URL을 ~/.ima2/server.json에 기록합니다. 포트를 추측하지 말고 ima2 open 또는 터미널에 출력된 URL을 쓰세요.

설정 (인증 선택)

ima2 setup으로 인증 방식을 고릅니다:

  1. GPT OAuth — ChatGPT 계정으로 로그인 (무료, 이미지만)
  2. Grok OAuth — xAI/Grok 계정으로 로그인 (이미지 + 영상)
  3. Both — GPT + Grok 둘 다 (전체 기능)
  4. API Key — OpenAI API 키 입력 (유료)

영상 생성은 Grok OAuth(2번 또는 3번)가 필요합니다. 나중에 ima2 grok login으로 추가할 수도 있습니다.

ChatGPT 로그인

아직 ChatGPT OAuth에 로그인하지 않았다면:

npx @openai/codex login
npx ima2-gen serve

전역 설치

npm install -g ima2-gen
ima2 serve
Windows 업데이트 주의. 전역 설치를 업데이트하기 전에 실행 중인 ima2 serve를 종료하세요. npm이 EBUSY 또는 resource busy or locked를 보고하면 ima2 터미널을 닫고, 남은 node.exe 프로세스를 종료한 뒤 다시 시도하세요.

소스에서 개발

git clone https://github.com/lidge-jun/ima2-gen.git
cd ima2-gen
npm install
npm run dev          # UI 빌드 + TS 서버를 --watch와 진단 로그로 실행
npm run typecheck
npm test
npm run build

npm run dev는 UI를 빌드하고 TypeScript 서버 엔트리를 --watch로 실행합니다. .ts 파일을 원본으로 다루세요; 짝이 되는 .js 산출물은 빌드로 생성되며 손으로 편집하지 않습니다.