gitcast 1.0.0__tar.gz

gitcast-1.0.0/.env.example

@@ -0,0 +1,26 @@
+# Groq — primary AI inference
+GROQ_API_KEY=your_groq_api_key_here
+
+# DeepSeek & Moonshot — specialized/free-tier fallbacks
+DEEPSEEK_API_KEY=your_deepseek_api_key_here
+MOONSHOT_API_KEY=your_moonshot_api_key_here
+CEREBRAS_API_KEY=your_cerebras_api_key_here
+OPENROUTER_API_KEY=your_openrouter_api_key_here
+
+# Gemini — vision fallback (when OCR confidence is too low)
+GEMINI_API_KEY=your_gemini_api_key_here
+
+# Optional model overrides
+GROQ_MODEL=llama-3.3-70b-versatile
+DEEPSEEK_MODEL=deepseek-chat
+MOONSHOT_MODEL=moonshot-v1-8k
+GEMINI_MODEL=gemini-2.0-flash
+CEREBRAS_MODEL=llama-3.3-70b
+OPENROUTER_MODEL=meta-llama/llama-3.3-70b-instruct:free
+
+# X (Twitter) API v2 — all five are required for posting
+TWITTER_API_KEY=your_twitter_api_key_here
+TWITTER_API_SECRET=your_twitter_api_secret_here
+TWITTER_ACCESS_TOKEN=your_twitter_access_token_here
+TWITTER_ACCESS_SECRET=your_twitter_access_secret_here
+TWITTER_BEARER_TOKEN=your_twitter_bearer_token_here

gitcast-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Timilehin Agoro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gitcast-1.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include LICENSE
+include .env.example
+include requirements.txt
+recursive-include web *
+recursive-include assets *
+recursive-include docs *

gitcast-1.0.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: gitcast
+Version: 1.0.0
+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: groq
+Requires-Dist: tweepy
+Requires-Dist: mss
+Requires-Dist: pytesseract
+Requires-Dist: httpx
+Requires-Dist: supabase
+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
+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
+
+On-demand, privacy-first desktop utility that captures active window context,
+extracts code changes, and generates platform-ready X (Twitter) posts with one keystroke.
+
+## Install
+
+```bash
+pip install gitcast
+```
+
+## Setup
+
+1. Install Tesseract OCR:
+   - Windows: https://github.com/UB-Mannheim/tesseract/wiki
+   - Mac: `brew install tesseract`
+   - Linux: `sudo apt install tesseract-ocr`
+
+2. Add your API keys:
+   ```bash
+   gitcast --setup
+   ```
+   (opens `.env` file for editing)
+
+3. Run:
+   ```bash
+   gitcast
+   ```
+
+Dashboard opens at http://127.0.0.1:8000
+Press Ctrl+Shift+P from anywhere to capture.
+
+## Stack
+- Python 3.11+
+- FastAPI, pynput, mss, Tesseract, Groq API, Tweepy

gitcast-1.0.0/README.md

@@ -0,0 +1,35 @@
+# Gitcast
+
+On-demand, privacy-first desktop utility that captures active window context,
+extracts code changes, and generates platform-ready X (Twitter) posts with one keystroke.
+
+## Install
+
+```bash
+pip install gitcast
+```
+
+## Setup
+
+1. Install Tesseract OCR:
+   - Windows: https://github.com/UB-Mannheim/tesseract/wiki
+   - Mac: `brew install tesseract`
+   - Linux: `sudo apt install tesseract-ocr`
+
+2. Add your API keys:
+   ```bash
+   gitcast --setup
+   ```
+   (opens `.env` file for editing)
+
+3. Run:
+   ```bash
+   gitcast
+   ```
+
+Dashboard opens at http://127.0.0.1:8000
+Press Ctrl+Shift+P from anywhere to capture.
+
+## Stack
+- Python 3.11+
+- FastAPI, pynput, mss, Tesseract, Groq API, Tweepy

gitcast-1.0.0/ai/formatter.py

@@ -0,0 +1,59 @@
+import re
+
+# [Formatter] module for post cleaning and thread splitting
+
+def split_into_thread(post_text: str, max_chars: int = 270) -> list[str]:
+    """
+    Splits text into multiple tweets at sentence boundaries.
+    Numbers each tweet: 1/ 2/ 3/
+    """
+    if len(post_text) <= 280:
+        return [post_text]
+
+    # Split into sentences (basic regex split)
+    sentences = re.split(r'(?<=[.!?])\s+', post_text.strip())
+    
+    tweets = []
+    current_tweet = ""
+    tweet_number = 1
+    
+    for sentence in sentences:
+        # Check if adding this sentence exceeds limit (considering "N/ " prefix)
+        prefix = f"{tweet_number}/ "
+        potential_content = current_tweet + (" " if current_tweet else "") + sentence
+        
+        if len(prefix + potential_content) <= max_chars:
+            current_tweet = potential_content
+        else:
+            if current_tweet:
+                tweets.append(f"{tweet_number}/ {current_tweet}")
+                tweet_number += 1
+            
+            # If a single sentence is too long, we must split it by words
+            if len(f"{tweet_number}/ {sentence}") > max_chars:
+                words = sentence.split()
+                sub_tweet = ""
+                for word in words:
+                    if len(f"{tweet_number}/ {sub_tweet} {word}") <= max_chars:
+                        sub_tweet = f"{sub_tweet} {word}".strip()
+                    else:
+                        tweets.append(f"{tweet_number}/ {sub_tweet}...")
+                        tweet_number += 1
+                        sub_tweet = word
+                current_tweet = sub_tweet
+            else:
+                current_tweet = sentence
+
+    if current_tweet:
+        tweets.append(f"{tweet_number}/ {current_tweet}")
+
+    return tweets
+
+if __name__ == "__main__":
+    print("=== THREAD SPLITTER TEST ===")
+    long_post = "This is a very long post that should be split into multiple tweets. It contains many sentences. Each sentence is relatively short but together they exceed the limit of a single tweet. We want to see how the formatter handles this situation by splitting at sentence boundaries and numbering the resulting tweets correctly."
+    
+    # Force small limit for testing
+    result = split_into_thread(long_post, max_chars=100)
+    for t in result:
+        print(f"[{len(t)} chars] {t}")