interactive-garment-starter README

项目的 README,来自 github.com/amirmushichge/interactive-garment-starter。合并为一个 markdown 文件:README.md。

Interactive Garment Starter

Turn product photos into an interactive clothing website with your AI agent. Hover a garment to turn it, move away to reverse, and click to inspect. On a phone, swipe to browse and tap to open.

By Amir Mušić. Interaction concept: @cambreedesigns. This is an independent implementation.

Start in Codex or Claude Code

Give this repository to your coding agent and paste this message:

Use this repository to build my interactive clothing website.
Read AGENTS.md and START-HERE.md, then follow docs/agent-workflow.md.
Set up the project and open the included example for me first.
Then help me replace one garment with my own photos or artwork.
Handle the technical work. Ask me for missing files, account access,
visual decisions and a spending limit before any paid generation.
Keep the result local until I approve publication.

Your agent checks your computer, prepares the tools and opens a working example. You choose your product, review the visuals and approve any generation costs. The two included shirts are already animated, so trying them requires no API account or generation payment.

Using a downloaded ZIP? Give its local folder to the agent with the same message. A coding agent with local file and terminal access can carry out setup. If a connection or permission is missing, it should explain the exact next step.

The included example

Alpine lake · LTX-2.5 Pro Wild cards · Kling 3.0 through Pika
White alpine-print concept Pastel-pink cards concept

Both original prints were supplied by Amir. The cotton bases and matched views were generated with an image tool; the exact graphics were placed on the fronts. The white shirt’s turn uses LTX-2.5 Pro; the pink shirt’s turn uses Kling 3.0 through Pika. These garment concepts are bundled with the motion files, interface and prompts. Clothing-brand catalog media is excluded.

The example includes reversible rail turns, moving neighbors, touch browsing, keyboard controls and static front/back detail views. The example build records the production decisions and costs.

From the example to your own website

  1. See it working. Your agent runs the supplied example and opens a local preview
  2. Choose a product. Give it front/back photos or your original print, plus any visual references
  3. Review the image anchors. Your agent prepares the front and strict side profile for you to approve
  4. Approve a generation budget. The agent checks your available image/video tools, helps connect an account and quotes settings, attempts and a spending cap
  5. Review your website. The agent generates or imports the turn, removes the background, adds the garment and tests the actual interaction

Ask for changes in the same chat. Once you approve the local result, ask the agent to publish it to your chosen host. If its environment lacks an image or video tool, it helps you connect one or import prepared media. Your original photos stay available for comparison throughout.

Included for your agent

Prepared footage plays locally in the browser. Generating your own footage is a separate, potentially paid step, approved before it runs.

Manual commands for developers

The example needs Node.js 20.6+ and has no npm packages. From the repository root:

node scripts/serve.mjs
# Open the URL printed by the server (default: http://127.0.0.1:5264)

Checks and static build:

node --test tests/runtime.test.mjs tests/server.test.mjs tests/ltx.test.mjs
node scripts/audit.mjs
node scripts/build.mjs

For optional footage processing, use Python 3.10+, Pillow, NumPy and FFmpeg/ffprobe. The agent setup instructions cover a project-local environment and tool discovery. Deploy only dist/; keep source photos, keys and intermediate generations private.

The first-run verification records what was tested and what remains environment-dependent.

Scope and permissions

This method plays a prepared turn between two orientations. Detail views show static front/back images. A shopping cart, payments and inventory would be additional work. AI can change print, fabric or silhouette: review generated media against your source photos, at actual UI speed and on the devices you intend to support.

Code and procedural fixtures: MIT. The bundled original-art garment media is also released under MIT, within the scope described in LICENSE-ASSETS.md. See LICENSE-ASSETS.md, rights and attribution, and third-party notices. Manrope uses SIL Open Font License 1.1.

interactive-garment-starter (amirmushichge/interactive-garment-starter)

正在搜索数据库…

这是什么?这是一个入门套件,可以把服装商品照片变成可交互的网页:鼠标悬停时衣服会旋转,移开则反向旋转,点击即可查看细节。它借助 Codex 或 Claude Code 等编程助手搭建而成。
怎么让它运行起来?把代码仓库(或下载的 ZIP 解压后的本地文件夹)交给 Codex 或 Claude Code,并发送 README 中的启动消息,它会先运行两个自带的衬衫示例。如果手动操作,你只需在仓库根目录安装 Node.js 20.6+,无需安装任何 npm 包,即可运行检查并生成静态构建。
试用时需要 API 密钥或账号吗?自带的两件衬衫不需要,它们已预先制作好动画,可以免费试用。如果你想为自己的服装生成旋转画面,则需要图像或视频生成服务的账号并设置消费上限;若要在本地处理画面素材(可选),还需要 Python 3.10+、Pillow、NumPy 和 FFmpeg。
开箱即用时它有哪些做不到的?它只能播放在两个固定朝向之间预先制作好的旋转画面,并附带静态的正面和背面细节图。它不包含购物车、支付或库存管理功能;AI 生成的旋转画面仍需对照你的原始照片进行人工审核。
我的原始照片或密钥会被暴露吗?不会。README 说明只需部署构建生成的 dist/ 文件夹,并请将原始照片、API 密钥和中间生成文件保留为私密内容。
自带的两件示例服装是什么?一件是印有高山湖泊图案的白色衬衫,其旋转画面由 LTX-2.5 Pro 生成;另一件是印有“万能牌”图案的粉色衬衫,其旋转画面通过 Pika 调用 Kling 3.0 制作。两件都可以在本地播放,无需任何生成费用。
悬停旋转这种交互是谁提出的?这一交互概念的作者是 @cambreedesigns,本仓库是对该创意的独立实现。
做好的网页可以部署到任何地方吗?可以。你确认本地预览效果后,可以让编程助手把它发布到你选择的托管平台,且只需部署 dist/ 文件夹。
大小
2.6 MB
星标
212
时长
1个月
提交 · 90 天