Pular para o conteúdo principal

Executando OpenHands

Requisitos do Sistema

É recomendado um sistema com um processador moderno e um mínimo de 4GB de RAM para executar o OpenHands.

Pré-requisitos

MacOS

Docker Desktop

  1. Instale o Docker Desktop no Mac.
  2. Abra o Docker Desktop, vá em Settings > Advanced e certifique-se de que Allow the default Docker socket to be used esteja habilitado.
Linux
nota

Testado com Ubuntu 22.04.

Docker Desktop

  1. Instale o Docker Desktop no Linux.
Windows

WSL

  1. Instale o WSL.
  2. Execute wsl --version no powershell e confirme Default Version: 2.

Docker Desktop

  1. Instale o Docker Desktop no Windows.
  2. Abra o Docker Desktop, vá em Settings e confirme o seguinte:
  • General: Use the WSL 2 based engine está habilitado.
  • Resources > WSL Integration: Enable integration with my default WSL distro está habilitado.
nota

O comando docker abaixo para iniciar o aplicativo deve ser executado dentro do terminal WSL.

Inicie o Aplicativo

A maneira mais fácil de executar o OpenHands é no Docker.

docker pull docker.all-hands.dev/all-hands-ai/runtime:0.30-nikolaik

docker run -it --rm --pull=always \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.30-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.30

Você encontrará o OpenHands em execução em http://localhost:3000!

Você também pode conectar o OpenHands ao seu sistema de arquivos local, executar o OpenHands em um modo headless programável, interagir com ele através de uma CLI amigável, ou executá-lo em issues marcadas com uma ação do GitHub.

Configuração

Ao iniciar o OpenHands, você verá uma página de Configurações. Você deve selecionar um LLM Provider e LLM Model e inserir uma API Key correspondente. Estes podem ser alterados a qualquer momento selecionando o botão Settings (ícone de engrenagem) na interface do usuário.

Se o modelo necessário não existir na lista, você pode ativar as opções Advanced e inseri-lo manualmente com o prefixo correto na caixa de texto Custom Model. As opções Advanced também permitem que você especifique uma Base URL, se necessário.

Agora você está pronto para começar com o OpenHands.

Versões

O comando docker acima baixa a versão estável mais recente do OpenHands. Você também tem outras opções:

  • Para uma versão específica, substitua $VERSION em openhands:$VERSION e runtime:$VERSION, com o número da versão. Usamos SemVer, então 0.9 apontará automaticamente para a versão mais recente 0.9.x, e 0 apontará para a versão mais recente 0.x.x.
  • Para a versão de desenvolvimento mais atualizada, substitua $VERSION em openhands:$VERSION e runtime:$VERSION, por main. Esta versão é instável e é recomendada apenas para fins de teste ou desenvolvimento.

Você pode escolher a tag que melhor se adapta às suas necessidades com base nos requisitos de estabilidade e recursos desejados.

Para o fluxo de trabalho de desenvolvimento, consulte Development.md.

Está tendo problemas? Confira nosso Guia de Solução de Problemas.