Nodaro ドキュメント
ドキュメントノードリファレンスモデルAI エージェント(MCP)開発者向けセルフホスティングリサーチ
CLI

例

cron で毎晩ワークフローを実行する、実行結果で CI のステップをゲートする、画像生成をスクリプト化する、動画に字幕を付ける、プロンプトを改善するといった、すぐに使える Nodaro CLI のレシピです。

この Nodaro CLI の使用例は、よくある作業のための短いレシピです。スケジュール実行、CI ゲート、スクリプトによる生成、文字起こしからの字幕、プロンプトの改善を扱います。どの例も、CLI をインストールしてログイン済みであることを前提とし、ほとんどは JSON 出力の読み取りに jq を使います。

cron でワークフローを毎晩実行する

この cron エントリーは、毎晩 03:00 にワークフローを実行し、JSON の結果をログファイルに追記します。

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

実行を待ってから続ける

--watch を付けると、コマンドは実行を待ち、成功したときだけ 0 で終了します。そのため、次のコマンドは、ワークフローが成功したときだけ実行されます。

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

そのほかの終了コードは、出力と終了コードに一覧があります。

1 つのコマンドで画像を生成する

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'

このコマンドは画像の URL だけを表示するので、そのままスクリプトの次のステップに使えます。

文字起こしから動画に字幕を付ける

単語のタイミング付きでトラックを文字起こしし、その単語をキネティック字幕として焼き込みます。

# 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
  • 手順 2 と 3 の間で words.json 内の単語の text を修正すると、その修正が動画に反映されます。
  • 手順 3 に --max-words-per-line 2 を追加すると、一度に 2 単語ずつのテンポの速い字幕になります。
  • 手順 1 には、単語単位のエンジンが必要です。elevenlabs-stt、または --word-timestamps を付けた incredibly-fast-whisper を使います。whisper エンジンは単語のないフレーズしか返さないため、キネティックスタイルには表示するものがありません。

字幕のすべてのオプションについては、メディアと音声のコマンドを参照してください。

アプリのプロンプトを隠しテキストで囲む

--override は、アプリ自体を変更することなく、その実行に限ってユーザーのプロンプトの前後にテキストを追加します。

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

そのテキストがプロンプトにどのように結合されるかについては、プロンプトの前後のテキストを参照してください。

大まかなアイデアを、最適化されたプロンプトにする

prompt enhance は、プロンプトを 1 ステップで書き直します。その結果を、そのままノードの実行に渡します。

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

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

ウィザードのガイド付きの質問をスクリプトで使うには、2 ステップの方法を使います。nodaro prompt analyze --json が質問を返し、nodaro prompt generate --selection category=value がその回答から最終的なプロンプトを組み立てます。対話形式の nodaro prompt wizard には、ターミナルが必要です。

1 か月分の使用状況を書き出す

組織機能のあるインスタンスでは、メンバーごとの使用状況レポートを CSV ファイルに書き出せます。

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

ワークスペースと組織を参照してください。

よくある質問

最終更新

目次