recap-relay/assets/ABOUT.md

Recap Relay

Operator-side credit-metered proxy for Recap clients. Fronts Google Gemini (and optionally a local Parakeet+Gemma setup) so Recap users on Core/Pro/Max tiers can summarize videos without bringing their own API keys.

What it does

• Receives POST /relay/transcribe and POST /relay/analyze from Recap installs
• Validates X-Recap-Install-Id and optional Authorization: Bearer LIC1-... against a Keysat license server (cached online check)
• Tracks per-install credit balances in /data/credits.json with calendar-month rollover for paid tiers
• Routes to Gemini first; falls back to the operator's Parakeet+Gemma above the per-user-per-month Gemini cap

Setup

After installing, set:

1. Gemini API Key — required, the relay's primary backend
2. Keysat URL — defaults to https://keysat.xyz; override to the internal hostname if Keysat is co-located on this Start9 server
3. Admin Password — gates the /admin/* dashboard
4. (Optional) Parakeet URL + Gemma URL — operator-hardware fallback for Pro/Max overflow

Then forward a public hostname (e.g. relay.yourdomain.com) to this service via StartTunnel, and point your Recap install's "Set Relay URL" action at that hostname.

Tier defaults

• Core (unlicensed): 5 lifetime credits
• Pro (relay_pro entitlement): 50 monthly credits, max 25 via Gemini
• Max (relay_max entitlement): unlimited monthly, max 50 via Gemini

Adjust via the "Adjust Tier Quotas" action without redeploying.