ivyxivyx
← All ivy-agents
IVYXSTUDIO · IVY AGENT
P

Product mock-up in 3D

ivy.agent.product-mockup-3d · v0.1.0

ivyx

Turns a client's brief into a 3D product mock-up: a model picks the shape (a box, a bottle, a badge or a sign), the label and the palette, and the model is built as a glTF binary with a poster of it drawn as SVG. The 3D file is viewed in IVYX Agency with an orbit; kind deliverables.

Steps

In the order the agent's file lists them, each with where its inputs come from and the values the file fixes. A branch or a loop is a step too.

  1. 01
    Put the request together for the model
    ivy.node.design-brief

    Puts the request together as one text for the model's turn: the client, the service, the month, the brief and the figures, so the model writes for the right client.

    takes
    brief from the agent's input
    client from the agent's input
    service from the agent's input
    request_id from the agent's input
    Ivy Node
  2. 02
    Choose the shape, the label and the palette

    The context is a client's brief for a product mock-up, with the client's name. Return a JSON object with: shape (one of box, bottle, badge, sign: box for packaging, bottle for a drink or cosmetic, badge for a pin or an award, sign for a shop or an event), label (the words on it, at most 3), palette (bg, accent, text as 6-digit hex colours fitting the brief's mood), caption (one sentence on what is shown). Answer with the JSON object only. Colours are 6-digit hex. Keep the words short and concrete; no exclamation marks; no claims the brief does not make.

    takes
    context from step 1
    Model turn
  3. 03
    Build the model and its poster
    ivy.node.design-glb

    Builds a product mock-up (a box, a bottle, a badge or a sign) as a glTF 2.0 binary in the brand's colours, with smooth normals and PBR materials, and draws an isometric poster of the same thing as SVG for a thumbnail.

    takes
    spec from step 2, output
    name_prefix from the agent's input, client
    Ivy Node
  4. 04
    Pack the deliverables
    ivy.node.design-pack

    Gathers the files the steps before it made into one answer of kind deliverables (request, client, service, brief, the spec, the files with their bytes).

    takes
    spec from step 2, output
    request_id from the agent's input
    client from the agent's input
    service from the agent's input
    brief from the agent's input
    files_a from step 3, files
    returns
    kind, request_id, client, service, brief, spec, files, count
    Ivy Node

Nodes it brings

Adding this agent in IVYX Studio adds these nodes with it. A node your workspace already has is kept as it is, even at another version.

What it touches

Collected from what each of its nodes declares, plus the model call when a step is a model turn. A declaration is the author's statement, and it is what policy rules select on.

Calls a model

Inputs

FieldTypeDescription
briefrequiredstringWhat the client asked for, in their words or the account lead's: the subject, the audience, the tone, the colours if any.
clientstringThe client's name, as IVYX Agency knows it.
servicestringThe service this is work for, as IVYX Agency knows it (e.g. Content Production).
request_idstringThe request's id on the channel it came from; the key that keeps one request from running twice.

Outputs

FieldTypeDescription
kindrequiredstringdeliverables: what this output is, for a receiver that takes several kinds.
request_idstringNot declared
clientstringNot declared
servicestringNot declared
briefstringNot declared
specobjectThe design spec the model wrote from the brief, as rendered.
filesrequiredarrayThe files made: name, mime, kind, bytes, data (base64), width, height, caption, variant.
countrequiredintegerNot declared

Tests

2 of 2 test cases passed on Oct 25, 2026, in the publisher's own environment, before this version was published. The registry keeps that record; it does not run the cases again.

Requires: python:3.9, a model core

  • bottle

    A drink's mock-up is a glTF binary and its poster.

    given
    brief Foxtrot Health launches a vitamin drink, Foxtrot Fizz. A bottle mock-up in coral and cream for the pitch deck.
    client Foxtrot Health
    service Design
    request_id case-3d-1
    expects
    kind equals deliverables
    count equals 2
    files.0.mime equals model/gltf-binary
    files.0.data matches ^Z2xURg
    files.1.mime equals image/svg+xml
  • box

    A boxed product is a mock-up and a poster too.

    given
    brief A box mock-up for Acme's coffee beans gift set.
    expects
    kind equals deliverables
    count equals 2
    files.0.mime equals model/gltf-binary