CLI のインストールとセットアップ

Roboflow CLI をインストールし、認証し、デフォルトのワークスペースを設定し、シェル補完を有効にします。

必要になります Python >=3.10 RoboflowのPythonパッケージを使用するために。

Python をインストールしたら、次のコマンドを実行してインストールしてください:

pip install roboflow

インストール後、CLI が動作することをテストします:

roboflow --help

認証

認証する方法は3つあります:

オプション1: 環境変数（スクリプトやエージェントに推奨）

export ROBOFLOW_API_KEY=rf_xxxxx

これは、CI/CD、自動化、AI コーディングエージェントに推奨される方法です。対話的なプロンプトは不要です。

オプション2: APIキー フラグ

roboflow --api-key rf_xxxxx project list

任意のコマンドにキーを直接渡します。一度きりのコマンドに便利です。

オプション3: 対話形式のログイン

roboflow login

ブラウザでリンクを開き、トークンを取得して、ターミナルに貼り付けます。認証情報は次に保存されます ~/.config/roboflow/config.json そのため、この操作は一度だけで済みます。

また、次の方法で非対話的にログインすることもできます:

roboflow auth login --api-key rf_xxxxx

認証を確認

roboflow auth status

これにより、現在のワークスペースとマスクされたAPIキーが表示されます。

デフォルトのワークスペースを設定

複数のワークスペースにアクセスできる場合、既定で使用するものを設定します:

roboflow auth set-workspace my-workspace-id

シェル補完（オプション）

コマンド、オプション、引数のタブ補完を有効にします:

# Zsh
eval "$(roboflow completion zsh)"

# Bash（bash >= 4.4 が必要）
eval "$(roboflow completion bash)"

# Fish
roboflow completion fish | source

永続化するには、 eval の行をシェルのプロファイル（~/.zshrc, ~/.bashrcなど）に追加してください。