A Python script that turns any Shopify store's product catalog into social-media-ready videos using the Runway API, with no app installs needed.

Stars

25

7-day growth

No data

Forks

2

Open issues

0

License

MIT

Last updated

2026-07-05

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It leverages Shopify's public products.json to generate product videos automatically at low cost (~$0.12 per video), preserving the original product photo as the anchor frame to avoid AI hallucinations.

Who it is for

  • Shopify store owners
  • E-commerce marketers
  • Social media content creators
  • Developers building automated video pipelines

Use cases

  • Generate Reels-ready product videos for Instagram or TikTok
  • Quickly produce video assets for paid social campaigns
  • Batch animate catalog images after a product launch
  • Test video concepts with dry-runs before spending credits

Strengths

  • Works with any public Shopify store without authentication
  • Dry-run mode previews generation without spending credits
  • Style presets (studio, lifestyle, dramatic) can be extended via a plain dictionary
  • Idempotent re-runs skip already-rendered products, preventing double billing

Considerations

  • Requires the store to have a publicly accessible products.json (some stores block it)
  • Each 5-second video costs ~60 Runway credits (~$0.60) and the minimum credit purchase is $10
  • Image URLs must be public HTTPS; videos may be rejected if the account hits daily API limits

README quick start

🛍️ → 🎬  Catalog → Campaign

Turn any Shopify catalog into platform-ready product videos, with one script and the Runway API.

Before: ordinary catalog photos, pulled straight from deathwishcoffee.com's public products.json.

↓   gen4.5 image → video   ↓

After: a Reels-ready 9:16 video per product, the catalog photo preserved as the anchor frame. Full-quality MP4s in examples/.


Point it at a store. It pulls each product's photo, animates it with gen4.5 (your catalog shot is the anchor frame, so the product stays true, no hallucinated variants), and exports a Reels-ready 9:16 video per product.

Your first run: about ten minutes. A 5-second clip is 60 credits (~$0.60), so the $10 minimum credit purchase covers around 16 product videos.

⚡ Quickstart

git clone https://github.com/fabriciocarraro/runway-shopify-pipeline && cd runway-shopify-pipeline
pip install -r requirements.txt
cp .env.example .env     # add your API key → get one at https://dev.runwayml.com

python catalog_to_video.py --catalog sample_catalog.json --dry-run    # sanity check: runs with no key, spends nothing
python catalog_to_video.py --store yourstore.myshopify.com --skus 5   # the real thing: YOUR products, moving

That second command is the whole point: most Shopify stores expose products.json publicly, so this runs against your real catalog with zero app installs and zero auth dances.

What a run looks like:

🛍  Fetching catalog from yourstore.myshopify.com …
   3 of 3 products to generate · 5s each · est. ~180 credits (~$1.80)

  🚀 submitted retro-runner-sneaker  (task 21dcba8c…)
  🚀 submitted soy-candle-cedar  (task 0a4214c4…)
  🚀 submitted steel-bottle-750ml  (task 9f9086d4…)

  ✅ retro-runner-sneaker.mp4
  ✅ soy-candle-cedar.mp4
  ✅ steel-bottle-750ml.mp4

🎬 3 videos · 6m42s wall-clock · ~180 credits (~$1.80)

📣 Tweet-ready: "I turned yourstore.myshopify.com's catalog into 3 product videos in 6 minutes, for about $1.80. No shoot, no agency. One script."

Tip: --dry-run previews any run, live store included, without spending a credit. To ge

Description

Turn any Shopify catalog into product videos with the Runway API. One script, gen4.5 image-to-video.

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482