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 を使用して、Webページからプロンプトをスクレイピングし、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 フレームワークを使用してWeb 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から直接引用したものであり、追加の機能は推測されていません。