sync-image-gen 0.1.0__tar.gz

sync_image_gen-0.1.0/.env.example

@@ -0,0 +1,5 @@
+GOOGLE_API_KEY=your_gemini_api_key_here
+WATCH_DIRECTORY=./images
+OUTPUT_DIRECTORY=./processed
+GEMINI_PROMPT="將圖片改為動漫風格"
+GEMINI_MODEL="gemini-3-pro-image-preview"

sync_image_gen-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+.venv/
+.env
+.DS_Store
+**/*.pyc

sync_image_gen-0.1.0/.python-version

@@ -0,0 +1 @@
+3.10

sync_image_gen-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: sync-image-gen
+Version: 0.1.0
+Summary: Sync directory monitor with Nano Banana Pro (Gemini) image processing and full-screen display
+Project-URL: Homepage, https://github.com/derekhsu/sync-image-gen
+Author: Derek Hsu
+License: MIT
+Keywords: directory-monitor,gemini,image-processing,nano-banana,watchdog
+Requires-Python: >=3.10
+Requires-Dist: google-genai>=0.1.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: watchdog>=4.0.0
+Description-Content-Type: text/markdown
+
+# Sync Image Gen (Nano Banana Pro)
+
+這是一個基於 Python 的自動化工具，專為目錄監視與 AI 圖片風格轉換而設計。它會監視特定目錄中的新圖片，透過 Google 最新一代的 **Nano Banana Pro (Gemini 3 Pro Image)** 模型進行風格化處理，並將處理後的結果全螢幕展示。
+
+## 🌟 核心功能
+
+- **自動目錄監控**：使用 `watchdog` 實時監控新產生的圖片。
+- **Nano Banana Pro 整合**：串接最新 Gemini 3 Pro 影像模型，支援精確的風格轉換（如動漫、賽博龐克等）。
+- **跨平台全螢幕展示**：支援 macOS、Ubuntu Desktop 與 Windows，處理完成後自動彈出全螢幕視窗。
+- **無干擾模式**：啟動後視窗預設隱藏，僅在有新圖片時彈出；按 `ESC` 隱藏視窗但不結束程式。
+- **高度可配置**：透過環境變數或啟動參數靈活調整路徑、Prompt 與模型版本。
+
+## 🚀 快速開始
+
+### 1. 安裝環境
+本專案建議使用 [uv](https://github.com/astral-sh/uv) 進行管理：
+
+```bash
+# 安裝依賴並建立虛擬環境
+uv sync
+```
+
+**Ubuntu 使用者注意：**
+Linux 系統需額外安裝 tkinter 支持：
+```bash
+sudo apt-get install python3-tk
+```
+
+### 2. 配置環境變數
+複製 `.env.example` 並更名為 `.env`，填入您的 API Key：
+
+```bash
+cp .env.example .env
+```
+
+`.env` 內容說明：
+- `GOOGLE_API_KEY`: 您的 Google Gemini API Key。
+- `GEMINI_PROMPT`: 轉換圖片的指令（例如：「將圖片轉換為動漫風格」）。
+- `GEMINI_MODEL`: 模型名稱（預設為 `gemini-3-pro-image-preview`）。
+- `WATCH_DIRECTORY`: 監視路徑。
+- `OUTPUT_DIRECTORY`: 處理後圖片儲存路徑。
+
+### 3. 執行程式
+
+**開發模式執行：**
+```bash
+uv run sync-image-gen
+```
+
+**測試模式（僅複製不呼叫 API）：**
+```bash
+uv run sync-image-gen -t
+```
+
+**使用 uvx 執行：**
+```bash
+uvx --from . sync-image-gen
+```
+
+## 🛠️ 命令列參數 (CLI Arguments)
+
+啟動參數的優先權高於 `.env` 設定。
+
+| 參數 | 說明 | 預設值 |
+| :--- | :--- | :--- |
+| `-h, --help` | 顯示說明訊息 | - |
+| `--watch-dir` | 指定監視目錄 | `./images` |
+| `--output-dir` | 指定處理後圖片儲存目錄 | `./processed` |
+| `-t, --test` | 啟用測試模式（不呼叫 Gemini API） | `False` |
+
+## ⌨️ 快捷鍵
+
+- `ESC`: 隱藏全螢幕視窗（程式繼續在背景監視）。
+- `Ctrl + C` (在終端機): 徹底停止程式與監視任務。
+
+## 📋 系統要求
+
+- Python 3.10+
+- 穩定且具備 Imagen 功能的 Google Gemini API Key。
+- 網路連線（用於呼叫 Gemini API）。

sync_image_gen-0.1.0/README.md

@@ -0,0 +1,80 @@
+# Sync Image Gen (Nano Banana Pro)
+
+這是一個基於 Python 的自動化工具，專為目錄監視與 AI 圖片風格轉換而設計。它會監視特定目錄中的新圖片，透過 Google 最新一代的 **Nano Banana Pro (Gemini 3 Pro Image)** 模型進行風格化處理，並將處理後的結果全螢幕展示。
+
+## 🌟 核心功能
+
+- **自動目錄監控**：使用 `watchdog` 實時監控新產生的圖片。
+- **Nano Banana Pro 整合**：串接最新 Gemini 3 Pro 影像模型，支援精確的風格轉換（如動漫、賽博龐克等）。
+- **跨平台全螢幕展示**：支援 macOS、Ubuntu Desktop 與 Windows，處理完成後自動彈出全螢幕視窗。
+- **無干擾模式**：啟動後視窗預設隱藏，僅在有新圖片時彈出；按 `ESC` 隱藏視窗但不結束程式。
+- **高度可配置**：透過環境變數或啟動參數靈活調整路徑、Prompt 與模型版本。
+
+## 🚀 快速開始
+
+### 1. 安裝環境
+本專案建議使用 [uv](https://github.com/astral-sh/uv) 進行管理：
+
+```bash
+# 安裝依賴並建立虛擬環境
+uv sync
+```
+
+**Ubuntu 使用者注意：**
+Linux 系統需額外安裝 tkinter 支持：
+```bash
+sudo apt-get install python3-tk
+```
+
+### 2. 配置環境變數
+複製 `.env.example` 並更名為 `.env`，填入您的 API Key：
+
+```bash
+cp .env.example .env
+```
+
+`.env` 內容說明：
+- `GOOGLE_API_KEY`: 您的 Google Gemini API Key。
+- `GEMINI_PROMPT`: 轉換圖片的指令（例如：「將圖片轉換為動漫風格」）。
+- `GEMINI_MODEL`: 模型名稱（預設為 `gemini-3-pro-image-preview`）。
+- `WATCH_DIRECTORY`: 監視路徑。
+- `OUTPUT_DIRECTORY`: 處理後圖片儲存路徑。
+
+### 3. 執行程式
+
+**開發模式執行：**
+```bash
+uv run sync-image-gen
+```
+
+**測試模式（僅複製不呼叫 API）：**
+```bash
+uv run sync-image-gen -t
+```
+
+**使用 uvx 執行：**
+```bash
+uvx --from . sync-image-gen
+```
+
+## 🛠️ 命令列參數 (CLI Arguments)
+
+啟動參數的優先權高於 `.env` 設定。
+
+| 參數 | 說明 | 預設值 |
+| :--- | :--- | :--- |
+| `-h, --help` | 顯示說明訊息 | - |
+| `--watch-dir` | 指定監視目錄 | `./images` |
+| `--output-dir` | 指定處理後圖片儲存目錄 | `./processed` |
+| `-t, --test` | 啟用測試模式（不呼叫 Gemini API） | `False` |
+
+## ⌨️ 快捷鍵
+
+- `ESC`: 隱藏全螢幕視窗（程式繼續在背景監視）。
+- `Ctrl + C` (在終端機): 徹底停止程式與監視任務。
+
+## 📋 系統要求
+
+- Python 3.10+
+- 穩定且具備 Imagen 功能的 Google Gemini API Key。
+- 網路連線（用於呼叫 Gemini API）。

sync_image_gen-0.1.0/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+python = "3.13"

sync_image_gen-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "sync-image-gen"
+version = "0.1.0"
+description = "Sync directory monitor with Nano Banana Pro (Gemini) image processing and full-screen display"
+readme = "README.md"
+authors = [
+    { name = "Derek Hsu" }
+]
+license = { text = "MIT" }
+keywords = ["gemini", "nano-banana", "image-processing", "directory-monitor", "watchdog"]
+requires-python = ">=3.10"
+dependencies = [
+    "watchdog>=4.0.0",
+    "google-genai>=0.1.0",
+    "pillow>=10.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/derekhsu/sync-image-gen"
+
+[project.scripts]
+sync-image-gen = "sync_image_gen:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

sync_image_gen-0.1.0/src/sync_image_gen/__init__.py

@@ -0,0 +1,198 @@
+import os
+import time
+import threading
+import tkinter as tk
+import shutil
+import argparse
+from pathlib import Path
+from PIL import Image, ImageTk
+from watchdog.observers import Observer
+from watchdog.events import FileSystemEventHandler
+from dotenv import load_dotenv
+from google import genai
+from google.genai import types
+
+load_dotenv()
+
+class ImageHandler(FileSystemEventHandler):
+    def __init__(self, callback):
+        self.callback = callback
+
+    def on_created(self, event):
+        if not event.is_directory and event.src_path.lower().endswith(('.png', '.jpg', '.jpeg')):
+            print(f"發現新圖片: {event.src_path}")
+            self.callback(event.src_path)
+
+class App:
+    def __init__(self, test_mode=False):
+        self.root = tk.Tk()
+        self.root.title("Sync Image Viewer")
+        self.root.configure(background='black')
+        self.test_mode = test_mode
+        
+        # 初始狀態隱藏視窗
+        self.root.withdraw()
+        self.root.protocol("WM_DELETE_WINDOW", self.hide_window)
+        self.root.bind("<Escape>", lambda e: self.hide_window())
+        
+        self.label = tk.Label(self.root, background='black')
+        self.label.pack(expand=True, fill='both')
+        
+        self.current_photo = None
+        
+        # 初始化 Gemini Client
+        api_key = os.getenv("GOOGLE_API_KEY")
+        if api_key:
+            self.client = genai.Client(api_key=api_key)
+        else:
+            self.client = None
+            if not test_mode:
+                print("警告: 找不到 GOOGLE_API_KEY，將無法進行圖片轉換。")
+
+    def hide_window(self):
+        self.root.attributes("-fullscreen", False)
+        self.root.withdraw()
+        print("視窗已隱藏，監控中...")
+
+    def display_image(self, image_path):
+        try:
+            img = Image.open(image_path)
+            self.root.deiconify()
+            self.root.attributes("-fullscreen", True)
+            self.root.attributes("-topmost", True)
+            self.root.lift()
+            self.root.focus_force()
+            
+            screen_width = self.root.winfo_screenwidth()
+            screen_height = self.root.winfo_screenheight()
+            img.thumbnail((screen_width, screen_height), Image.Resampling.LANCZOS)
+            
+            self.current_photo = ImageTk.PhotoImage(img)
+            self.label.config(image=self.current_photo)
+            self.root.after(1000, lambda: self.root.attributes("-topmost", False))
+            print(f"已顯示圖片: {image_path}")
+        except Exception as e:
+            print(f"顯示圖片失敗: {e}")
+
+    def call_gemini_api(self, image_path, target_path):
+        """呼叫 Gemini API 進行圖片轉換"""
+        # 強制重新讀取 .env 以取得最新 Prompt
+        load_dotenv(override=True)
+        
+        if not self.client:
+            print("錯誤: Gemini Client 未初始化 (缺少 API Key)")
+            return False
+
+        # 預設使用 Nano Banana Pro (Gemini 3 Pro Image)
+        model_name = os.getenv("GEMINI_MODEL", "gemini-3-pro-image-preview")
+        prompt = os.getenv("GEMINI_PROMPT", "Transform this image with a creative style.")
+        
+        print(f"正在呼叫模型: {model_name}")
+        print(f"執行 Prompt: {prompt}")
+        
+        try:
+            # 加入重試機制讀取圖片，防止檔案還在寫入中
+            raw_img = None
+            for i in range(5):
+                try:
+                    raw_img = Image.open(image_path)
+                    raw_img.load() # 嘗試載入以確保檔案完整
+                    break
+                except Exception:
+                    time.sleep(0.5)
+            
+            if not raw_img:
+                print(f"錯誤: 無法讀取圖片檔案 {image_path}")
+                return False
+            
+            # 使用 Gemini 進行風格轉換
+            response = self.client.models.generate_content(
+                model=model_name,
+                contents=[
+                    prompt,
+                    raw_img
+                ],
+                config=types.GenerateContentConfig(
+                    response_modalities=["IMAGE"],
+                )
+            )
+            
+            # 尋找輸出中的圖片部分
+            generated_img = None
+            if response.parts:
+                for part in response.parts:
+                    if part.inline_data:
+                        generated_img = part.as_image()
+                        break
+            
+            if generated_img:
+                generated_img.save(target_path)
+                print(f"Gemini 處理完成: {target_path}")
+                return True
+            else:
+                print(f"Gemini 未回傳圖片數據。")
+                if response.text:
+                    print(f"回傳文字內容: {response.text}")
+                return False
+                
+        except Exception as e:
+            print(f"Gemini API 呼叫失敗: {e}")
+            return False
+
+    def process_and_show(self, image_path):
+        output_dir = os.environ.get("OUTPUT_DIRECTORY", "./processed")
+        Path(output_dir).mkdir(parents=True, exist_ok=True)
+        target_path = Path(output_dir) / Path(image_path).name
+
+        # 確保檔案已經寫入完成
+        time.sleep(0.5)
+
+        if self.test_mode:
+            print(f"[測試模式] 複製圖片中: {image_path}")
+            time.sleep(0.5)
+            shutil.copy2(image_path, target_path)
+            self.root.after(0, self.display_image, str(target_path))
+        else:
+            def run_task():
+                success = self.call_gemini_api(image_path, target_path)
+                if not success:
+                    print("改用原始圖片顯示...")
+                    shutil.copy2(image_path, target_path)
+                self.root.after(0, self.display_image, str(target_path))
+            
+            threading.Thread(target=run_task, daemon=True).start()
+
+    def run(self):
+        watch_dir = os.environ.get("WATCH_DIRECTORY", "./images")
+        Path(watch_dir).mkdir(parents=True, exist_ok=True)
+        
+        event_handler = ImageHandler(self.process_and_show)
+        observer = Observer()
+        observer.schedule(event_handler, watch_dir, recursive=False)
+        observer.start()
+        
+        print(f"正在監視目錄: {watch_dir}")
+        try:
+            self.root.mainloop()
+        finally:
+            observer.stop()
+            observer.join()
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Sync Image Gen: 監視目錄、Gemini 圖片處理並全螢幕展示",
+        formatter_class=argparse.RawTextHelpFormatter
+    )
+    parser.add_argument("--watch-dir", type=str, default=os.getenv("WATCH_DIRECTORY", "./images"))
+    parser.add_argument("--output-dir", type=str, default=os.getenv("OUTPUT_DIRECTORY", "./processed"))
+    parser.add_argument("-t", "--test", action="store_true")
+    
+    args = parser.parse_args()
+    os.environ["WATCH_DIRECTORY"] = args.watch_dir
+    os.environ["OUTPUT_DIRECTORY"] = args.output_dir
+    
+    app = App(test_mode=args.test)
+    app.run()
+
+if __name__ == "__main__":
+    main()