OpenHandsの実行
システム要件
- Docker DesktopをサポートするMacOS
- Linux
- WSLとDocker DesktopをサポートするWindows
OpenHandsを実行するには、最新のプロセッサと最低4GB RAMを搭載したシステムが推奨されます。
前提条件
MacOS
Docker Desktop
- MacにDocker Desktopをインストールします。
- Docker Desktopを開き、
設定 > 詳細設定
に移動して、デフォルトのDockerソケットの使用を許可する
が有効になっていることを確認します。
Linux
Windows
WSL
- WSLをインストールします。
- PowerShellで
wsl --version
を実行し、Default Version: 2
であることを確認します。
Docker Desktop
- WindowsにDocker Desktopをインストールします。
- Docker Desktopを開き、
設定
で以下を確認します:
- 一般:
WSL 2ベースのエンジンを使用する
が有効になっている。 - リソース > WSL統合:
デフォルトのWSLディストリビューションとの統合を有効にする
が有効になっている。
アプリを起動するための以下のdockerコマンドは、WSLターミナル内で実行する必要があります。
アプリの起動
OpenHandsを実行する最も簡単な方法はDockerを使用することです。
docker pull docker.all-hands.dev/all-hands-ai/runtime:0.37-nikolaik
docker run -it --rm --pull=always \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.37-nikolaik \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.openhands-state:/.openhands-state \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-app \
docker.all-hands.dev/all-hands-ai/openhands:0.37
OpenHandsは http://localhost:3000 で実行されています!
また、OpenHandsをローカルファイルシステムに接続したり、 OpenHandsをヘッドレスモードでスクリプト実行したり、 使いやすいCLIを介して操作したり、 GitHubアクションでタグ付けされた課題に対して実行したりすることもできます。
セットアップ
OpenHandsを起動した後、LLMプロバイダー
とLLMモデル
を選択し、対応するAPIキー
を入力する必要があります。
これは、初期設定ポップアップ時に行うか、UIの設定
ボタン(歯車アイコン)を選択して行うことができます。
必要なモデルがリストに存在しない場合は、詳細設定
をトグルして、正しいプレフィックスを付けて
カスタムモデル
テキストボックスに手動で入力することができます。
詳細設定
では、必要に応じてベースURL
を指定することもできます。
APIキーの取得
OpenHandsはほとんどの言語モデルにアクセスするためにAPIキーが必要です。推奨プロバイダーからAPIキーを取得する方法は次のとおりです:
Anthropic (Claude)
- Anthropicアカウントを作成します。
- APIキーを生成します。
- 課金を設定します。
コストを管理するために使用制限を設定することを検討してください。
OpenAI
- OpenAIアカウントを作成します。
- APIキーを生成します。
- 課金を設定します。
これでOpenHandsを使い始める準備ができました。
バージョン
上記のdockerコマンドは、OpenHandsの最新の安定版リリースを取得します。他のオプションもあります:
- 特定のリリースの場合、
openhands:$VERSION
とruntime:$VERSION
の$VERSIONをバージョン番号に置き換えます。 SemVerを使用しているため、0.9
は自動的に最新の0.9.x
リリースを指し、0
は最新の0.x.x
リリースを指します。 - 最新の開発バージョンの場合、
openhands:$VERSION
とruntime:$VERSION
の$VERSIONをmain
に置き換えます。 このバージョンは不安定であり、テストまたは開発目的でのみ推奨されます。
開発ワークフローについては、Development.mdを参照してください。
問題がありますか?トラブルシューティングガイドをご確認ください。