OpenHands: Menos Código, Mais Criação

Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文

---

Bem-vindo ao OpenHands (anteriormente OpenDevin), uma plataforma para agentes de desenvolvimento de software alimentados por IA.

Os agentes OpenHands podem fazer tudo o que um desenvolvedor humano faz: modificar código, executar comandos, navegar na web, chamar APIs e sim — até copiar trechos de código do StackOverflow.

Saiba mais em docs.all-hands.dev ou cadastre-se no OpenHands Cloud para começar.

[!IMPORTANT] Usando o OpenHands para trabalho? Adoraríamos conversar! Preencha este breve formulário para participar do nosso programa Design Partner, onde você terá acesso antecipado a recursos comerciais e a oportunidade de contribuir com nosso roteiro de produtos.

☁️ OpenHands Cloud

A maneira mais fácil de começar com o OpenHands é através do OpenHands Cloud, que oferece US$ 50 em créditos gratuitos para novos usuários.

💻 Executando o OpenHands Localmente

O OpenHands também pode ser executado no seu sistema local usando Docker. Consulte o guia Executando o OpenHands para requisitos do sistema e mais informações.

[!WARNING] Em uma rede pública? Consulte nosso Guia de Instalação Docker Reforçada para proteger sua implantação restringindo o binding de rede e implementando medidas de segurança adicionais.

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

docker run -it --rm --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.44-nikolaik \
    -e LOG_ALL_EVENTS=true \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v ~/.openhands:/.openhands \
    -p 3000:3000 \
    --add-host host.docker.internal:host-gateway \
    --name openhands-app \
    docker.all-hands.dev/all-hands-ai/openhands:0.44

Observação: Se você usou o OpenHands antes da versão 0.44, pode ser necessário executar mv ~/.openhands-state ~/.openhands para migrar seu histórico de conversas para o novo local.

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

Ao abrir o aplicativo, você será solicitado a escolher um provedor de LLM e adicionar uma chave de API. O Claude Sonnet 4 da Anthropic (anthropic/claude-sonnet-4-20250514) funciona melhor, mas você tem muitas opções.

💡 Outras formas de executar o OpenHands

[!CAUTION] O OpenHands foi projetado para ser executado por um único usuário em sua estação de trabalho local. Não é adequado para implantações multi-inquilino onde vários usuários compartilham a mesma instância. Não há autenticação, isolamento ou escalabilidade integrados.

Se você estiver interessado em executar o OpenHands em um ambiente multi-inquilino, por favor entre em contato conosco para opções avançadas de implantação.

Você também pode conectar o OpenHands ao seu sistema de arquivos local, executar o OpenHands em um modo headless scriptável, interagir com ele via CLI amigável ou executá-lo em problemas marcados com uma ação do github.

Visite Executando o OpenHands para mais informações e instruções de configuração.

Se você quiser modificar o código-fonte do OpenHands, confira Development.md.

Problemas? O Guia de Solução de Problemas pode ajudar.

📖 Documentação

Para saber mais sobre o projeto e dicas sobre como usar o OpenHands, consulte nossa documentação.

Lá você encontrará recursos sobre como usar diferentes provedores de LLM, materiais de solução de problemas e opções avançadas de configuração.

🤝 Como Participar da Comunidade

O OpenHands é um projeto impulsionado pela comunidade e damos as boas-vindas a contribuições de todos. Fazemos a maior parte de nossa comunicação através do Slack, então este é o melhor lugar para começar, mas também ficamos felizes em receber seu contato no Discord ou Github:

• Junte-se ao nosso workspace no Slack - Aqui discutimos pesquisa, arquitetura e desenvolvimento futuro.
• Junte-se ao nosso servidor no Discord - Este é um servidor administrado pela comunidade para discussões gerais, perguntas e feedback.
• Leia ou publique Issues no Github - Confira os problemas em que estamos trabalhando ou adicione suas próprias ideias.

Veja mais sobre a comunidade em COMMUNITY.md ou encontre detalhes sobre contribuições em CONTRIBUTING.md.

📈 Progresso

Veja o roteiro mensal do OpenHands aqui (atualizado na reunião dos mantenedores no final de cada mês).

📜 Licença

Distribuído sob a Licença MIT. Veja LICENSE para mais informações.

🙏 Agradecimentos

O OpenHands é construído por um grande número de contribuidores, e cada contribuição é muito apreciada! Também construímos sobre outros projetos de código aberto e somos profundamente gratos por seu trabalho.

Para uma lista de projetos de código aberto e licenças usadas no OpenHands, consulte nosso arquivo CREDITS.md.

📚 Cite

@misc{openhands,
      title={{OpenHands: An Open Platform for AI Software Developers as Generalist Agents}},
      author={Xingyao Wang and Boxuan Li and Yufan Song and Frank F. Xu and Xiangru Tang and Mingchen Zhuge and Jiayi Pan and Yueqi Song and Bowen Li and Jaskirat Singh and Hoang H. Tran and Fuqiang Li and Ren Ma and Mingzhang Zheng and Bill Qian and Yanjun Shao and Niklas Muennighoff and Yizhe Zhang and Binyuan Hui and Junyang Lin and Robert Brennan and Hao Peng and Heng Ji and Graham Neubig},
      year={2024},
      eprint={2407.16741},
      archivePrefix={arXiv},
      primaryClass={cs.SE},
      url={https://arxiv.org/abs/2407.16741},
}