xAI • Open source experiments

grok-lab

4 viral-grade experiments built on xAI Grok

Clone & run locally Explore the experiments
CI MIT License • Next.js 16 + TypeScript
All apps work instantly in demo mode. Paste your xAI key for real Grok models.
Deploy any app with the Vercel button in the README for public "live demo" links you can share (highly recommended — the export/clip features are built for this).
Public demos: roast-voice realtime voice roasts now live when deployed with key. Add your deployed URLs to the README + showcase!
grok-lab header banner
View on GitHub
LIVE SHOWCASE Served via GitHub Pages from the /docs folder (auto-deployed by GitHub Actions on push to main).
One-time setup: Go to Settings → Pages and set Source = GitHub Actions. The workflow is already in .github/workflows/deploy-pages.yml.
Current status

All apps have polished, key-optional demos that run instantly. roast-voice now has working realtime voice roasts (model generates + speaks when you enable the toggle + provide a key). Full-duplex reference client + tools in voice-lab. Production: LiveKit (guide in docs).

Quick start
The four experiments

Built for sharing, forking & remixing

🎙️
roast-voice
Brutal honesty, out loud
source
Deliver brutally honest, quotable voice roasts from Grok and make exporting shareable clips trivial.
roast-voice app screenshot
Next.js 16 Web Speech API grok-4.3
cd apps/roast-voice
npm install
npm run dev
View source
🔊
voice-lab
The canonical client
source
The canonical open-source reference implementation for voice + tools + personalities when talking to Grok.
voice-lab app screenshot
Personalities X search Tool calling
cd apps/voice-lab
npm install
npm run dev
View source
🖼️
voice-imagine
Voice-directed creation
source
Demonstrate natural voice-driven creative loops for image generation and live iterative refinement.
voice-imagine app screenshot
Iterative prompting Real voice STT grok-imagine-image
cd apps/voice-imagine
npm install
npm run dev
View source
🧵
grok-threads
Threads that spread
source
Produce ready-to-post, high-engagement X threads with multiple angles and pixel-perfect live preview.
grok-threads app screenshot
Variant generator X preview grok-4.3
cd apps/grok-threads
npm install
npm run dev
View source
Quick start (any app)

Get running in under 60 seconds

1. Get an xAI API key (free tier available)
https://console.x.ai
2. Run any experiment
cd grok-lab/apps/roast-voice
npm install
npm run dev
Open http://localhost:3000. Toggle real voice after pasting your key.
All four apps are fully independent. Deploy any to Vercel with one click (add your XAI_API_KEY env for production demos).
Deploy guide Deploy on Vercel
Realtime voice & architecture

A full browser-based xAI Realtime WebSocket client (16kHz PCM, tool calling, multiple voices) is the highest-leverage next step. See the detailed integration guide with LiveKit migration path included in the repo.

Read REALTIME-INTEGRATION.md
Contributing
  • • Improve clip export (real mixed audio)
  • • Add LiveKit / Pipecat production voice versions
  • • More personalities & prompt packs
  • • Real X posting integration (opt-in)
Read CONTRIBUTING.md