catime 0.4.0__tar.gz → 0.4.2__tar.gz

{catime-0.4.0 → catime-0.4.2}/.github/workflows/hourly-cat.yml

@@ -2,7 +2,7 @@ name: Hourly Cat Generator
 
 on:
   schedule:
-    - cron: '0 * * * *'  # Every hour at :00
+    - cron: '0,30 * * * *'  # Every hour at :00 and :30 (retry)
   workflow_dispatch: # Allow manual trigger
 
 permissions:
@@ -24,7 +24,7 @@ jobs:
           python-version: '3.12'
 
       - name: Install dependencies
-        run: pip install nanobanana-py
+        run: pip install nanobanana-py google-genai
 
       - name: Generate cat and update repo
         env:

{catime-0.4.0 → catime-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: catime
-Version: 0.4.0
+Version: 0.4.2
 Summary: AI-generated hourly cat images - a new cat every hour!
 License-Expression: MIT
 License-File: LICENSE

{catime-0.4.0 → catime-0.4.2}/catlist.json

@@ -438,5 +438,63 @@
     "url": "https://github.com/yazelin/catime/releases/download/cats/cat_2026-02-02_0226_UTC.png",
     "model": "gemini-3-pro-image-preview",
     "status": "success"
+  },
+  {
+    "number": 64,
+    "timestamp": "2026-02-02 05:00 UTC",
+    "url": "https://github.com/yazelin/catime/releases/download/cats/cat_2026-02-02_0500_UTC.png",
+    "model": "gemini-3-pro-image-preview",
+    "status": "success"
+  },
+  {
+    "number": 65,
+    "timestamp": "2026-02-02 06:55 UTC",
+    "url": "https://github.com/yazelin/catime/releases/download/cats/cat_2026-02-02_0655_UTC.png",
+    "model": "gemini-2.5-flash-image (fallback from gemini-3-pro-image-preview, reason: API 503: The model is overloaded. Please try again later.)",
+    "status": "success"
+  },
+  {
+    "number": null,
+    "timestamp": "2026-02-02 07:45 UTC",
+    "url": null,
+    "model": "all failed",
+    "status": "failed",
+    "error": "Failed to generate any images - All models failed. Last error: No image data in response"
+  },
+  {
+    "number": 67,
+    "timestamp": "2026-02-02 08:35 UTC",
+    "url": "https://github.com/yazelin/catime/releases/download/cats/cat_2026-02-02_0835_UTC.png",
+    "model": "gemini-2.5-flash-image (fallback from gemini-3-pro-image-preview, reason: API 503: The model is overloaded. Please try again later.)",
+    "status": "success"
+  },
+  {
+    "number": 68,
+    "timestamp": "2026-02-02 09:39 UTC",
+    "url": "https://github.com/yazelin/catime/releases/download/cats/cat_2026-02-02_0939_UTC.png",
+    "model": "gemini-2.5-flash-image (fallback from gemini-3-pro-image-preview, reason: API 503: The model is overloaded. Please try again later.)",
+    "status": "success"
+  },
+  {
+    "number": 69,
+    "timestamp": "2026-02-02 10:37 UTC",
+    "url": "https://github.com/yazelin/catime/releases/download/cats/cat_2026-02-02_1037_UTC.png",
+    "model": "gemini-2.5-flash-image (fallback from gemini-3-pro-image-preview, reason: API 503: The model is overloaded. Please try again later.)",
+    "status": "success"
+  },
+  {
+    "number": 70,
+    "timestamp": "2026-02-02 11:31 UTC",
+    "url": "https://github.com/yazelin/catime/releases/download/cats/cat_2026-02-02_1131_UTC.png",
+    "model": "gemini-2.5-flash-image (fallback from gemini-3-pro-image-preview, reason: API 503: The model is overloaded. Please try again later.)",
+    "status": "success"
+  },
+  {
+    "number": 71,
+    "timestamp": "2026-02-02 12:21 UTC",
+    "prompt": "A cinematic, ultra-high-resolution photograph of a majestic, short-haired black cat with piercing emerald eyes. The cat is poised gracefully on a sleek, minimalist control panel within a futuristic, dimly lit research observatory. Behind the cat, a massive panoramic window reveals a breathtaking view of a swirling nebula in deep space, juxtaposed against the distant, glittering spires of a high-tech metropolis on an exoplanet. The cat's fur is sharply defined, catching the subtle blue and purple glows emanating from the numerous holographic displays and soft LED strips embedded in the console. One prominent, transparent OLED screen, slightly angled towards the viewer, clearly displays the text: '2026-02-02 12:21 UTC' in a crisp, futuristic font, glowing with a soft, warm amber light. The scene is bathed in a dramatic interplay of cool cosmic blues and warm console oranges, creating striking rim lighting on the cat's silhouette. The atmosphere is serene yet profoundly mysterious, suggesting advanced intelligence and cosmic contemplation. Hyperdetailed, volumetric lighting, shallow depth of field, f/1.4, 85mm lens, award-winning photography, professional studio shot, intricate textures, unreal engine 5, octane render, 16k.",
+    "url": "https://github.com/yazelin/catime/releases/download/cats/cat_2026-02-02_1221_UTC.png",
+    "model": "gemini-2.5-flash-image (fallback from gemini-3-pro-image-preview, reason: API 503: The model is overloaded. Please try again later.)",
+    "status": "success"
   }
 ]

{catime-0.4.0 → catime-0.4.2}/docs/app.js

@@ -18,6 +18,9 @@
   const lbImg = document.getElementById("lb-img");
   const lbInfo = document.getElementById("lb-info");
   const lbClose = document.getElementById("lb-close");
+  const lbPrompt = document.getElementById("lb-prompt");
+  const lbPromptText = document.getElementById("lb-prompt-text");
+  const lbCopyBtn = document.getElementById("lb-copy-btn");
 
   // Date picker elements
   const datePickerBtn = document.getElementById("date-picker-btn");
@@ -214,8 +217,21 @@
   function openLightbox(cat) {
     lbImg.src = cat.url;
     lbInfo.textContent = `#${cat.number} \u00b7 ${cat.timestamp} \u00b7 ${cat.model || ""}`;
+    if (cat.prompt) {
+      lbPromptText.textContent = cat.prompt;
+      lbPrompt.classList.remove("hidden");
+      lbCopyBtn.textContent = "\u{1f4cb} Copy";
+    } else {
+      lbPrompt.classList.add("hidden");
+    }
     lightbox.classList.remove("hidden");
   }
+  lbCopyBtn.addEventListener("click", () => {
+    navigator.clipboard.writeText(lbPromptText.textContent).then(() => {
+      lbCopyBtn.textContent = "\u2705 Copied!";
+      setTimeout(() => { lbCopyBtn.textContent = "\u{1f4cb} Copy"; }, 1500);
+    });
+  });
   lbClose.addEventListener("click", () => lightbox.classList.add("hidden"));
   lightbox.addEventListener("click", e => { if (e.target === lightbox) lightbox.classList.add("hidden"); });
   document.addEventListener("keydown", e => { if (e.key === "Escape") lightbox.classList.add("hidden"); });

{catime-0.4.0 → catime-0.4.2}/docs/index.html

@@ -51,6 +51,10 @@
     <button id="lb-close" aria-label="Close">&times;</button>
     <img id="lb-img" src="" alt="Cat">
     <div id="lb-info"></div>
+    <div id="lb-prompt" class="hidden">
+      <p id="lb-prompt-text"></p>
+      <button id="lb-copy-btn" title="Copy prompt">📋 Copy</button>
+    </div>
   </div>
 
   <script src="app.js"></script>

{catime-0.4.0 → catime-0.4.2}/docs/style.css

@@ -255,6 +255,7 @@ body {
   backdrop-filter: blur(8px);
   display: flex; flex-direction: column;
   align-items: center; justify-content: center;
+  overflow-y: auto; padding: 2rem 0;
 }
 #lb-close {
   position: absolute; top: 1rem; right: 1.2rem;
@@ -264,7 +265,7 @@ body {
 }
 #lb-close:hover { transform: scale(1.2) rotate(90deg); }
 #lb-img {
-  max-width: 90vw; max-height: 80vh;
+  max-width: 90vw; max-height: 65vh;
   border-radius: 16px;
   box-shadow: 0 12px 40px rgba(0,0,0,.3);
 }
@@ -273,6 +274,29 @@ body {
   font-weight: 600; text-shadow: 0 1px 4px rgba(0,0,0,.3);
 }
 
+/* Lightbox prompt */
+#lb-prompt {
+  margin-top: .8rem; max-width: 600px; width: 90vw;
+  background: rgba(0, 0, 0, .5); border-radius: 12px;
+  padding: .7rem 1rem; display: flex; align-items: flex-start; gap: .6rem;
+}
+#lb-prompt-text {
+  color: #fff; font-size: .82rem; line-height: 1.5;
+  word-break: break-word; flex: 1;
+  max-height: 4.5em; overflow-y: auto;
+  scrollbar-width: thin; scrollbar-color: var(--pink-light) transparent;
+}
+#lb-prompt-text::-webkit-scrollbar { width: 4px; }
+#lb-prompt-text::-webkit-scrollbar-thumb { background: var(--pink-light); border-radius: 4px; }
+#lb-copy-btn {
+  flex-shrink: 0; padding: .3rem .7rem; border: none; border-radius: 20px;
+  background: linear-gradient(135deg, var(--pink), var(--purple));
+  color: #fff; font-family: inherit; font-size: .78rem; font-weight: 700;
+  cursor: pointer; transition: transform .2s, box-shadow .2s; white-space: nowrap;
+  box-shadow: 0 2px 8px rgba(255, 107, 157, .3);
+}
+#lb-copy-btn:hover { transform: scale(1.05); box-shadow: 0 4px 12px rgba(255, 107, 157, .5); }
+
 /* Responsive */
 @media (max-width: 1024px) {
   .masonry { column-count: 2; margin-right: 0; }

{catime-0.4.0 → catime-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "catime"
-version = "0.4.0"
+version = "0.4.2"
 description = "AI-generated hourly cat images - a new cat every hour!"
 readme = "README.md"
 requires-python = ">=3.10"

{catime-0.4.0 → catime-0.4.2}/scripts/generate_cat.py

@@ -8,11 +8,41 @@ import sys
 from datetime import datetime, timezone
 from pathlib import Path
 
+PROMPT_META = (
+    "You are a professional prompt engineer for AI image generation. "
+    "Create a single, detailed English prompt for generating a stunning image. "
+    "Requirements: (1) A cat must be the subject or prominently featured "
+    "(2) The date and time '{timestamp}' must be visually displayed in the image. "
+    "Beyond these two requirements, you have complete creative freedom — surprise me with "
+    "varied styles (photography, painting, illustration, etc.), unique scenes, interesting "
+    "compositions, lighting, and moods. Do NOT include any resolution keywords "
+    "(like 4K, 8K, 16K, etc.) in the prompt. Output ONLY the prompt text, nothing else."
+)
+
 REPO = os.environ.get("GITHUB_REPOSITORY", "yazelin/catime")
 RELEASE_TAG = "cats"
 
 
-async def generate_cat_image(output_dir: str, timestamp: str) -> dict:
+def generate_prompt(timestamp: str) -> str:
+    """Use Gemini text model to generate a creative image prompt."""
+    try:
+        from google import genai
+
+        client = genai.Client()
+        response = client.models.generate_content(
+            model="gemini-2.5-flash",
+            contents=PROMPT_META.format(timestamp=timestamp),
+        )
+        prompt = response.text.strip()
+        if prompt:
+            print(f"AI-generated prompt: {prompt[:120]}...")
+            return prompt
+    except Exception as e:
+        print(f"Prompt generation failed ({e}), using fallback.")
+    return f"A cute cat with the date and time '{timestamp}' displayed in the image, high quality, detailed"
+
+
+async def generate_cat_image(output_dir: str, timestamp: str, prompt: str) -> dict:
     """Use nanobanana-py's ImageGenerator to generate a cat image."""
     from nanobanana_py.image_generator import ImageGenerator
     from nanobanana_py.types import ImageGenerationRequest
@@ -20,7 +50,7 @@ async def generate_cat_image(output_dir: str, timestamp: str) -> dict:
     generator = ImageGenerator()
 
     request = ImageGenerationRequest(
-        prompt=f"畫一隻可愛的貓，並在圖片中顯示現在的日期與時間: {timestamp}",
+        prompt=prompt,
         filename=f"cat_{timestamp.replace(' ', '_').replace(':', '')}",
         resolution="1K",
         file_format="png",
@@ -112,12 +142,14 @@ def get_or_create_monthly_issue(now: datetime) -> str:
     return url.split("/")[-1]
 
 
-def post_issue_comment(issue_number: str, image_url: str, number: int, timestamp: str, model_used: str):
+def post_issue_comment(issue_number: str, image_url: str, number: int, timestamp: str, model_used: str, prompt: str = ""):
     """Post a comment on the monthly issue with the cat image."""
+    prompt_line = f"**Prompt:** {prompt}\n" if prompt else ""
     body = (
         f"## Cat #{number}\n"
         f"**Time:** {timestamp}\n"
-        f"**Model:** `{model_used}`\n\n"
+        f"**Model:** `{model_used}`\n"
+        f"{prompt_line}\n"
         f"![cat-{number}]({image_url})"
     )
     subprocess.run(
@@ -158,12 +190,31 @@ def update_catlist_and_push(entry: dict) -> int:
     return number or 0
 
 
+def already_has_cat_this_hour(now: datetime) -> bool:
+    """Check if a successful cat already exists for the current hour."""
+    catlist_path = Path("catlist.json")
+    if not catlist_path.exists():
+        return False
+    cats = json.loads(catlist_path.read_text())
+    hour_prefix = now.strftime("%Y-%m-%d %H:")
+    return any(
+        c.get("status", "success") == "success" and c["timestamp"].startswith(hour_prefix)
+        for c in cats
+    )
+
+
 def main():
     now = datetime.now(timezone.utc)
     timestamp = now.strftime("%Y-%m-%d %H:%M UTC")
 
+    # Skip if this hour already has a successful cat
+    if already_has_cat_this_hour(now):
+        print(f"Cat already exists for hour {now.strftime('%Y-%m-%d %H')} UTC, skipping.")
+        return
+
     print(f"Generating cat for {timestamp}...")
-    result = asyncio.run(generate_cat_image("/tmp", timestamp))
+    prompt = generate_prompt(timestamp)
+    result = asyncio.run(generate_cat_image("/tmp", timestamp, prompt))
 
     # Read current count for numbering
     catlist_path = Path("catlist.json")
@@ -197,6 +248,7 @@ def main():
     entry = {
         "number": next_number,
         "timestamp": timestamp,
+        "prompt": prompt,
         "url": image_url,
         "model": model_used,
         "status": "success",
@@ -207,7 +259,7 @@ def main():
     print("Posting issue comment...")
     issue_number = get_or_create_monthly_issue(now)
     print(f"Using monthly issue #{issue_number}")
-    post_issue_comment(issue_number, image_url, next_number, timestamp, model_used)
+    post_issue_comment(issue_number, image_url, next_number, timestamp, model_used, prompt)
 
     print(f"Done! Cat #{next_number}")
 

{catime-0.4.0 → catime-0.4.2}/src/catime/cli.py

@@ -36,6 +36,8 @@ def print_cat(cat: dict, index: int | None = None):
     else:
         print(f"Cat #{num:>4}  {cat['timestamp']}  model: {cat.get('model', '?')}")
         print(f"  URL: {cat['url']}")
+        if cat.get("prompt"):
+            print(f"  Prompt: {cat['prompt']}")
 
 
 def filter_by_query(cats: list[dict], query: str) -> list[dict]: