Quick Start

This walkthrough uses the recommended workbook flow for an official template.

Check your environment

loomloom doctor

Fix any server or token error before continuing.

Choose an official template

loomloom template list

Template availability depends on the environment. The remaining examples use text-image-v1; replace it with a visible template ID when needed.

Download the workbook

loomloom template download text-image-v1 --output-file ./input.xlsx

Open the workbook and add one AI Workload per row. Keep the column headers and workbook structure unchanged.

Validate and estimate

loomloom template validate-file text-image-v1 ./input.xlsx
loomloom template precheck-file text-image-v1 ./input.xlsx

Validation checks the workbook without starting a run. Precheck estimates model/API cost and checks available balance without creating billable usage.

Review and submit

Review the template ID, input file, row count, cost estimate, currency, and balance. Submit only after you explicitly decide to proceed.

loomloom template submit-file text-image-v1 ./input.xlsx \
  --client-request-id <stable-id>

Keep the client request ID with the input. Reuse it only when retrying the identical submission.

Monitor and download results

Preserve the returned run ID exactly.

loomloom run watch <run-id>
loomloom run result-workbook <run-id> --output-file ./result.xlsx
loomloom artifact download <run-id> --output-dir ./artifacts

template submit-file creates a hosted run and can create billable model/API usage. An AI agent must show the current estimate and obtain a fresh explicit confirmation before running it.

Next, learn how templates, runs, and artifacts work.

Supported Models Templates

⌘I

Overview

LoomLoom

Privacy