Turn any topic into a TikTok/Reels/Shorts video from the command line.
One command in, vertical video out. Content Machine generates scripts, voiceover, captions, and stock footage — then renders everything into a ready-to-upload MP4.
cm generate "Redis vs PostgreSQL for caching" --archetype versus -o video.mp4
Early development — working, but APIs may change between releases.
npm install -g @45ck/content-machineOr run without installing:
npx -y @45ck/content-machine --helpRequires Node.js >= 20. See full installation guide for optional setup (Whisper, ffmpeg).
1. Try the demo (no API keys needed):
cm demo -o output/demo.mp42. Generate a real video (needs OpenAI + Pexels keys):
export OPENAI_API_KEY="sk-..."
export PEXELS_API_KEY="..."
cm generate "5 things every dev should know about Docker" \
--archetype listicle \
-o output/docker-tips.mp43. Diagnose issues:
cm doctorSee the full Quickstart guide for Whisper setup and advanced options.
| Archetype | What it produces | Example |
|---|---|---|
| listicle | "5 things..." numbered tips | cm generate "5 Docker tips" --archetype listicle |
| versus | Side-by-side comparison | cm generate "Redis vs Postgres" --archetype versus |
| howto | Step-by-step tutorial | cm generate "Deploy to AWS" --archetype howto |
| myth | Myth vs reality debunk | cm generate "JavaScript myths" --archetype myth |
| story | Narrative with a hook | cm generate "How Stripe was built" --archetype story |
| hot-take | Provocative opinion piece | cm generate "REST is dead" --archetype hot-take |
More examples: docs/user/EXAMPLES.md
Content Machine runs a 4-stage pipeline — each stage can also run independently:
topic → script → audio + timestamps → visuals → video.mp4
# Or run stages individually
cm script --topic "Redis vs PostgreSQL" # LLM generates script
cm audio --input script.json # TTS + word-level timestamps
cm visuals --input timestamps.json # Stock footage matching
cm render --input visuals.json # Remotion renders MP4
- User Guide — installation, configuration, CLI reference, examples
- Developer Docs — architecture, contributing guides, specs
- Reference — generated CLI references, environment variables, glossary
Contributions welcome! See CONTRIBUTING.md to get started.
git clone https://github.com/45ck/content-machine.git
cd content-machine && npm install && cp .env.example .env
npm run cm -- --helpMIT