Narrated poem

Runs the bundled nanoodle workflow workflows/narrated-poem.noodle-graph.json against the NanoGPT API: an image input (Picture) feeds a vision model that describes it, an LLM turns the description into a four-line poem, and a TTS model speaks it (Narration). Requires Node.js 22.23.4+, 24.22.1+, or 26.12.1+ and the nanoodle npm package (npx nanoodle fetches it).

API key

The run needs a NanoGPT API key. Prefer NANOGPT_API_KEY already in the environment. Otherwise pass --env-file <path-to-.env> (this CLI: --env-file overrides ambient env).

Never print the key.

Run

From this skill's directory (or prefix paths if running from elsewhere). @path attaches a local file:

npx nanoodle run workflows/narrated-poem.noodle-graph.json \
  --input "Picture=@/path/to/picture.jpg" \
  --out ./poem-out

Add --env-file .env only when the key is not already exported. Add --json for a structured result (paths, costUsd, remainingBalance).

Optional overrides:

--input "Poet=<custom poet instructions, e.g. write a limerick instead>"
--set "n4.voice=am_michael"        # pick a Kokoro voice (af_bella, am_adam, bf_emma, …)
--set "n2.q=<different question to ask about the image>"

Inspect the interface anytime with:

npx nanoodle inspect workflows/narrated-poem.noodle-graph.json

Inputs

Poet is the node name shown in the editor. It replaces that node's system prompt.

Outputs

• Media is saved under --out as Narration.<ext> — extension follows the audio MIME (often mp3 or wav). Use the path the CLI prints on the Narration: line; do not hard-code the extension.
• With --json, the path is in outputs.Narration.

Cost

Each run costs about $0.01 in NanoGPT credit (vision + LLM are fractions of a cent; Kokoro-82m speech is ~$0.002 per poem). Runs spend real credit — tell the user before running repeatedly.