דוגמאות

הדוגמאות ל-CLI של Nodaro הן מתכונים קצרים לעבודות נפוצות: הרצות מתוזמנות, שלבי CI שתלויים בהרצה, יצירה בסקריפט, כתוביות מתוך תמלול ושיפור פרומפטים. כל דוגמה מניחה שהתקנתם את ה-CLI והתחברתם, ורובן משתמשות ב-jq כדי לקרוא את פלט ה-JSON.

הרצת תהליך כל לילה עם cron

רשומת ה-cron הזו מתחילה הרצה של תהליך כל לילה ב-03:00, ומוסיפה לסוף קובץ יומן את השדות executionId ו-status של ההרצה שהתחילה, בפורמט 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

שאר קודי היציאה מופיעים בדף פלט וקודי יציאה.

יצירת תמונה בפקודה אחת

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'

הפקודה מדפיסה רק את הכתובת של התמונה, וכך אפשר להעביר אותה ישירות לשלב הבא בסקריפט.

כתוביות לסרטון מתוך התמלול שלו

תמללו רצועת אודיו עם תזמון לכל מילה, ואז צרבו את המילים בסרטון ככתוביות מונפשות.

# 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

• אפשר לתקן את השדה text של מילה ב-words.json בין שלב 2 לשלב 3, והסרטון יציג את המילה המתוקנת.
• לקריאה מהירה, שתי מילים בכל פעם, הוסיפו לשלב 3 את --max-words-per-line 2.
• שלב 1 דורש מנוע שמחזיר תזמון לכל מילה: המנוע elevenlabs-stt, או incredibly-fast-whisper עם --word-timestamps. המנוע 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 כותבת פרומפט מחדש בשלב אחד. העבירו את התוצאה שלה ישירות להרצה של רכיב:

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

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

כדי להשתמש בסקריפט בשאלות המנחות של האשף, עבדו בשני שלבים: הפקודה nodaro prompt analyze --json מחזירה את השאלות, והפקודה nodaro prompt generate --selection category=value בונה את הפרומפט הסופי מהתשובות שלכם. הפקודה האינטראקטיבית nodaro prompt wizard דורשת טרמינל.

ייצוא השימוש של חודש

במופע עם ארגונים, כתבו לקובץ CSV דוח שימוש לפי חבר בארגון:

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

ראו את הדף סביבות עבודה וארגונים.