gitcast 1.0.25__tar.gz → 1.0.26__tar.gz

gitcast-1.0.26/.env.example

@@ -0,0 +1,26 @@
+# ────────────────────────────────────────────
+# GITCAST CONFIGURATION
+# ────────────────────────────────────────────
+# Gitcast works out of the box — no keys needed.
+# The shared key is built in.
+#
+# Add your own key only if you want unlimited
+# personal usage without shared rate limits.
+# ────────────────────────────────────────────
+
+# Your optional API key (BYOK)
+# Get free at console.groq.com (2 minutes)
+# Leave empty to use Gitcast shared key
+BYOK_KEY=
+BYOK_PROVIDER=groq
+
+# Twitter — only needed for direct X publishing
+# Get from developer.twitter.com
+TWITTER_API_KEY=
+TWITTER_API_SECRET=
+TWITTER_ACCESS_TOKEN=
+TWITTER_ACCESS_SECRET=
+TWITTER_BEARER_TOKEN=
+
+# Cloud server (do not change)
+GITCAST_API_URL=https://gitcast-api.onrender.com

gitcast-1.0.26/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: gitcast
+Version: 1.0.26
+Summary: git diff → published post. under 60 seconds.
+Home-page: https://github.com/drizzy765/gitcast
+Author: Timilehin Agoro
+Author-email: agorotimilehi05@gmail.com
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pynput
+Requires-Dist: pystray
+Requires-Dist: Pillow
+Requires-Dist: fastapi
+Requires-Dist: uvicorn
+Requires-Dist: python-dotenv
+Requires-Dist: tweepy
+Requires-Dist: mss
+Requires-Dist: pytesseract
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: cryptography
+Requires-Dist: python-jose[cryptography]
+Requires-Dist: rich
+Requires-Dist: keyboard
+Requires-Dist: slowapi
+Requires-Dist: limits
+Requires-Dist: sentry-sdk[fastapi]
+Requires-Dist: posthog
+Requires-Dist: plyer
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Gitcast
+
+> git diff -> published post. under 60 seconds.
+
+Privacy-first developer tool that captures your coding session via hotkey, generates AI-powered social media posts, and publishes them without breaking your flow.
+
+Works immediately after install - no API key setup required. Gitcast's shared key is built in.
+
+---
+
+## Quick Start
+
+### Step 1 - Install Tesseract OCR
+
+Required for local screenshot text extraction. Runs entirely on your machine - your code never leaves without your permission.
+
+**Windows:**
+
+1. Download: github.com/UB-Mannheim/tesseract/wiki
+2. Run installer
+3. Check "Add to PATH" during installation
+4. Restart your terminal
+
+**Mac:**
+
+```bash
+brew install tesseract
+```
+
+**Linux:**
+
+```bash
+sudo apt install tesseract-ocr
+```
+
+### Step 2 - Install Gitcast
+
+```bash
+pip install gitcast
+```
+
+### Step 3 - Run
+
+```bash
+gitcast
+```
+
+Dashboard opens automatically at http://localhost:8000
+
+Press **Ctrl+Shift+P** or **Ctrl+Alt+S** from anywhere - VS Code, terminal, browser - to capture your screen and generate a post.
+
+Works immediately. No configuration needed. Gitcast's shared API key is built in.
+
+### Step 4 - Add your own key (optional)
+
+The shared key has rate limits shared across users. For unlimited personal usage, add your own free key:
+
+```bash
+gitcast --setup
+```
+
+Or go to **[BYOK]** in the dashboard sidebar.
+
+Get a free Groq key in 2 minutes at console.groq.com
+
+Your key takes priority - shared key stays as fallback.
+
+---
+
+## What Gitcast generates
+
+From a single hotkey press:
+
+- **X (Twitter) post** - published directly via API
+- **LinkedIn draft** - with framed screenshot
+- **PR description** - paste into GitHub
+- **Quick win** - short punchy update
+- **Article** - Medium-ready markdown
+
+---
+
+## How it works
+
+```text
+Ctrl+Shift+P (or Ctrl+Alt+S)
+
+-> screenshot captured locally
+
+-> git diff read locally
+
+-> OCR runs on your machine (Tesseract)
+
+-> payload sent to Gitcast cloud
+
+-> AI generates 4 post variations
+
+-> dashboard shows results
+
+-> you review, refine, publish
+```
+
+---
+
+## Privacy
+
+- OCR runs locally - text extracted on your machine
+- Screenshots processed locally before any upload
+- Sensitive content (API keys, tokens) auto-blocked
+- Nothing always-on - you trigger every capture
+- No account required to use
+
+---
+
+## CLI
+
+```text
+gitcast                 Start dashboard + hotkey
+
+gitcast --setup         Add your own API key (optional)
+
+gitcast capture         Interactive screenshot session
+
+gitcast --version       Show version
+```
+
+---
+
+## Stack
+
+- Python 3.10+, FastAPI, pynput, mss
+- Tesseract OCR (local)
+- Groq, Gemini, OpenRouter, Cerebras (cloud)
+- Tweepy (X API v2)
+- Supabase (cloud storage)
+
+---
+
+## License
+
+MIT - free forever. Open source.
+
+Built by Timilehin Agoro (@drizzy765) in Nigeria.

gitcast-1.0.26/README.md

@@ -0,0 +1,142 @@
+# Gitcast
+
+> git diff -> published post. under 60 seconds.
+
+Privacy-first developer tool that captures your coding session via hotkey, generates AI-powered social media posts, and publishes them without breaking your flow.
+
+Works immediately after install - no API key setup required. Gitcast's shared key is built in.
+
+---
+
+## Quick Start
+
+### Step 1 - Install Tesseract OCR
+
+Required for local screenshot text extraction. Runs entirely on your machine - your code never leaves without your permission.
+
+**Windows:**
+
+1. Download: github.com/UB-Mannheim/tesseract/wiki
+2. Run installer
+3. Check "Add to PATH" during installation
+4. Restart your terminal
+
+**Mac:**
+
+```bash
+brew install tesseract
+```
+
+**Linux:**
+
+```bash
+sudo apt install tesseract-ocr
+```
+
+### Step 2 - Install Gitcast
+
+```bash
+pip install gitcast
+```
+
+### Step 3 - Run
+
+```bash
+gitcast
+```
+
+Dashboard opens automatically at http://localhost:8000
+
+Press **Ctrl+Shift+P** or **Ctrl+Alt+S** from anywhere - VS Code, terminal, browser - to capture your screen and generate a post.
+
+Works immediately. No configuration needed. Gitcast's shared API key is built in.
+
+### Step 4 - Add your own key (optional)
+
+The shared key has rate limits shared across users. For unlimited personal usage, add your own free key:
+
+```bash
+gitcast --setup
+```
+
+Or go to **[BYOK]** in the dashboard sidebar.
+
+Get a free Groq key in 2 minutes at console.groq.com
+
+Your key takes priority - shared key stays as fallback.
+
+---
+
+## What Gitcast generates
+
+From a single hotkey press:
+
+- **X (Twitter) post** - published directly via API
+- **LinkedIn draft** - with framed screenshot
+- **PR description** - paste into GitHub
+- **Quick win** - short punchy update
+- **Article** - Medium-ready markdown
+
+---
+
+## How it works
+
+```text
+Ctrl+Shift+P (or Ctrl+Alt+S)
+
+-> screenshot captured locally
+
+-> git diff read locally
+
+-> OCR runs on your machine (Tesseract)
+
+-> payload sent to Gitcast cloud
+
+-> AI generates 4 post variations
+
+-> dashboard shows results
+
+-> you review, refine, publish
+```
+
+---
+
+## Privacy
+
+- OCR runs locally - text extracted on your machine
+- Screenshots processed locally before any upload
+- Sensitive content (API keys, tokens) auto-blocked
+- Nothing always-on - you trigger every capture
+- No account required to use
+
+---
+
+## CLI
+
+```text
+gitcast                 Start dashboard + hotkey
+
+gitcast --setup         Add your own API key (optional)
+
+gitcast capture         Interactive screenshot session
+
+gitcast --version       Show version
+```
+
+---
+
+## Stack
+
+- Python 3.10+, FastAPI, pynput, mss
+- Tesseract OCR (local)
+- Groq, Gemini, OpenRouter, Cerebras (cloud)
+- Tweepy (X API v2)
+- Supabase (cloud storage)
+
+---
+
+## License
+
+MIT - free forever. Open source.
+
+Built by Timilehin Agoro (@drizzy765) in Nigeria.

gitcast-1.0.26/ai/generator.py

@@ -0,0 +1,165 @@
+import httpx
+from ai.prompts import sprint_summary_prompt
+from core.log_stream import stream_log
+
+# ── Constants ─────────────────────────────────────────────────────────────────
+
+TIMEOUT = 15
+
+_last_call_meta = {"provider_used": "", "used_fallback": False}
+
+
+def refresh_provider_keys(user_id: str = "") -> None:
+    from config.settings import reload_api_keys
+
+    reload_api_keys()
+
+
+# ── Main generator ────────────────────────────────────────────────────────────
+
+async def generate_posts(payload: dict, user_id: str = "") -> dict:
+    from core.cloud_client import cloud_generate
+
+    stream_log("GENERATOR", "INFO", "sending to Gitcast cloud server...")
+
+    results = await cloud_generate(payload)
+
+    if not results:
+        stream_log("GENERATOR", "ERROR", "cloud server returned no results")
+        return {
+            k: (
+                "[Error] Could not reach generation "
+                "server. Check your internet connection."
+            )
+            for k in payload.get(
+                "format_keys",
+                ["x_post", "linkedin", "pr_desc", "quick_win"],
+            )
+        }
+
+    for key in results:
+        if isinstance(results[key], str) and not results[key].startswith("[Error]"):
+            stream_log("GENERATOR", "OK", f"{key} generated successfully")
+
+    return results
+
+
+async def refine_post(
+    current_post: str,
+    instruction: str,
+    format_key: str,
+    **kwargs,
+) -> str:
+    from core.cloud_client import cloud_refine
+
+    return await cloud_refine(
+        current_post=current_post,
+        instruction=instruction,
+        format_key=format_key,
+    )
+
+
+# ── Sprint generator ──────────────────────────────────────────────────────────
+
+async def generate_sprint_summary(entries: list, narrative: str = "", user_id: str = "") -> str:
+    """
+    Synthesizes multiple sprint captures into a single cohesive thread.
+    """
+    from api.payload import build_sprint_payload
+    
+    stream_log("Generator", "AI", f"synthesizing {len(entries)} captures into sprint thread")
+    
+    payload = build_sprint_payload(entries)
+    if narrative:
+        payload["narrative"] = narrative
+    system_prompt = sprint_summary_prompt(len(entries))
+    
+    try:
+        return await _ai_call("sprint_summary", system_prompt, payload["user_message"], user_id=user_id)
+    except Exception as e:
+        stream_log("Generator", "ERROR", f"sprint synthesis failed: {e}")
+        return f"[Error] {str(e)}"
+
+
+# ── Provider Routing & Fallback ────────────────────────────────────────────────
+
+async def _ai_call(
+    format_key: str,
+    system_prompt: str,
+    user_message: str,
+    user_id: str = "",
+    unavailable: dict[str, str] | None = None,
+    client: httpx.AsyncClient = None,
+    meta: dict | None = None,
+) -> str:
+    """Compatibility wrapper that routes legacy route calls through the cloud."""
+    results = await generate_posts(
+        {
+            "format_keys": [format_key],
+            "system_prompt": system_prompt,
+            "user_message": user_message,
+        },
+        user_id=user_id,
+    )
+    content = results.get(format_key, "")
+    if not content:
+        return "[Error] Could not reach generation server. Check your internet connection."
+    return content
+
+
+async def _groq_call(system_prompt: str, user_message: str, retries: int = 2) -> str:
+    return await _ai_call("deep_tech", system_prompt, user_message)
+
+
+async def _gemini_text_call(system_prompt: str, user_message: str, client: httpx.AsyncClient = None) -> str:
+    return await _ai_call("deep_tech", system_prompt, user_message)
+
+async def _gemini_vision_call(
+    system_prompt: str,
+    user_message: str,
+    screenshots: list,
+    client: httpx.AsyncClient = None,
+) -> str:
+    return await _ai_call("deep_tech", system_prompt, user_message)
+
+
+def _encode_image(image_path: str) -> str:
+    import base64
+    try:
+        with open(image_path, "rb") as f:
+            return base64.b64encode(f.read()).decode("utf-8")
+    except Exception:
+        return ""
+
+
+# ── Test ──────────────────────────────────────────────────────────────────────
+
+if __name__ == "__main__":
+    import asyncio
+    from core.capture import run_capture
+    from core.ocr import run_ocr
+    from api.payload import build_payload
+    from config.settings import set_project_narrative
+
+    set_project_narrative("an AI-powered build-in-public automation tool for developers")
+
+    async def test():
+        print("[Generator] Running multi-provider routing test...")
+        capture = run_capture()
+        ocr = run_ocr(capture["screenshot"]["path"])
+        payload = build_payload(
+            raw_thought="testing the new multi-provider fallback chain with Cerebras and OpenRouter",
+        )
+
+        payload["use_vision_fallback"] = False
+        payload["screenshot_b64"] = None
+
+        print("[Generator] Firing routed AI calls...")
+        results = await generate_posts(payload)
+
+        print("\n=== GENERATED POSTS ===")
+        for format_key, content in results.items():
+            print(f"\n--- {format_key.upper()} ---")
+            print(content)
+
+    asyncio.run(test())