Exemplos

Estes exemplos da CLI do Nodaro são receitas curtas para tarefas comuns: execuções agendadas, condições em pipelines de CI, geração por script, legendas a partir de uma transcrição e melhoria de prompts. Cada um pressupõe que você já instalou a CLI e fez login, e a maioria usa o jq para ler a saída JSON.

Executar um workflow toda noite com o cron

Esta entrada do cron executa um workflow toda noite às 03:00 e acrescenta o resultado em JSON a um arquivo de log:

0 3 * * * /usr/local/bin/nodaro workflows run wf_abc123 --json >> /var/log/nodaro-nightly.log 2>&1

Aguardar uma execução e depois continuar

--watch faz o comando aguardar a execução e sair com 0 só em caso de sucesso, então o próximo comando só é executado quando o workflow deu certo:

nodaro workflows run wf_abc --watch && \
  echo "shipped" | mail -s "nodaro run done" me@example.com

Os outros códigos de saída estão listados em Saída e códigos de saída.

Gerar uma imagem com um único comando

nodaro nodes run generate-image \
  --param prompt="a snow leopard on a mountain ridge, cinematic" \
  --param provider=flux \
  --param resolution=2K \
  --watch --json | jq -r '.output_data.imageUrl'

O comando imprime só a URL da imagem, pronta para a próxima etapa de um script.

Legendar um vídeo a partir da transcrição

Transcreva uma faixa com as marcações de tempo das palavras e depois embuta as palavras no vídeo como legendas cinéticas.

# 1. Word-level transcription (elevenlabs-stt always returns word timings)
nodaro audio transcribe --audio https://example.com/talk.mp3 \
  --provider elevenlabs-stt --watch

# 2. Save the words. They are in milliseconds; the top-level segments are in seconds.
nodaro jobs get <jobId> --json | jq '.output_data.words' > words.json

# 3. Burn them in. With captions supplied, add-captions runs no transcription of its own.
nodaro media add-captions https://example.com/talk.mp4 \
  --captions-file words.json \
  --style word-highlight --no-auto-transcribe --watch

• Corrija o text de uma palavra em words.json entre as etapas 2 e 3, e é a correção que aparece no vídeo.
• Adicione --max-words-per-line 2 à etapa 3 para uma leitura rápida, duas palavras de cada vez.
• A etapa 1 precisa de um mecanismo que marque o tempo de cada palavra: elevenlabs-stt, ou incredibly-fast-whisper com --word-timestamps. O mecanismo whisper retorna frases sem as palavras, então um estilo cinético não teria nada para mostrar.

Veja Comandos de mídia e voz para todas as opções de legenda.

Envolver o prompt de um app com texto oculto

--override adiciona texto antes e depois do prompt do usuário em uma execução, sem alterar o app:

nodaro apps run hair-styler-dd3erw --input prompt="curly red hair" \
  --override n1.promptPrefix="Studio portrait of" --override n1.promptSuffix=", 85mm, soft light"

Veja Texto antes e depois do prompt para saber como o texto é unido ao prompt.

Transformar uma ideia vaga em um prompt otimizado

prompt enhance reescreve um prompt em uma etapa. Passe o resultado direto para a execução de um nó:

PROMPT=$(nodaro prompt enhance \
  --node-type generate-image \
  --prompt "snow leopard" \
  --json | jq -r '.prompt')

nodaro nodes run generate-image --param prompt="$PROMPT" --watch

Para usar as perguntas guiadas do assistente em um script, siga o caminho de duas etapas: nodaro prompt analyze --json retorna as perguntas, e nodaro prompt generate --selection category=value monta o prompt final a partir das suas respostas. O nodaro prompt wizard interativo precisa de um terminal.

Exportar um mês de uso

Em uma instância com organizações, grave em um arquivo CSV um relatório de uso por membro:

nodaro org usage org_abc --from 2026-09-01 --to 2026-09-30 --group-by member --csv > september.csv

Veja Espaços de trabalho e organizações.