Skip to content

インストール

The DataRobot Agentic Application Template repository provides a ready-to-use application template for building and deploying agentic workflows with multi-agent frameworks, a FastAPI backend server, a React frontend, and an MCP server. The template streamlines the process of setting up new agentic applications with minimal configuration requirements and supports local development and testing, as well as one-command deployments to production environments within DataRobot.

Review the following sections to install the prerequisite tools and configure your environment.

システム要件

Ensure your system meets the minimum requirements for running DataRobot Agentic Application Template.

  • オペレーティングシステム:macOSまたはLinux(Windows はサポートされていません)
  • Python:バージョン3.10以上

オペレーティングシステムの互換性

このリポジトリは、macOSおよびLinuxオペレーティングシステムとのみ互換性があります。 If you are using Windows, consider using a DataRobot codespace, Windows Subsystem for Linux (WSL), or a virtual machine running a supported OS.

Install prerequisite tools

Before you begin, you'll need the following tools installed. If you already have these tools installed, ensure that they are at the required version (or newer) indicated in the table below. For example commands to install the tools, see the Detailed installation commands section.

Install tools system-wide

Make sure to install the tools system-wide rather than in a virtual environment so they are available in your terminal sessions.

ツール バージョン 説明 Installation guide
dr-cli >= 0.2.28 The DataRobot CLI. dr-cli installation guide
git >= 2.30.0 バージョン管理システム。 git installation guide
uv >= 0.9.0 A Python package manager. uv installation guide
Pulumi >= 3.163.0 An Infrastructure as Code tool. Pulumi installation guide
Taskfile >= 3.43.3 A task runner. Taskfile installation guide
NodeJS >= 24 JavaScript runtime for frontend development. NodeJS installation guide

Detailed installation commands

The following sections provide example installation commands for macOS and Linux (Debian/Ubuntu/DataRobot codespace). Click the tab below that corresponds to your operating system:

macOS users can install the prerequisite tools using Homebrew. First, install Homebrew if you don't already have it.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # If homebrew is not already installed 

Then, install the prerequisite tools with it:

brew install datarobot-oss/taps/dr-cli uv pulumi/tap/pulumi go-task node git 

Linux users can install the prerequisite tools using the package manager for their distribution.

curl https://cli.datarobot.com/install | sh
sudo apt-get update
sudo apt-get install -y python3 python3-pip python3-venv
sudo apt-get install -y git
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://get.pulumi.com | sh
sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d
sudo apt-get install -y nodejs npm 

Local Pulumi login

If you do not have a Pulumi account, use pulumi login --local for local login or create a free account at the Pulumi website.

制限のあるネットワークの設定

インターネットに直接アクセスできない環境(エアギャップ環境)では、GitHubではなく内部プロキシからDataRobotプラグインをインストールするようにPulumiを設定します。 これらの環境変数を設定すると、すべてのPulumiプラグインのダウンロードが内部プロキシにリダイレクトされ、外部の更新チェックが無効になります。

以下の変数を.envファイルに追加します。

.env
PULUMI_SKIP_UPDATE_CHECK=1
PULUMI_DATAROBOT_DEFAULT_URL=http://internal-proxy-for-pulumi
# OPTIONAL
PULUMI_DATAROBOT_PLUGIN_VERSION=v0.10.27 
環境変数 必須 説明
PULUMI_SKIP_UPDATE_CHECK はい 1に設定すると、エアギャップモードが有効になります。 これにより、外部の更新チェックが無効になり、カスタムプラグインサーバーの使用が可能になります。
PULUMI_DATAROBOT_DEFAULT_URL はい DataRobot Pulumiプラグインをホストする内部プロキシサーバーのベースURL。 これにより、デフォルトのGitHubリリースソースが置き換えられます。
PULUMI_DATAROBOT_PLUGIN_VERSION いいえ インストールするDataRobot Pulumiプラグインの特定のバージョン。 指定しない場合、テンプレートにバンドルされているバージョンがデフォルトとなります。

仕組み

PULUMI_SKIP_UPDATE_CHECK=1が設定されている場合、デプロイタスクはpulumi plugin install resource datarobot <version> --server <url>を実行します。 これにより、プラグインのダウンロードが外部ソースではなく内部プロキシ経由でルーティングされるようになります。

内部プロキシの要件

内部プロキシは、Pulumiのプラグインインストールと互換性のある構造でDataRobot Pulumiプラグインファイルをホストする必要があります。 GitHubの公式リリースのディレクトリおよびファイルの構造を反映したものでなければなりません。

Pythonパッケージ

制限のあるネットワーク環境では、パブリックPyPIにアクセスしようとすると、uv sync操作が失敗します。 これを解決するには、uvが内部のPyPIプロキシを使うように設定します。

プロキシを設定するには、エージェントプロジェクトのagent/pyproject.tomlファイルを編集し、[tool.uv.pip]セクションのコメントを解除して、URLを内部PyPIプロキシに置き換えます。 例:

agent/pyproject.toml
[tool.uv.pip]
extra-index-url = ["https://your-internal-pypi-proxy.example.com/simple/"] 

設定による影響

この設定を行うと、すべてのPythonパッケージのインストールがプロキシ経由でルーティングされます。 対象となるのは以下の操作です。

  • ローカル開発(uv sync
  • Dockerイメージのビルド
  • カスタムモデルのデプロイ
  • プレイグラウンドの操作
  • インフラストラクチャのデプロイ

設定を見つける

[tool.uv.pip]セクションはpyproject.tomlファイルの最後にあります。 存在しない場合は、手動で追加します。