> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenHands

[OpenHands](https://www.openhands.dev/) は、ソフトウェア開発向けのオープンソースかつモデル非依存の AI エージェントプラットフォームで、コードベース全体にわたる実際のエンジニアリング作業をエンドツーエンドで実行します。以下の手順に従って、OpenHands を SambaCloud でホストされているモデルに接続してください。

## 前提条件

作業を始める前に、以下の環境を準備してください。

* [SambaCloud](https://cloud.sambanova.ai/?utm_source=openhands\&utm_medium=external\&utm_campaign=cloud_signup) アカウントと [API キー](https://cloud.sambanova.ai/apis?utm_source=openhands\&utm_medium=external\&utm_campaign=cloud_signup)
* [OpenHands Cloud](https://app.all-hands.dev) へのアクセス、またはセルフホストの OpenHands インスタンス

Agent Canvas を使用する場合は、Node.js 22.12 以降と [`uv`](https://docs.astral.sh/uv/getting-started/installation/) も必要です。

## セットアップ

以下の手順に従って、設定パネルから OpenHands を SambaNova モデルに接続します。

<Steps>
  <Step title="OpenHands で LLM 設定を開く">
    OpenHands にログインし、**Settings** に移動します。

    **Language Model (LLM)** セクションを開き、**Advanced** をクリックしてカスタムモデルの設定フィールドを表示します。
  </Step>

  <Step title="SambaNova をカスタムモデルとして追加">
    `sambanova/` プレフィックスを付けて SambaNova モデルを入力します。

    例:

    ```text theme={}
    sambanova/MiniMax-M2.7
    ```

    以下の設定を確認します。

    * **Custom Model**: `sambanova/<model-name>`
    * **Base URL**: `https://api.sambanova.ai/v1`
    * **API Key**: お使いの SambaNova API キー

    設定が完了したら **Save Changes** をクリックします。
  </Step>

  <Step title="(任意) 組織の LLM プロファイルを作成">
    OpenHands Cloud の組織管理者であれば、SambaNova をチームのデフォルトモデルとして設定できます。

    **Settings → LLM Profiles** に移動し、同じ以下の項目を使って新しいプロファイルを作成します。

    * **Custom Model**
    * **Base URL**
    * **API Key**

    そのプロファイルを組織のデフォルトとして設定します。必要に応じて、チームメンバーは個人の設定でこの設定を上書きできます。
  </Step>

  <Step title="(任意) 組織全体のデフォルト LLM を設定">
    OpenHands Cloud の組織管理者であれば、SambaNova をチームのデフォルトモデルとして設定できます。

    左下のプロフィールアイコンにカーソルを合わせ、**Organization** を選択し、続いて **LLM** タブを選択します。ステップ 2 と同じ値を設定します。

    * **Custom Model**: `sambanova/<model-name>`
    * **Base URL**: `https://api.sambanova.ai/v1`
    * **API Key**: お使いの SambaNova API キー

    **Save Changes** をクリックします。個人の設定で上書きしない限り、組織のすべてのメンバーがこの LLM 設定を使用します。
  </Step>

  <Step title="SambaNova モデルの利用開始">
    OpenHands で新しい会話を作成し、次のようなソフトウェアエンジニアリングタスクを割り当てます。

    * *Find and fix the bug in my Python script* (Python スクリプトのバグを見つけて修正して)
    * *Write unit tests for this function* (この関数のユニットテストを書いて)
    * *Refactor this code to use async/await* (このコードを async/await を使うようにリファクタリングして)

    OpenHands は、選択した SambaNova モデルを使用して、計画の立案、コードの作成、コマンドの実行、ソリューションの改善を繰り返し行います。
  </Step>
</Steps>

## セルフホストと Docker の設定

OpenHands を Docker で実行している場合は、環境変数を使用して SambaNova を設定します。

```bash theme={}
docker run -d \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e LLM_MODEL="sambanova/MiniMax-M2.7" \
  -e LLM_BASE_URL="https://api.sambanova.ai/v1" \
  -e LLM_API_KEY="<your-sambanova-api-key>" \
  --name openhands \
  docker.all-hands.dev/all-hands-ai/openhands:latest
```

ブラウザで `http://localhost:3000` を開くと、OpenHands のインターフェースにアクセスできます。ログを確認するには、`docker logs openhands` を実行します。

<Note>
  `latest` の代わりに特定のバージョンを固定するには、[OpenHands リリースページ](https://github.com/All-Hands-AI/OpenHands/releases) で現在の安定版タグを確認してください (例: `1.8.0`)。
</Note>

## Agent Canvas

[Agent Canvas](https://docs.openhands.dev/openhands/usage/agent-canvas/setup) は、npm または Docker でインストールできる OpenHands 用の軽量ローカルランナーです。

**npm でインストール** (Node.js 22.12 以降と [`uv`](https://docs.astral.sh/uv/getting-started/installation/) が必要です。Agent Canvas は内部で Python ランタイムを使用しており、`uv` によって管理されます)。

```bash theme={}
npm install -g @openhands/agent-canvas
agent-canvas
```

**または Docker で実行します。**

```bash theme={}
mkdir -p ~/projects ~/.openhands

docker run -d \
  --name agent-canvas \
  -p 8000:8000 \
  -v ~/.openhands:/home/openhands/.openhands \
  -v ~/projects:/projects \
  ghcr.io/openhands/agent-canvas:latest
```

ブラウザで `http://localhost:8000` を開き、**Settings → LLM** に移動して SambaNova をプロバイダーとして設定します。

* **Custom Model**: `sambanova/<model-name>` (例: `sambanova/MiniMax-M2.7`)
* **Base URL**: `https://api.sambanova.ai/v1`
* **API Key**: お使いの SambaNova API キー

## 参考情報

* [OpenHands ドキュメント](https://docs.openhands.dev/overview/): セットアップ、設定、エージェントの利用に関する完全なリファレンス
* [Agent Canvas](https://docs.openhands.dev/openhands/usage/agent-canvas/setup): npm または Docker で利用できる OpenHands 用の軽量ローカルランナー
* [対応 SambaCloud モデル](/docs/ja/models/sambacloud-models): SambaNova で利用可能なモデルの一覧