メインコンテンツに直接移動

OpenHandsの実行

システム要件

OpenHandsを実行するには、最新のプロセッサと最低4GB RAMを搭載したシステムが推奨されます。

前提条件

MacOS

Docker Desktop

  1. MacにDocker Desktopをインストールします。
  2. Docker Desktopを開き、設定 > 詳細設定に移動して、デフォルトのDockerソケットの使用を許可するが有効になっていることを確認します。
Linux
メモ

Ubuntu 22.04でテスト済み。

Docker Desktop

  1. LinuxにDocker Desktopをインストールします。
Windows

WSL

  1. WSLをインストールします。
  2. PowerShellでwsl --versionを実行し、Default Version: 2であることを確認します。

Docker Desktop

  1. WindowsにDocker Desktopをインストールします。
  2. 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)

  1. Anthropicアカウントを作成します。
  2. APIキーを生成します。
  3. 課金を設定します。

コストを管理するために使用制限を設定することを検討してください。

OpenAI

  1. OpenAIアカウントを作成します。
  2. APIキーを生成します。
  3. 課金を設定します。

これでOpenHandsを使い始める準備ができました。

バージョン

上記のdockerコマンドは、OpenHandsの最新の安定版リリースを取得します。他のオプションもあります:

  • 特定のリリースの場合、openhands:$VERSIONruntime:$VERSIONの$VERSIONをバージョン番号に置き換えます。 SemVerを使用しているため、0.9は自動的に最新の0.9.xリリースを指し、0は最新の0.x.xリリースを指します。
  • 最新の開発バージョンの場合、openhands:$VERSIONruntime:$VERSIONの$VERSIONをmainに置き換えます。 このバージョンは不安定であり、テストまたは開発目的でのみ推奨されます。

開発ワークフローについては、Development.mdを参照してください。

問題がありますか?トラブルシューティングガイドをご確認ください。