Craftsman Agent Build Plans

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 Gateway 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 Gateway 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 Gateway Endpoints

• Base URL: https://agent.deepnlp.org/agent
• 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",
    "images": [],
    "mode": "basic"
  }
}

Usage

1. CLI (Recommended)

CLI Illustration

npx onekey agent <unique_id> <api_id> $JSON --timeout 60000

• <unique_id>: the unique identifier of the onekey routed agents, "owner/repo".
• <api_id>: refers to the unique endpoint name of API.
• $JSON: the json string passed to cli.
• --timeout: controls the timeout of API calling, unit is mill seconds.

Example

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_ACCESS_KEY
npx onekey agent craftsman-agent/craftsman-agent generate_lego_build_plan '{"prompt":"Build Lego yacht with 5 decks using blue and white bricks","images":[],"mode":"basic"}' --timeout 60000

2. Scripts

Use these scripts to call the OneKey Gateway 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.

Dependencies

CLI Dependency

Install onekey-gateway from npm

npm install @aiagenta2z/onekey-gateway

Script Dependency

Install the required Python package before running any scripts.

pip install ai-agent-marketplace

Alternatively, install dependencies from the requirements file:

pip install -r requirements.txt

If the package is already installed, skip installation.

Agent rule

Before executing command lines or running any script in the scripts/ directory, ensure the dependencies are installed. Use the npx onekey CLI as the preferred method to run the skills.