레퍼런스
설정
유효 값은 3계층 순서를 따릅니다: 환경 변수가 ~/.ima2/config.json을 덮어쓰고, 그것이
내장 기본값을 덮어씁니다.
환경 변수
| 변수 | 기본값 | 설명 |
|---|---|---|
IMA2_PORT / PORT | 3333 | 웹 서버 포트. |
IMA2_HOST | 127.0.0.1 | 웹 서버 바인드 호스트. |
IMA2_OAUTH_PROXY_PORT / OAUTH_PORT | 10531 | OAuth 프록시 포트. |
IMA2_SERVER | — | CLI 타깃 오버라이드. |
IMA2_CONFIG_DIR | ~/.ima2 | 설정과 SQLite 위치. |
IMA2_ADVERTISE_FILE | ~/.ima2/server.json | 런타임 탐색 파일. |
IMA2_GENERATED_DIR | ~/.ima2/generated | 생성 이미지 디렉터리. |
IMA2_IMAGE_MODEL_DEFAULT | gpt-5.4-mini | 서버 폴백 이미지 모델. |
IMA2_REASONING_EFFORT | medium | 기본(OAuth) 경로의 reasoning effort 기본값; none·low·medium·high·xhigh 중 하나. |
IMA2_NO_OAUTH_PROXY | — | 1로 설정하면 자동 시작 OAuth 프록시 비활성화. |
IMA2_LOG_LEVEL | info | serve는 info, dev는 debug 기본; debug·info·warn·error·silent 지원. |
IMA2_INFLIGHT_TERMINAL_TTL_MS | 300000 | 디버그 뷰용 최근 종료 작업 보존 시간. |
OPENAI_API_KEY | — | API 프로바이더 Responses 경로 및 보조 기능용 API key. |
IMA2_API_IMAGE_MODEL_DEFAULT | gpt-5.4-mini | API 경로의 기본 이미지 모델. |
IMA2_API_REASONING_EFFORT | low | API 경로의 기본 reasoning effort. |
IMA2_API_IMAGE_SIZE | 1024x1024 | API 경로의 기본 크기. |
IMA2_API_ALLOW_WEB_SEARCH | true | API 경로의 웹 검색 토글. |
IMA2_GROK_PROXY_HOST | 127.0.0.1 | 번들 progrok 바인드 호스트. |
IMA2_GROK_PROXY_PORT | 18645 | 번들 progrok 포트. |
IMA2_NO_GROK_PROXY | — | 1로 설정하면 번들 progrok 자동 시작 비활성화. |
IMA2_GROK_PLANNER_MODEL | grok-4.3 | provider: "grok"의 xAI search/planner 모델. |
IMA2_GROK_PLANNER_TIMEOUT_MS | 60000 | 각 Grok search/planner 단계 timeout. |
IMA2_GROK_IMAGE_MODEL_DEFAULT | grok-imagine-image | Grok 이미지 호출 기본 xAI image 모델. |
IMA2_GROK_GENERATION_TIMEOUT_MS | 120000 | 최종 Grok 이미지 생성/edit 호출 timeout. |
IMA2_GROK_STATUS_TIMEOUT_MS | 3000 | /api/grok/status 모델 probe timeout. |
IMA2_OAUTH_MASKED_EDIT_ENABLED | false | OAuth 경로의 masked-edit 옵트인 플래그 (#31, 기반 작업만). |
설정 파일
ima2 config는 ~/.ima2/config.json(파일 레이어)을 읽고 씁니다. 알 수 없는
키를 거부하고, 인증 키(provider, apiKey)를 막고, env 변수가 같은 키를
덮어쓰면 경고합니다. 인증은 ima2 setup 또는 ima2 login으로 바꾸세요.
주요 쓰기 가능 키
imageModels.default imageModels.reasoningEffort
apiProvider.defaultImageModel apiProvider.defaultReasoningEffort
grokProvider.plannerModel grokProvider.plannerTimeoutMs
grokProvider.defaultImageModel
log.level features.cardNews
server.port server.host server.bodyLimit
oauth.proxyPort limits.maxRefCount limits.maxParallel
history.defaultPageSize history.maxPageCap storage.generatedDir권위 있는 전체 목록은 ima2 config keys, 병합된 값은 ima2 config ls --effective를 실행하세요.
로깅 모드
ima2 serve는 의도적으로 조용합니다: 시작 URL·경고·에러는 보이고, 요청/node/OAuth
구조화 로그는 기본 숨김입니다. 요청 ID, node phase, OAuth 스트림 진단, inflight 전이가 필요하면
ima2 serve --dev, npm run dev, 또는
IMA2_LOG_LEVEL=debug ima2 serve를 쓰세요.