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.
