nika: v1
workflow:
  id: og-images
  description: "Generate the launch OG hero image set into ./assets/og"

permits:
  fs: { write: ["./assets/og/**"] }   # the ONLY place assets may land
  tools: ["nika:image_generate"]

tasks:
  hero:
    invoke:
      tool: "nika:image_generate"
      args:
        provider: mock                # offline + deterministic · flip to gemini/openai to render for real
        prompt: "OG hero — a monarch butterfly over a deep-blue nebula, editorial photo, negative space left"
        aspect_ratio: "16:9"          # exact WxH is an openai gpt-image-2 feature · gemini folds to a size class
        n: 2                          # two variants to A/B
        output_dir: "./assets/og"
        filename_prefix: "launch-hero"
        metadata: { campaign: "launch", page_slug: "home" }

outputs:
  paths: ${{ tasks.hero.output.images }}
  manifest: ${{ tasks.hero.output.manifest_path }}

{"a":{"graph_format":2,"workflow":"og-images","nodes":[{"id":"hero","verb":"invoke","tool":"nika:image_generate","permits":["fs.write: ./assets/og/**","tool: nika:image_generate"]}],"edges":[]},"engine":"0.105.0"}

showcase · tier 1 · business

OG images

Brief in, OG variants on disk + a provenance manifest out. Mock renders real PNGs offline; flip one line for your local server (sovereign), gemini, openai or xai. Real spend lands on the run ledger.

Every save permit-gated, every byte sha256-verified, provenance embedded in the PNG itself. No other engine treats images this honestly. · conformance-gated in nika-spec ↗ · re-proven at every push

The whole file

1 tasks · 1 wave · the plan falls out of the bindings, nothing is scheduled by hand.

t1-og-images.nika.yamlsource

1nika: v12workflow:3  id: og-images4  description: "Generate the launch OG hero image set into ./assets/og"56permits:7  fs: { write: ["./assets/og/**"] }   # the ONLY place assets may land8  tools: ["nika:image_generate"]910tasks:11  hero:12    ◆invoke:13      tool: "nika:image_generate"14      args:15        provider: mock                # offline + deterministic · flip to gemini/openai to render for real16        prompt: "OG hero — a monarch butterfly over a deep-blue nebula, editorial photo, negative space left"17        aspect_ratio: "16:9"          # exact WxH is an openai gpt-image-2 feature · gemini folds to a size class18        n: 2                          # two variants to A/B19        output_dir: "./assets/og"20        filename_prefix: "launch-hero"21        metadata: { campaign: "launch", page_slug: "home" }2223outputs:24  paths: ${{ tasks.hero.output.images }}25  manifest: ${{ tasks.hero.output.manifest_path }}26

nika inspect · engine 0.105.0 · vendored graph, never re-derived

0 declared edges · 1 wave · the plan falls out of the bindings

try itopen in the playground guidethe walkthrough · docs verbinvoke toolnika:image_generate