Executando OpenHands
Requisitos do Sistema
- MacOS com suporte ao Docker Desktop
- Linux
- Windows com WSL e suporte ao Docker Desktop
É recomendado um sistema com um processador moderno e um mínimo de 4GB de RAM para executar o OpenHands.
Pré-requisitos
MacOS
Docker Desktop
- Instale o Docker Desktop no Mac.
- Abra o Docker Desktop, vá em
Settings > Advanced
e certifique-se de queAllow the default Docker socket to be used
esteja habilitado.
Linux
Windows
WSL
- Instale o WSL.
- Execute
wsl --version
no powershell e confirmeDefault Version: 2
.
Docker Desktop
- Instale o Docker Desktop no Windows.
- 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.
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
eruntime:$VERSION
, com o número da versão. Usamos SemVer, então0.9
apontará automaticamente para a versão mais recente0.9.x
, e0
apontará para a versão mais recente0.x.x
. - Para a versão de desenvolvimento mais atualizada, substitua $VERSION em
openhands:$VERSION
eruntime:$VERSION
, pormain
. 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.