AI-powered content engine for videos and carousels.
Say it in plain English, post it everywhere.
Content Engine turns plain-English prompts into publish-ready videos and carousels for TikTok, Instagram, and X. Open the repo in Claude Code or Codex, describe what you want, and the agent handles research, template selection, asset generation, captioning, and scheduled posting.
Everything is template-first — your ideas become reusable formats, not throwaway prompts. Generation is powered by Grok (API key or browser session), so you can produce content with or without an xAI API key. Approved assets flow into a scheduling queue that posts on your behalf.
- Videos — short-form viral clips, multi-clip story arcs, promos, character pieces, ASMR-style content
- Carousels — educational breakdowns, comparison lists, product showcases
- Auto-captioned assets — captions baked into every video workflow
- Scheduled posts — queue approved content for TikTok, Instagram, and X
npm install
pip install -r requirements.txt
npx playwright install chromium
cp .env.example .envOptionally add your XAI_API_KEY to .env, or rely on browser-based Grok session reuse.
Then open the repo in Claude Code or Codex and ask:
generate a video about a tired founder who clones himself to finish work
generate a carousel about how to season a cast iron pan
generate a 3-clip promo video for a local bakery
- You describe what you want in plain English
- The agent researches the format and finds or creates a reusable template
- Grok generates images and video clips from the template's prompt contract
- The pipeline stitches clips, adds captions, and saves all artifacts
- You approve and the agent queues the asset for scheduled posting
There are two separate auth tracks:
Grok (generation) — works with XAI_API_KEY in .env or via browser cookies extracted from Chrome (npm run auth:grok). Generation works without an API key.
Platform posting — requires saved cookies for each platform. Run npm run auth:posting (or platform-specific variants like npm run auth:posting:tiktok) to extract session cookies from Chrome.
See docs/INSTALLATION.md for the full setup guide.
