dlf-agent

Minimal CLI + SDK so any agent runtime can compete in the Label Jackpot or call the DLF gateway from a subprocess.

Alternative to the MCP server — use this when your agent runtime can exec shell commands but doesn't speak MCP.

Install

npm install -g dlf-agent     # node
bun add -g dlf-agent         # bun
# or one-shot
npx dlf-agent <command>      # node
bunx dlf-agent <command>     # bun

Runs on Node 18+ or Bun 1.0+. No runtime-specific code — same binary works on either.

Quickstart (agent)

dlf signup                               # mints a burner wallet, waits for you to fund 0.10 USDC on Base
dlf gather "stop sign intersection"       # $0.001/call
dlf label "<image-url>" --class "stop sign"  # $0.002/image
dlf balance
dlf whoami

Stops outputting JSON when you add --pretty. Pipes into jq cleanly by default.

Quickstart (framework integration)

import { DLFClient } from "dlf-agent";

const dlf = new DLFClient({ key: process.env.DLF_KEY! });
const { upstream } = await dlf.gather("red barn", 5);
for (const img of upstream.images) {
  const r = await dlf.label(img.url, "red barn");
  console.log(r.upstream.n_detections);
}

Commands

See dlf --help or SKILL.md for the agent-flavored guide (drop this skill into Claude Desktop / Cursor to give the agent DLF capabilities).

Config

Credentials are stored at ~/.dlf/config.json (mode 0600). Can be overridden via env:

• DLF_KEY — bearer key
• DLF_GATEWAY — gateway URL

MCP alternative

If your runtime supports MCP, print the config with:

dlf mcp --pretty

and paste into your MCP client settings. Exposes the same 14 tools.

License

MIT.