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.
Что это не умеет из коробки?Оно проигрывает только заранее подготовленный поворот между двумя фиксированными положениями и статичные детальные виды спереди и сзади. Корзины, оплаты и учёта товаров здесь нет, а повороты, созданные ИИ, всё равно нужно проверять вручную по вашим исходным фотографиям.
Не видны ли где-нибудь мои исходные фото или ключи?Нет — в README указано публиковать только собранную папку dist/, а исходные фото, API-ключи и промежуточные генерации держать в тайне.
Что за два готовых примера одежды?Белая рубашка с принтом «Альпийское озеро», поворот для которой создан в LTX-2.5 Pro, и розовая рубашка с принтом «Джокер», повёрнутая с помощью Kling 3.0 через Pika; оба воспроизводятся локально без затрат на генерацию.
Кто придумал взаимодействие «поворот при наведении»?Идея этого взаимодействия принадлежит @cambreedesigns; этот репозиторий — независимая реализация данной идеи.
Можно ли опубликовать результат где угодно?Да — после того как вы одобрите локальный предпросмотр, можно попросить агента опубликовать его на выбранном хостинге; развернуть нужно только папку dist/.
Какие есть похожие проекты?herk-edit-kit, openfilm, ClaudeAnimationBase, reelmimic, motion-prompt, livecanvas, huashu-art-motion, onetake
Автор
amirmushichge
Размер
2.6 MB
Звёзды
212
Возраст
1 мес
Коммиты · 90 дней