craftsman-agent（工匠 Agent）

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",
    "ref_image_url": [],
    "mode": "basic"
  }
}

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 onekey CLI as the preferred method to run the skills.