Metadata-Version: 2.4
Name: gitcast
Version: 1.0.16
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

> 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 out of the box with zero setup. Bring your
own API keys anytime for unlimited usage.

    pip install gitcast
    gitcast

Press Ctrl+Alt+S to capture. Open source. MIT license.

## Quick Start

### Install

    pip install gitcast

### Run

    gitcast

That's it. Gitcast works immediately using a shared
demo API key — no setup required to try it.

Dashboard opens automatically at http://localhost:8000

Press **Ctrl+Alt+S** (or **Ctrl+Shift+P**) from
anywhere — VS Code, terminal, browser — to capture
your screen and git diff, then generate a post.

### Add your own API key (optional)

The shared key has rate limits. For unlimited usage,
add your own free key:

    gitcast --setup

This opens your .env file. Add any of these
(all free):

| Provider | Get Key | Free Tier |
|----------|---------|-----------|
| Groq | console.groq.com | 12k tokens/min |
| DeepSeek | platform.deepseek.com | $5 credit |
| Gemini | aistudio.google.com | 1M tokens/day |

Your key always takes priority over the shared key.

### CLI usage

    gitcast                    Start dashboard + hotkey listener
    gitcast "your thought"     Quick capture with inline thought
    gitcast capture            Interactive multi-shot screenshot session
    gitcast --setup            Configure your own API keys
    gitcast --version          Show version

## Stack
- Python 3.11+
- FastAPI, pynput, mss, Tesseract, Groq API, Tweepy
