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.
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 |
| 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f88b5540f89ca02c8e2b70fba147351337627d86ba77868c6858bf99772f6e34
|
|
| MD5 |
93374663ca3d6f0fcb47e77a8dfeb308
|
|
| BLAKE2b-256 |
f74c2bb9e1f21d352749ed1b041546411ece967fa1a11e0757cf742654d0d44b
|
Provenance
The following attestation bundles were made for render_kit-1.0.1.tar.gz:
Publisher:
publish.yml on Noumenon-ai/render-kit
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
render_kit-1.0.1.tar.gz -
Subject digest:
f88b5540f89ca02c8e2b70fba147351337627d86ba77868c6858bf99772f6e34 - Sigstore transparency entry: 1796948483
- Sigstore integration time:
-
Permalink:
Noumenon-ai/render-kit@a737d46567cd3f0ab7b3a1a0558dbbe52674a557 -
Branch / Tag:
refs/tags/v1.0.1 - Owner: https://github.com/Noumenon-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a737d46567cd3f0ab7b3a1a0558dbbe52674a557 -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f9a875d98d2c5c53526683465b6e6a16284ab0f4cf3e2df29a90a3dbf50ebd22
|
|
| MD5 |
1070071afb7a1e9694fcbfe2f294ff92
|
|
| BLAKE2b-256 |
5c84bc61515ed6eaac0aa5a52ac00a6bd880a88e4ddbebe5ad8697e143500fd3
|
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
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
render_kit-1.0.1-py3-none-any.whl -
Subject digest:
f9a875d98d2c5c53526683465b6e6a16284ab0f4cf3e2df29a90a3dbf50ebd22 - Sigstore transparency entry: 1796948634
- Sigstore integration time:
-
Permalink:
Noumenon-ai/render-kit@a737d46567cd3f0ab7b3a1a0558dbbe52674a557 -
Branch / Tag:
refs/tags/v1.0.1 - Owner: https://github.com/Noumenon-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a737d46567cd3f0ab7b3a1a0558dbbe52674a557 -
Trigger Event:
push
-
Statement type: