# Prerequisites and installation

> Prerequisites and installation - System requirements, required tools and versions, and how to
> install and run DataRobot Agent Assist (plugin or standalone).

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-07-30T11:40:01.224682+00:00` (UTC).

## Primary page

- [Prerequisites and installation](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/installation.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [システム要件](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/installation.html.md#system-requirements): In-page section heading.
- [Prerequisite tools](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/installation.html.md#prerequisite-tools): In-page section heading.
- [Install and run DataRobot Agent Assist](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/installation.html.md#install-and-run-agent-assist): In-page section heading.
- [Set configuration variables](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/installation.html.md#set-configuration-variables): In-page section heading.
- [Startup behavior](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/installation.html.md#startup-behavior): In-page section heading.

## Documentation content

This page covers system requirements, prerequisite tools, installation, and configuration for DataRobot Agent Assist.

## システム要件

Ensure your system meets the minimum requirements for running DataRobot Agent Assist.

- Operating system: macOS or Linux (Windows requires WSL or another supported environment)
- Python: 3.10 or higher

> [!WARNING] オペレーティングシステムの互換性
> This repository is only compatible with macOS and Linux. On Windows, use a [DataRobot codespace](https://docs.datarobot.com/ja/docs/workbench/wb-notebook/codespaces/index.html.md), [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install), or a virtual machine running a supported OS.

## Prerequisite tools

At startup, DataRobot Agent Assist runs a dependency check via the DataRobot CLI and a `.datarobot/cli/versions.yaml` file. The following tools must be installed at the versions indicated.

> [!TIP] ツールをシステム全体にインストールする
> Install tools system-wide so they are available in all terminal sessions and when the DR CLI runs `dr dependencies check`.

| ツール | バージョン | 説明 | インストール |
| --- | --- | --- | --- |
| dr-cli | >= 0.2.5 | DataRobot CLI。 | dr-cli installation |
| git | >= 2.30.0 | Version control. | git installation |
| uv | >= 0.9.0 | Python package manager. | uv installation |
| Pulumi | >= 3.163.0 | Infrastructure as Code. | Pulumi installation |
| Taskfile | >= 3.43.3 | Task runner. | Taskfile installation |
| Node.js | >= 24 | JavaScript runtime (for example, for template frontend). | Node.js installation |

> [!TIP] macOS installation
> On macOS, several tools can be installed at once:
> 
> ```
> brew install datarobot-oss/taps/dr-cli uv pulumi/tap/pulumi go-task node git python 
> ```

## Install and run DataRobot Agent Assist

DataRobot Agent Assist can be run as a DataRobot CLI plugin. Install the plugin so that `dr assist` is available wherever the DataRobot CLI is installed. The plugin is discovered when the `dr-assist` executable is on the `PATH` and responds to `--dr-plugin-manifest`.

For the plugin published to the CLI plugin index, run:

```
dr plugin install assist 
```

To verify the installation, run the following commands:

```
dr plugin list              # Should show "assist" when installed as plugin
dr assist --help            # Show commands 
```

`dr assist` を初めて実行すると、DataRobot環境を選択するよう求められます。 使用したいDataRobotインスタンスに対応する環境を選択します。

```
# Output: DataRobot URL configuration
dr assist --help                                                           
🔌 Running plugin: assist
WARN  No DataRobot URL configured. Running auth setup...
🌐 DataRobot URL Configuration

Choose your DataRobot environment:

┌────────────────────────────────────────────────────────┐
│  [1] 🇺🇸 US Cloud        https://app.datarobot.com      │
│  [2] 🇪🇺 EU Cloud        https://app.eu.datarobot.com   │
│  [3] 🇯🇵 Japan Cloud     https://app.jp.datarobot.com   │
│      🏢 Custom          Enter your custom URL          │
└────────────────────────────────────────────────────────┘

🔗 Don't know which one? Check your DataRobot login page URL in your browser.

Enter your choice: 
```

APIキーが指定されていない場合、認証フローによってブラウザーウィンドウでDataRobotアプリケーションが開きます。 アクセスリクエスト：DataRobot CLI ダイアログボックスで、セッションの継続時間を設定し、 続行する をクリックします。

> [!WARNING] 空のディレクトリでdr assistを実行する
> `dr assist` は、 専用の空のディレクトリ からのみ実行します。 コードやその他のファイルが含まれるディレクトリでこのコマンドを実行するのは安全ではありません。 エージェントアシストのコーディングワークフローを使用すると、アシスタントはDataRobot Agent Application Templateのクローンを現在のディレクトリに作成します。 この操作によって既存のファイルが上書きされたり競合が発生したりする可能性があり、既存のプロジェクトが損なわれ、アシスタントの出力精度が低下する恐れがあります。 `dr assist` を実行する前に、専用のディレクトリがない場合は、ディレクトリを作成してそこでターミナルを開きます（たとえば、 `mkdir my-agent && cd my-agent` を実行してから、 `dr assist` を実行します）。

## Set configuration variables

If necessary, set the following variables in the environment, in `.env`, or in the configuration files. In many cases, this configuration is handled by [the DataRobot CLI](https://docs.datarobot.com/ja/docs/agentic-ai/cli/commands/auth.html.md) through `dr auth login`.

| 特徴量 | 必須 | 説明 | Default / notes |
| --- | --- | --- | --- |
| DATAROBOT_API_TOKEN | Yes (unless provided by DR CLI configuration) | LLM Gateway（デフォルトプロバイダー）用DataRobot APIキー。 | — |
| DATAROBOT_ENDPOINT | いいえ | DataRobot API endpoint. | https://app.datarobot.com/api/v2 |

For the full list of variables (including LLM overrides, logging, and config path overrides), see the [Environment and commands reference](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/env-and-commands-reference.html.md#environment-variables). Agent Assistによる `AGENT_ASSIST_LLM_MODEL_NAME` の解決方法、アシストモデルを制御 しない ファイル、および `dr assist` を再起動する必要がある場合の詳細については、 [LLMモデルの選択と変更](https://docs.datarobot.com/ja/docs/agentic-ai/agent-assist/env-and-commands-reference.html.md#change-the-agent-assist-llm) を参照してください。

??? + "Configuration variable priority"
    DataRobot Agent Assist reads configuration from multiple sources; to do this, it looks for credentials and settings in this order:

```
1. **環境変数**：`DATAROBOT_API_TOKEN`、`DATAROBOT_ENDPOINT`、および`AGENT_ASSIST_LLM_MODEL_NAME`などのLLM関連の変数
2. **.envファイル**：*現在の作業ディレクトリ*（`dr assist`を実行する場所）。上記と同じ変数名
3. **DR CLI configuration**: `~/.config/datarobot/drconfig.yaml` (token and endpoint). Override path with `DATAROBOT_CLI_CONFIG`
4. **Agent Assistの設定**：`~/.config/datarobot/agent_assist_config.yaml`（オプションのLLM URL、モデル、APIキー）。 Override path with `AGENT_ASSIST_CONFIG`

**`~/.config/datarobot/agent_assist/settings.yaml`**は別のファイルです。これにはCLIの言語などの設定が保存され、**`AGENT_ASSIST_LLM_MODEL_NAME`**は設定されません。 そのファイルを参考にしてアシストLLMを選択しないでください。

For the format and behavior of the DataRobot CLI configuration file (`drconfig.yaml`), including token and endpoint, see the [DataRobot CLI documentation](../cli/configuration.md){ target=_blank }.
```

## Startup behavior

Before the chat session starts, DataRobot Agent Assist:

1. Verifies the DataRobot CLI is available and runs dr dependencies check (using .datarobot/cli/versions.yaml if present).
2. Checks authentication and can run dr auth login if needed.
3. Ensures DATAROBOT_API_TOKEN (or equivalent from configuration) is set; if not, it displays an error and exits.