시작하기

빠른 시작

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

설치 및 실행

npm install -g ima2-gen
ima2 setup
ima2 serve

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

원클릭 설치 (npm 필요 없음)

Node.js나 npm이 없나요? 플랫폼별 설치 스크립트를 사용하세요. 환경을 감지하고, 필요하면 Node LTS를 설치한 뒤 ima2-gen을 설치합니다.

macOS

curl -fsSL https://lidge-jun.github.io/ima2-gen/install-mac.sh | bash

Windows (PowerShell)

irm https://lidge-jun.github.io/ima2-gen/install-windows.ps1 | iex

Linux / WSL

curl -fsSL https://lidge-jun.github.io/ima2-gen/install-linux.sh | bash

각 스크립트는 nvm/fnm/brew/winget을 확인하고, 가장 적합한 방법으로 Node LTS를 설치하며, 멈춘 프로세스 정리도 자동으로 처리합니다.

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

설정 (인증 선택)

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

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

영상 생성은 Grok OAuth(2번 또는 3번)가 필요합니다. 나중에 ima2 grok login으로 추가할 수도 있고, 이 명령은 manual-paste 흐름을 기본으로 씁니다.

GPT OAuth 토큰이 만료되면 ima2 setup을 다시 실행하세요(옵션 1).

업데이트. Ctrl+C로 서버를 종료하세요 — ima2-gen은 DB, 소켓, 자식 프로세스를 정리하는 clean shutdown을 수행합니다. 그 다음 npm install -g ima2-gen@latest를 실행하세요. Windows에서 EBUSY가 나면 설치 스크립트를 사용하세요.

소스에서 개발

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 산출물은 빌드로 생성되며 손으로 편집하지 않습니다.

개요 아키텍처