RoseKhlifa/Image-Studio

Image Studio – AI 이미지 생성을 위한 크로스 플랫폼 데스크톱 클라이언트

소개

• OpenAI 호환 이미지 생성 서비스(예: DALL-E, Stable Diffusion API, 사용자 지정 호스팅 모델)와 통신할 수 있는 무료 오픈소스 GUI 애플리케이션입니다.
• Responses API 패턴에 중점을 두어 Server-Sent Events (SSE) 또는 WebSocket을 통해 결과를 스트리밍함으로써, 장시간 이미지 생성 시 발생하는 일반적인 Cloudflare/Nginx 타임아웃 오류(HTTP 524/504)를 방지합니다.
• 상위 서비스가 기존 엔드포인트만 제공하는 경우 표준 Images API(/v1/images/generations 및 /v1/images/edits)를 대체 수단으로 지원합니다.

중요성

• 많은 호스팅 이미지 생성 백엔드는 장시간 실행되는 요청을 차단하는 리버스 프록시 뒤에 있습니다. Image Studio의 스트리밍 모드는 연결을 유지하고 부분적인 진행 상황을 표시하여 대규모 또는 고해상도 생성 작업을 더욱 안정적으로 만듭니다.
• UI, 설정, 경량 Android WebView 래퍼가 번들로 제공되므로 별도의 코드베이스 없이 Windows, macOS, Linux, Android에서 동일한 클라이언트를 실행할 수 있습니다.

주요 기능 (README 기준)

기능	설명
크로스 플랫폼 UI	Wails (Go + React/TypeScript)로 구축. 데스크톱 OS에서 네이티브로 실행되며 Android WebView 셸로도 작동합니다.
스트리밍 응답	Responses API에 대해 HTTP SSE 또는 WebSocket을 선택하여 긴 추론 중 발생하는 524/504 연결 끊김을 완화합니다.
표준 Images API 호환성	/v1/images/* 엔드포인트(생성, 편집 등)를 노출하는 모든 서비스와 작동합니다.
프롬프트 가져오기 도우미	동반 프로젝트인 Image-Prompts를 사용하여 웹 페이지에서 프롬프트를 스크랩하고 Image Studio로 직접 보낼 수 있습니다.
배치 img2img	이미지 대 이미지 일괄 처리를 위한 전용 UI (docs/batch-img2img 참조).
사용자 지정 가로세로 비율	"사용자 지정 비율" 대화 상자를 통해 자주 사용하는 너비 × 높이 비율을 저장할 수 있습니다.
상세 문서	설치, 설정, 문제 해결, 성능 테스트 및 소스 빌드 가이드 제공.
오픈소스 라이선스	AGPL-v3 – 재배포되거나 서비스로 제공되는 모든 수정 사항은 오픈소스여야 합니다.

시작하기

1. GitHub Releases 페이지에서 사전 빌드된 바이너리를 다운로드합니다(최신 변경 사항은 CI 아티팩트 사용).
2. 앱을 실행하고 Upstream Configuration 화면을 엽니다.
3. API 세부 정보를 입력합니다(기본 URL, API 키, 호출할 모델 ID).
4. 필요한 API 모드를 선택합니다:
   • Responses API: 장시간 실행되는 작업용(고품질 또는 대형 이미지에 권장).
   • Images API: 서비스가 기존 엔드포인트만 구현한 경우.
5. 프롬프트를 입력하고 크기, 품질, 출력 형식 및 스타일을 조정합니다. 사용자 지정 비율도 추가할 수 있습니다.
6. Generate (또는 Ctrl/Cmd + Enter)를 누릅니다. UI가 진행 상황을 스트리밍하고 준비가 되면 최종 이미지를 표시합니다.

문제 해결 워크플로우 (README 요약)

• 내장된 Test Connection 버튼을 사용하여 기본 URL, 키, 모델 ID에 도달할 수 있는지 확인합니다.
• History 뷰에서 원시 HTTP 응답 및 상태 코드를 확인합니다. 많은 오류는 클라이언트 자체가 아닌 상위 서비스의 제한, 권한 오류 또는 프록시 타임아웃 때문입니다.
• 동일한 자격 증명으로 curl/Postman에서 실패하는 경우, 이슈를 제기하기 전에 상위 서비스 제공업체에 문의하십시오.
• 문서에는 일반적인 오류 코드(401/403, 524/504, model-not-found 등)에 대한 상세 체크리스트가 포함되어 있습니다.

기술 스택

• 백엔드: Go ≥ 1.25, Wails v2 프레임워크를 사용하여 웹 UI를 네이티브 창으로 임베드.
• 프론트엔드: React 18 + TypeScript, Wails 바이너리로 컴파일.
• 전송: 스트리밍에는 HTTP SSE 또는 WebSocket 사용; Images API는 일반 HTTP로 대체.
• 플랫폼: Windows, macOS, Linux, Android(경량 WebView 래퍼 사용).

사용 대상

• 코딩 없이 OpenAI 호환 이미지 모델을 위한 데스크톱 UI를 원하는 아티스트 및 디자이너.
• 프록시 타임아웃을 견딜 수 있는 안정적인 클라이언트가 필요한 자체 호스팅 확산 서버 테스트 개발자.
• 배치 img2img 워크플로우와 프롬프트 가져오기 단축키를 원하는 파워 유저.

추가 정보

• 전체 문서는 docs/ 폴더에 있습니다(설치, 사용법, 문제 해결, 성능, 빌드 지침 등).
• 동반 사이트 Image-Prompts (https://prompts.sorry.ink/)에서 프롬프트를 직접 가져오는 방법을 확인할 수 있습니다.
• 이슈, 기능 요청 및 커뮤니티 토론은 리포지토리의 GitHub Issues 및 연결된 QQ 그룹에서 추적됩니다.

---

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.