OpenHands

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

前提条件

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

SambaCloud アカウントと API キー
OpenHands Cloud へのアクセス、またはセルフホストの OpenHands インスタンス

Agent Canvas を使用する場合は、Node.js 22.12 以上と uv も必要です。

セットアップ

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

OpenHands で LLM 設定を開く

OpenHands にログインし、Settings に移動します。Language Model (LLM) セクションを開き、Advanced をクリックしてカスタムモデルの設定フィールドを表示します。

SambaNova をカスタムモデルとして追加

sambanova/ プレフィックスを付けて SambaNova モデルを入力します。例:

sambanova/MiniMax-M3

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

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

設定が完了したら Save Changes をクリックします。

(任意) 組織の LLM プロファイルを作成

OpenHands Cloud の組織管理者であれば、SambaNova をチームのデフォルトモデルとして設定できます。Settings → LLM Profiles に移動し、ステップ 2 と同じ以下の項目を使って新しいプロファイルを作成します。

Custom Model
Base URL
API Key

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

(任意) 組織全体のデフォルト 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 設定を使用します。

SambaNova モデルの利用開始

OpenHands で新しい会話を作成し、次のようなソフトウェアエンジニアリングタスクを割り当てます。

Find and fix the bug in my Python script
Write unit tests for this function
Refactor this code to use async/await

プロンプト例の日本語訳

Python スクリプトのバグを見つけて修正して
この関数のユニットテストを書いて
このコードを async/await を使うようにリファクタリングして

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

セルフホストと Docker の設定

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

docker run -d \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e LLM_MODEL="sambanova/MiniMax-M3" \
  -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 を実行します。

latest の代わりに特定のバージョンを固定するには、OpenHands リリースページで現在の安定版タグを確認してください (例: 1.8.0)。

Agent Canvas

Agent Canvas は、npm または Docker でインストールできる OpenHands 用の軽量ローカルランナーです。 npm でインストール (Node.js 22.12 以上と uv が必要です。Agent Canvas は内部で Python ランタイムを使用しており、uv によって管理されます)。

npm install -g @openhands/agent-canvas
agent-canvas

または Docker で実行します。

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-M3)
Base URL: https://api.sambanova.ai/v1
API Key: お使いの SambaNova API キー

参考情報

OpenHands ドキュメント: セットアップ、設定、エージェントの利用に関する完全なリファレンス
Agent Canvas: npm または Docker で利用できる OpenHands 用の軽量ローカルランナー
SambaCloud 対応モデル: SambaNova で利用可能なモデルの一覧

概要

開発者ツール

フレームワーク

インターフェースとローコード

データとインフラ

マルチモーダル

評価とモニタリング

前提条件

セットアップ

セルフホストと Docker の設定

Agent Canvas

参考情報

​前提条件

​セットアップ

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

​Agent Canvas

​参考情報

前提条件

セットアップ

セルフホストと Docker の設定

Agent Canvas

参考情報