Skip to main content

OpenHands: Code Less, Make More

Project description

Logo

OpenHands: Code Less, Make More

Contributors Stargazers CodeCov MIT License
Join our Slack community Join our Discord community Credits
Check out the documentation Paper on Arxiv Evaluation Benchmark Score

Welcome to OpenHands (formerly OpenDevin), a platform for software development agents powered by AI.

OpenHands agents can do anything a human developer can: modify code, run commands, browse the web, call APIs, and yes—even copy code snippets from StackOverflow.

Learn more at docs.all-hands.dev, or jump to the Quick Start.

App screenshot

⚡ Quick Start

The easiest way to run OpenHands is in Docker. You can change WORKSPACE_BASE below to point OpenHands to existing code that you'd like to modify.

See the Getting Started guide for system requirements and more information.

export WORKSPACE_BASE=$(pwd)/workspace

docker run -it --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=ghcr.io/all-hands-ai/runtime:0.9-nikolaik \
    -e SANDBOX_USER_ID=$(id -u) \
    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
    -v $WORKSPACE_BASE:/opt/workspace_base \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -p 3000:3000 \
    --add-host host.docker.internal:host-gateway \
    --name openhands-app-$(date +%Y%m%d%H%M%S) \
    ghcr.io/all-hands-ai/openhands:0.9

You'll find OpenHands running at http://localhost:3000!

You can also run OpenHands in a scriptable headless mode, or as an interactive CLI.

Visit Getting Started for more information and setup instructions.

If you want to modify the OpenHands source code, check out Development.md.

Having issues? The Troubleshooting Guide can help.

📖 Documentation

To learn more about the project, and for tips on using OpenHands, check out our documentation.

There you'll find resources on how to use different LLM providers, troubleshooting resources, and advanced configuration options.

🤝 How to Contribute

OpenHands is a community-driven project, and we welcome contributions from everyone. Whether you're a developer, a researcher, or simply enthusiastic about advancing the field of software engineering with AI, there are many ways to get involved:

  • Code Contributions: Help us develop new agents, core functionality, the frontend and other interfaces, or sandboxing solutions.
  • Research and Evaluation: Contribute to our understanding of LLMs in software engineering, participate in evaluating the models, or suggest improvements.
  • Feedback and Testing: Use the OpenHands toolset, report bugs, suggest features, or provide feedback on usability.

For details, please check CONTRIBUTING.md.

🤖 Join Our Community

Whether you're a developer, a researcher, or simply enthusiastic about OpenHands, we'd love to have you in our community. Let's make software engineering better together!

  • Slack workspace - Here we talk about research, architecture, and future development.
  • Discord server - This is a community-run server for general discussion, questions, and feedback.

📈 Progress

Star History Chart

📜 License

Distributed under the MIT License. See LICENSE for more information.

🙏 Acknowledgements

OpenHands is built by a large number of contributors, and every contribution is greatly appreciated! We also build upon other open source projects, and we are deeply thankful for their work.

For a list of open source projects and licenses used in OpenHands, please see our CREDITS.md file.

📚 Cite

@misc{opendevin,
      title={{OpenDevin: 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},
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openhands_ai_test-0.9.6.tar.gz (426.5 kB view details)

Uploaded Source

Built Distribution

openhands_ai_test-0.9.6-py3-none-any.whl (493.1 kB view details)

Uploaded Python 3

File details

Details for the file openhands_ai_test-0.9.6.tar.gz.

File metadata

  • Download URL: openhands_ai_test-0.9.6.tar.gz
  • Upload date:
  • Size: 426.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.10 Linux/6.8.0-1014-azure

File hashes

Hashes for openhands_ai_test-0.9.6.tar.gz
Algorithm Hash digest
SHA256 4ad4fd0020e7c51d85b736334618beb739d1d7d6530c06544d6dc644c5febcc2
MD5 3e3759aff1a2c06af36c904596b584db
BLAKE2b-256 767cf142053766542a3bf09a78de4e485246684d5da7a7fffc76f53eb1176565

See more details on using hashes here.

File details

Details for the file openhands_ai_test-0.9.6-py3-none-any.whl.

File metadata

  • Download URL: openhands_ai_test-0.9.6-py3-none-any.whl
  • Upload date:
  • Size: 493.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.10 Linux/6.8.0-1014-azure

File hashes

Hashes for openhands_ai_test-0.9.6-py3-none-any.whl
Algorithm Hash digest
SHA256 8b8d950630f3e5dfd63a8b2a204dff8ad37a551bb7defca22cf63fbed0e42773
MD5 c8f505868bdf29bacbf8e844c0fb1790
BLAKE2b-256 5c4d2b1f799b4fdb7cc9f53d981938b62757caaa533c31450a3dddda327a8601

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page