CLI

Nodaro CLI(@nodaro/cli)는 Nodaro용 명령줄 클라이언트입니다. 워크플로 목록을 보고 실행하며, 게시된 앱을 실행하고, 워크플로 없이 단일 노드를 실행하고, 각 실행이 끝날 때까지 따라갑니다. 로그인한 프로필 여러 개를 나란히 유지하고 스크립트용 JSON을 출력하므로 터미널 작업, cron 작업, CI 파이프라인에 잘 맞습니다.

CLI는 TypeScript SDK를 얇게 감싼 것입니다. 코드로 작성하는 연동에는 SDK를 직접 사용하세요.

설치

npm install -g @nodaro/cli
nodaro --version

npx @nodaro/cli projects list

# 1. The newest CLI version
NODARO_CLI_VERSION=$(curl -fsSL "https://api.github.com/repos/nodaroai/app.nodaro.ai/git/matching-refs/tags/cli-v?per_page=100" \
  | grep -o '"refs/tags/cli-v[0-9][0-9.]*"' | tr -d '"' | sed 's#refs/tags/cli-v##' \
  | sort -t. -k1,1n -k2,2n -k3,3n | tail -n 1)
echo "Installing @nodaro/cli $NODARO_CLI_VERSION"

# 2. Your platform: darwin-arm64 (Apple silicon), darwin-x64 (Intel Mac), linux-x64 or linux-arm64
NODARO_CLI_PLATFORM=darwin-arm64

# 3. Download. -f fails on an HTTP error instead of saving the error page as the binary.
curl -fL "https://github.com/nodaroai/app.nodaro.ai/releases/download/cli-v$NODARO_CLI_VERSION/nodaro-$NODARO_CLI_PLATFORM" \
  -o /usr/local/bin/nodaro && chmod +x /usr/local/bin/nodaro
nodaro --version

$v = (Invoke-RestMethod "https://api.github.com/repos/nodaroai/app.nodaro.ai/git/matching-refs/tags/cli-v?per_page=100") |
  ForEach-Object { $_.ref -replace '^refs/tags/cli-v', '' } |
  Where-Object { $_ -match '^\d+\.\d+\.\d+$' } |
  Sort-Object { [version]$_ } | Select-Object -Last 1
Invoke-WebRequest "https://github.com/nodaroai/app.nodaro.ai/releases/download/cli-v$v/nodaro-windows-x64.exe" -OutFile nodaro.exe
.\nodaro.exe --version

버전을 고정하려면 첫 번째 단계를 건너뛰고 버전을 직접 지정하세요. 모든 CLI 릴리스와 바이너리는 공개 저장소의 cli-v 릴리스에 나와 있습니다.

로그인

CLI는 개인 API 토큰으로 인증하며, 토큰을 프로필에 저장합니다.

브라우저 흐름이 실패하면 CLI는 대신 토큰을 붙여 넣으라고 요청합니다. 토큰을 직접 만들려면 Nodaro에서 설정 › API 토큰을 열고 토큰 만들기를 클릭하세요. 전체 토큰은 한 번만 표시됩니다. 개인 API 토큰은 Nodaro Cloud와 Business 에디션 설치에서 쓸 수 있습니다. 토큰이 작동하는 방식은 인증에서 확인하세요.

nodaro auth login                                   # browser sign-in
nodaro auth login --no-browser                      # paste a token instead
nodaro auth login --token "$NODARO_TOKEN"           # non-interactive, for CI
nodaro auth status [--profile <name>] [--json]      # show a profile, token masked
nodaro auth logout [--profile <name>]               # delete a saved profile

CLI는 프로필을 ~/.config/nodaro/config.json에 저장하며, 이 파일은 내 사용자만 읽을 수 있습니다(파일 모드 0600). 파일을 다른 폴더에 두려면 NODARO_CONFIG_DIR을 설정하세요.

여러 인스턴스에 프로필 사용

프로필은 저장된 인스턴스 주소와 토큰입니다. Nodaro Cloud, 스테이징 설치, 로컬 설치처럼 인스턴스마다 프로필을 하나씩 만드세요. 그런 다음 모든 명령이 받는 --profile로 하나를 고르세요.

nodaro auth login --profile prod    --base-url https://app.nodaro.ai
nodaro auth login --profile staging --base-url https://staging.example.com
nodaro auth login --profile local   --base-url http://localhost:3000

nodaro projects list --profile staging

--profile이 없는 명령은 기본 프로필을 씁니다. 프로필을 저장하기 전까지 기본값은 production이며, 처음 저장한 프로필이 기본 프로필이 됩니다. 그래서 대부분은 플래그 없이 nodaro auth login을 한 번 실행하는 것으로 충분합니다.

워크스페이스 선택

조직이 있는 인스턴스에서는 작업이 워크스페이스에 있습니다. 명령 하나에는 --workspace <id>로, 셸이나 CI 작업에는 NODARO_WORKSPACE로 워크스페이스를 고르거나, nodaro workspace use <id>로 프로필에 저장하세요. 아무것도 설정하지 않으면 개인 공간에서 작업합니다. 워크스페이스와 조직을 참고하세요.

실행하는 세 가지 방법

CLI는 Nodaro가 작업을 실행하는 세 가지 방법을 모두 다룹니다. 만든 것에 맞는 방법을 고르세요.

nodaro nodes run은 generate_image, generate_video 같은 MCP 서버의 동사형 도구에 해당하는 CLI 명령입니다. 모든 생성 노드는 POST /v1/<type>에서 응답하므로, nodaro nodes list에 나오는 노드는 모두 nodaro nodes run으로 실행할 수 있습니다. REST 쪽은 단일 노드 실행을 참고하세요.

실행이 끝날 때까지 기다리려면 --watch를 추가하세요.

nodaro nodes run generate-image \
  --param prompt="a snow leopard on a mountain ridge, cinematic" \
  --param provider=flux \
  --watch

--param 문법은 매개변수와 입력 파일에서 확인하고, CLI로 스크립트를 짜기 전에 출력과 종료 코드를 읽어 보세요.

CLI가 다루지 않는 것

CLI는 크레딧, 개발자 앱, OAuth, 파이프라인, Reduce, 업로드 도우미를 다루지 않습니다. 이런 기능에는 SDK나 REST API를 사용하세요.

CLI에서 코드로 옮겨 가는 것은 간단합니다. 다음은 nodaro workflows run wf_abc에 해당하는 SDK 코드입니다.

import { createClient, StaticTokenAuth } from "@nodaro/sdk"

const nodaro = createClient({
  baseUrl: "https://app.nodaro.ai",
  auth: new StaticTokenAuth(process.env.NODARO_TOKEN!),
})

const run = await nodaro.workflows.run("wf_abc")

다음 단계