⚡ GROK_RUNNER

Cyberpunk neural interface for AI image, video, and character generation — multi-engine, multi-payment, creator-friendly.

Live: grokrunner.gltch.app Current version: v4.9 (2026.05.06)

✨ What it does

A cyberpunk-themed app for generating, editing, and sharing AI media. It bundles four generation engines, a creator-monetized social feed, 24-hour stories, character chat, $XRGE crypto payments, and a public developer API behind one terminal-flavored interface.

Generation modes

Mode	What it does
🖼️ GENERATE	Text → Image
✏️ MODIFY	Edit existing images with prompts (Flux 2 Klein)
🎬 RENDER	Text → Video (up to 15s, WAN 2.2 + RIFE)
🎞️ ANIMATE	Image → Video (start/end frame interpolation)
🧬 CHARACTERS	Persistent AI personalities with vision + media generation

Engines

• GLTCH PRO (ComfyUI) — best quality, full LoRA stack, NSFW unlocks
• GLTCH (default) — fast and balanced
• GROK (xAI) — official xAI Imagine pipeline

🆕 Recent highlights (v4.9)

• XRGE Holder program — tiers from holding XRGE (wallet + bank), daily snapshots, streak multipliers; Holder tab in XRGE Bank and profile badge
• Discounts that bill correctly — holder savings stack with subscription discounts on generations (including SEEDANCE and the public API)
• Daily credits — 10 base for verified users plus extra dailies for Operative+ tiers based on streak
• ComfyUI billing fix — chained free steps restricted to the Z-Image start-frame workflow with rate limits

See the in-app Changelog dialog for the full history.

🔑 Account & payment options

• BYOK — bring your own xAI / RunPod key, 100% client-side, never sent to us
• Credits — Stripe checkout for one-time packs and monthly subscriptions
• $XRGE on Base — pay or get paid in crypto; 80% of XRGE post/story unlocks go straight to the creator's wallet
• Free daily credits for subscribers, scaled by plan — the table is api/_lib/dailyCredits.ts
• Daily Missions, Spin the Wheel, Referrals, Flash Sales — gamified credit boosts

🎨 Creator platform

• Post images and 24-hour stories with optional credit / USD / $XRGE locks
• Revenue split: 75/20/5 for credits & USD, 80/20 for $XRGE (instant on-chain)
• Manual USD payouts ($25 min) or instant $XRGE conversion ($1 min)
• Verified creator badges, follow/follower system, comment threads

See CREATOR-PLATFORM.md for the full spec.

🔒 Privacy at a glance

Data	Where it lives	When it's deleted
Generated media (default)	Your browser (IndexedDB)	When you clear it
BYOK API keys	Your browser (localStorage)	Never sent to us
Feed posts / avatars	Vercel Blob (server)	Auto-purged on delete
Stories	Vercel Blob (server)	Auto-deleted after 24h
Share links (/s/:id)	Vercel Blob (server)	Auto-purged when you delete the source result
Account email + bcrypt hash	Neon Postgres	On account deletion
Prompt text	Not stored, except for daily-mission verification & flagged-post moderation

A weekly cron also sweeps Blob storage for orphaned files (with a 24-hour safety window). Full details in the in-app Privacy Protocol dialog.

🚀 Quick start

npm install
npm run dev        # local dev
npm run build      # production build

🏗️ Architecture

┌──────────────────────────────────────────────────────────┐
│  Frontend (React + Vite + Tailwind + shadcn/ui)          │
│  BYOK mode → calls xAI / RunPod directly                 │
│  Credits mode → calls /api/* serverless functions        │
└────────────────────────┬─────────────────────────────────┘
                         │
         ┌───────────────▼───────────────┐
         │  Vercel Serverless Functions  │
         │  /api/auth/*    /api/generate │
         │  /api/credits   /api/comfyui  │
         │  /api/checkout  /api/feed     │
         │  /api/xrge-*    /api/stories  │
         │  /api/share     /api/v1/*     │
         │  /api/cron-blob-orphans (wk)  │
         └────┬──────────┬──────────┬────┘
              │          │          │
       ┌──────▼──┐  ┌────▼────┐  ┌──▼──────────┐
       │  Neon   │  │ Stripe  │  │ Vercel Blob │
       │ Postgres│  │ + XRGE  │  │  (media)    │
       └─────────┘  └─────────┘  └─────────────┘

🔧 Environment variables

Copy .env.example and fill in the values you need. Core requirements:

Variable	Required	Description
DATABASE_URL	✅	Neon Postgres connection string
JWT_SECRET	✅	Random 64-char string for signing tokens
XAI_API_KEY	✅	xAI key for credit-mode Grok proxy
STRIPE_SECRET_KEY	✅	Stripe secret key
STRIPE_WEBHOOK_SECRET	✅	Stripe webhook signing secret
STRIPE_PRICE_*	✅	Stripe Price IDs for packs and subscriptions
RESEND_API_KEY	✅	Email delivery (verification, 2FA, alerts)
BLOB_READ_WRITE_TOKEN	✅	Vercel Blob token for posts/stories/shares
SITE_URL	✅	Frontend URL for redirects
RUNPOD_* / COMFYUI_URL	optional	Enable GLTCH / GLTCH PRO engines
XRGE_*	optional	Enable $XRGE crypto payments on Base
DEEPSEEK_API_KEY	optional	Alternate backend for character chat

See .env.example for the full list.

❓ FAQ

Where do my generations go? By default, nowhere — they live in your browser's IndexedDB. Files only hit our server when you explicitly post to the feed, publish a story, set an avatar, or create a /s/:id share link.

What happens when I delete something? The database row goes first, then the underlying Vercel Blob is auto-purged. A weekly cron also sweeps for any orphaned files with a 24-hour safety window. Stories self-destruct after 24 hours regardless.

Do you store my prompts? Not by default. We log generation type, credit cost, and timestamp for billing. Prompt text is only kept when needed to verify a daily-mission action (e.g. shared:<id>) or to moderate a flagged feed post.

What's BYOK and is it safer? "Bring Your Own Key" lets you paste your own xAI / RunPod API key. It's stored only in your browser's localStorage and never reaches our servers. In BYOK mode, your prompts go straight from your browser to the AI provider.

Do credits expire?

• Subscription credits reset every billing cycle (no rollover).
• Pack credits never expire.
• Daily free credits (10/day) reset every 24 hours for verified accounts.

How do creator earnings work?

• Posts/stories locked in credits or USD — split 75% creator / 20% platform / 5% reserve. USD payouts manual review at $25 min.
• Posts/stories locked in $XRGE — split 80% creator / 20% platform, paid instantly on-chain to the creator's Base wallet. Convert in-app earnings to $XRGE at $1 min.

Is this 18+? Yes. The Platform requires age confirmation and account verification. NSFW LoRAs unlock for users with a $30 Stripe purchase, an $XRGE pack, or an $XRGE deposit. CSAM and non-consensual imagery are zero-tolerance — see the in-app Terms of Service.

Can I self-host? Yes — the frontend works in BYOK mode on any static host. For the SaaS features you'll need to deploy the api/ folder to Vercel and provide Neon + Stripe + Blob credentials. See SELF-HOSTING.md.

How do I delete my account? Settings → Delete Account. Your profile, posts, stories, and any associated media files are removed.

Where can I report abuse or DMCA? Email [email protected] for copyright. Use the in-app report flow on any post, story, or profile for community-guideline issues — flagged content is auto-removed at 6 unique reports.

🏠 Self-hosting

See SELF-HOSTING.md for Docker, iSH, and static-server instructions.

🛠️ Tech stack

Frontend: React 18 · TypeScript · Vite · Tailwind · shadcn/ui · IndexedDB · vite-plugin-pwa · react-i18next (10 languages, RTL) Backend: Vercel Serverless Functions · Neon Postgres · bcryptjs + JWT · Vercel Blob Generation: xAI Grok · RunPod (ComfyUI: Flux 2 Klein, WAN 2.2, Z-Image Turbo) · DeepSeek Payments: Stripe · $XRGE on Base Integrations: Resend (email) · Telegram bot

📝 License

Private project. All rights reserved.