Skip to main content

Agent-ordered 3D product mockups, served as an A2MCP service on OKX.AI

Project description

Ondaru

3D product mockups your agent can order.

Another agent describes a product, logo, or character. Ondaru returns a textured glb and a turntable render — ordered and paid for inside that agent's own workflow, with no human in the loop.

Listed on OKX.AI as an A2MCP service.

Why an agent needs this

A language model can describe a mesh. It cannot produce one. That is the whole proposition: Ondaru does the part the calling agent genuinely cannot do itself, which is what separates a service worth paying for from one that gets tried once and abandoned.

Install

pip install ondaru
ondaru setup-mcp        # register the endpoint with your agent
ondaru skills install   # teach your agent when to call it

Then ask your agent for a product mockup.

The three tools

Tool What it does Cost
plan_product_mockup Dimensions, material, polygon budget, and a firm price — in about a second, because it produces a plan, not geometry entry tier
order_product_mockup Places the order and returns a job id immediately asset tier
check_product_mockup Polls the job and collects the asset when ready free

No tool waits for generation. Ordering returns a job id, not a model — you poll for the result. That is not a design preference: the marketplace client severs any call at 30 seconds, and neither generation nor rendering reliably finishes inside that.

Surfaces: mug, hoodie, tshirt, phone case, tote, sticker, figurine, packaging.

Reading the outcome

A failed job names its cause and carries no asset. There is no placeholder and no degraded version — if the asset field is absent, nothing was produced.

An identical order inside the retention window returns the same job and does not charge again, so retrying after a dropped connection is safe.

Development

make up      # Postgres, Redis, and a fake generation backend under OrbStack
make check   # lint and types
make test    # integration suite against real infrastructure
make load    # k6, reporting avg / median / p95 / p99 and throughput

See CLAUDE.md for the invariants and the measured facts behind them, and docs/plans/ for the implementation plan.

Licence

MIT.

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

ondaru-0.1.0.tar.gz (304.4 kB view details)

Uploaded Source

Built Distribution

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

ondaru-0.1.0-py3-none-any.whl (76.5 kB view details)

Uploaded Python 3

File details

Details for the file ondaru-0.1.0.tar.gz.

File metadata

  • Download URL: ondaru-0.1.0.tar.gz
  • Upload date:
  • Size: 304.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for ondaru-0.1.0.tar.gz
Algorithm Hash digest
SHA256 d373361e9e80796a0b9244dd09ad62506efae0710563fc5dd49be76692ada932
MD5 f36e58cbe8d77fd1822fc236cae88e1a
BLAKE2b-256 2217b1ac24287cd2ddc48094ecfb496e8b4ca417219341328a2c4952b3578463

See more details on using hashes here.

File details

Details for the file ondaru-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: ondaru-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 76.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for ondaru-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2452172fdb7f3f0d8da31fa8b2ad122bea134a6caf15b6c4a6057ff6acee9bb9
MD5 0908b622e618367637c789b80aab0a83
BLAKE2b-256 e30fcdc31d9adde5cbf60448fcac25c6c40d9a8f74d4ac623940388f5fe3a4dc

See more details on using hashes here.

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