Skip to main content

Generate product photos and social media images from the command line.

Project description

Render-Kit

Product visuals + social media images from the command line.

Two engines, one CLI:

  • Free, no API key (PIL): styled placeholder mockups — preset-driven layouts with your product name, ready for drafts, wireframes, and pipeline testing. These are designed text cards, not photographs.
  • AI photos (Replicate, optional): photorealistic product shots via Flux 1.1 Pro, about $0.04/image. This is the path that produces real-looking product photography.
$ render-kit product "leather journal" --preset dark_luxury

Built by NOUMENON — AI agents that debate, evolve, and build.

PyPI License: MIT Python 3.10+

Why This Exists

Professional product photography costs $500+. Every Shopify and Etsy seller needs product visuals. Render-Kit gives you one consistent CLI for the whole journey: free styled placeholders while you design and test (PIL, offline), then flip on photorealistic generation when you are ready (Flux 1.1 Pro via Replicate, about $0.04 per image — set REPLICATE_API_TOKEN and the same commands produce AI photos).

Install

pip install render-kit

# Optional: AI-powered generation
pip install render-kit[ai]

# Optional: Text-to-speech
pip install render-kit[voice]

Usage

Product Photography

# Single preset
render-kit product "leather journal" --preset dark_luxury

# All 5 presets at once
render-kit product "leather journal" --all-presets

# Available presets: white_studio, lifestyle, dark_luxury, flat_lay, heritage

Social Media

# Instagram square
render-kit social "NOUMENON — AI that debates before it builds" --template ig_square

# Instagram carousel (4 slides)
render-kit social "Launch Day" --template ig_carousel --slides 4

# Twitter/X header
render-kit social "New Release" --template twitter

# YouTube thumbnail
render-kit social "How I Built This" --template youtube_thumb

Video

render-kit video --scenes scenes.json --fps 30

Voiceover

render-kit voice "Welcome to our product" --output voiceover.wav

Batch Processing

render-kit batch products.csv --preset lifestyle

CSV format:

name,preset
Leather Journal,dark_luxury
Canvas Bag,heritage
Coffee Mug,white_studio

Presets

Preset Background Style
white_studio Pure white Studio lighting, clean
lifestyle Warm wood Editorial, bokeh
dark_luxury Dark Dramatic rim lighting
flat_lay Off-white Top-down, styled
heritage Dark amber Artisan, aged wood

Social Templates

Template Size Use Case
ig_square 1080x1080 Instagram feed
ig_story 1080x1920 Instagram/TikTok story
ig_carousel 1080x1080 Multi-slide carousel
twitter 1200x675 Twitter/X post
og 1200x630 Open Graph / link preview
youtube_thumb 1280x720 YouTube thumbnail

Engines

  • PIL (default) — Free, offline. Generates styled placeholder mockups (designed text cards using the preset's palette), not photographs. No API key needed.
  • Replicate (optional) — Photorealistic images via Flux 1.1 Pro (black-forest-labs/flux-1.1-pro), $0.04 per output image (replicate.com/pricing). Used automatically when a token is set; falls back to PIL otherwise.

Set REPLICATE_API_TOKEN to enable AI generation:

export REPLICATE_API_TOKEN=r8_your_token_here

License

MIT


Part of the NOUMENON ecosystem.

Built by Noumenon

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

render_kit-1.0.1.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

render_kit-1.0.1-py3-none-any.whl (14.1 kB view details)

Uploaded Python 3

File details

Details for the file render_kit-1.0.1.tar.gz.

File metadata

  • Download URL: render_kit-1.0.1.tar.gz
  • Upload date:
  • Size: 12.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for render_kit-1.0.1.tar.gz
Algorithm Hash digest
SHA256 f88b5540f89ca02c8e2b70fba147351337627d86ba77868c6858bf99772f6e34
MD5 93374663ca3d6f0fcb47e77a8dfeb308
BLAKE2b-256 f74c2bb9e1f21d352749ed1b041546411ece967fa1a11e0757cf742654d0d44b

See more details on using hashes here.

Provenance

The following attestation bundles were made for render_kit-1.0.1.tar.gz:

Publisher: publish.yml on Noumenon-ai/render-kit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file render_kit-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: render_kit-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 14.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for render_kit-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f9a875d98d2c5c53526683465b6e6a16284ab0f4cf3e2df29a90a3dbf50ebd22
MD5 1070071afb7a1e9694fcbfe2f294ff92
BLAKE2b-256 5c84bc61515ed6eaac0aa5a52ac00a6bd880a88e4ddbebe5ad8697e143500fd3

See more details on using hashes here.

Provenance

The following attestation bundles were made for render_kit-1.0.1-py3-none-any.whl:

Publisher: publish.yml on Noumenon-ai/render-kit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page