시작하기

빠른 시작

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

Mac 앱

Apple Silicon Mac이라면 데스크톱 앱이 가장 빠릅니다. 서명된 DMG를 받아 ima2를 응용 프로그램 폴더로 옮기고 실행하세요. 자세한 내용은 Mac 앱을 보세요.

설치 및 실행

Node.js 22 이상이 필요합니다.

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-ai.github.io/ima2-gen/install-mac.sh | bash

Windows (PowerShell)

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

Linux / WSL

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

각 스크립트는 nvm/fnm/brew/winget을 확인하고, 가장 적합한 방법으로 Node LTS를 설치한 뒤 ima2-gen을 설치합니다.

포트 탐색. 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. Web setup — 터미널 대신 웹 UI 설정에서 제공자를 고르거나 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가 나면 실행 중인 ima2를 모두 멈춘 뒤(ima2 stop) 다시 설치하세요.

소스에서 개발

git clone https://github.com/lidge-ai/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 산출물은 빌드로 생성되며 손으로 편집하지 않습니다.