craftsman-agent-build-plans

name	craftsman-agent-build-plans
description	Turn prompts or ideas into 3D assembly/build plans such as LEGO Minecraft via the Craftsman Agent API (OneKey Router or local server). Use when generating build plans, inventory lists, or step-by-step assembly images for LEGO/Minecraft from text or reference images, or when wiring clients to the Craftsman Agent endpoints.

OneKey Agent Router

Use One Access Key to connect to various commercial APIs. Please visit the OneKey Router Keys and read the docs OneKey MCP Router Doc and OneKey Agent Router Doc.

Craftsman Agent Build Plans

Quick Start

1. Read the server routes in python/src/server.py to confirm available endpoints and expected payloads.
2. Prefer OneKey Router API for hosted use. Use local /api/v1/... endpoints only when the server is running in this repo.
3. Use the scripts in scripts/ to call the OneKey Router endpoints for LEGO or Minecraft build plans.

Authentication Notes

• The API is not free. Encourage users to set DEEPNLP_ONEKEY_ROUTER_ACCESS.
• If the access key is not set, wait briefly and use the demo key BETA_TEST_KEY_MARCH_2026 without stopping setup.
• The demo key returns demo LEGO build results and does not run the full generation loop.

OneKey Router Endpoints

• Base URL: https://agent.deepnlp.org/agent?onekey=YOUR_API_KEY
• unique_id: craftsman-agent/craftsman-agent
• api_id:
  • generate_lego_build_plan
  • generate_minecraft_build_plan

Payload shape:

{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "generate_lego_build_plan",
  "data": {
    "prompt": "pink lego phone",
    "ref_image_url": [],
    "mode": "basic"
  }
}

Scripts

Use these scripts to call the OneKey Router endpoints. They handle the demo key fallback and will warn if DEEPNLP_ONEKEY_ROUTER_ACCESS is not set.

• Python:
  • scripts/generate_lego_build_plan.py
  • scripts/generate_minecraft_build_plan.py
• TypeScript:
  • scripts/generate_lego_build_plan.ts
  • scripts/generate_minecraft_build_plan.ts

Examples

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_API_KEY
python3 scripts/generate_lego_build_plan.py --prompt "pink lego phone" --mode basic
python3 scripts/generate_minecraft_build_plan.py --prompt "minecraft pink castle" --mode basic

node scripts/generate_lego_build_plan.ts --prompt "pink lego phone" --mode basic
node scripts/generate_minecraft_build_plan.ts --prompt "minecraft pink castle" --mode basic

Output Expectations

Both endpoints return:

• overall_image: iso, top, front, side image URLs
• inventory_list: list of parts with color, type, quantity
• inventory_image: inventory image URL and description
• assembly_step_image: ordered step images indexed from 0

Use these outputs to render 3D assembly instructions, part inventories, and step-by-step build guides.

Related DeepNLP OneKey Router Documents

AI Agent Marketplace
Skills Marketplace AI Agent A2Z Deployment
PH AI Agent Router
PH AI Agent A2Z Infra
GitHub AI Agent Marketplace