https://github.com/All-Hands-AI/OpenHands
๐ OpenHands: Code Less, Make More
https://github.com/All-Hands-AI/OpenHands
agent artificial-intelligence chatgpt claude-ai cli developer-tools gpt llm openai
Last synced: about 2 months ago
JSON representation
๐ OpenHands: Code Less, Make More
- Host: GitHub
- URL: https://github.com/All-Hands-AI/OpenHands
- Owner: All-Hands-AI
- License: mit
- Created: 2024-03-13T03:33:31.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-06T16:27:24.000Z (about 2 months ago)
- Last Synced: 2025-08-06T16:28:06.324Z (about 2 months ago)
- Topics: agent, artificial-intelligence, chatgpt, claude-ai, cli, developer-tools, gpt, llm, openai
- Language: Python
- Homepage: https://all-hands.dev
- Size: 210 MB
- Stars: 61,778
- Watchers: 420
- Forks: 7,342
- Open Issues: 403
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- AiTreasureBox - All-Hands-AI/OpenHands - 09-11_63397_39](https://img.shields.io/github/stars/All-Hands-AI/OpenHands.svg)|๐ OpenHands: Code Less, Make More| (Repos)
- awesome-AI-driven-development - OpenHands - A platform for AI-powered software development agents. OpenHands agents can do anything a human developer can: modify code, run commands, browse the web, call APIs, and even copy files to remote servers. (Multi-Agent & Orchestration / Other IDEs)
- awesomeLibrary - OpenHands - ๐ OpenHands: Code Less, Make More (่ฏญ่จ่ตๆบๅบ / python)
- awesome-ccamel - All-Hands-AI/OpenHands - ๐ OpenHands: Code Less, Make More (Python)
- awesome-repositories - All-Hands-AI/OpenHands - ๐ OpenHands: Code Less, Make More (Python)
- awesome-agents - OpenHands
- awesome-agents - OpenHands
- awesome-ai-dev-tools - OpenHands - An open-source AI development assistant with multi-language support. (Tools / ๐ What You'll Find Here:)
- FreeTools - OpenHands
- awesome-agents - OpenHands - Hands-AI/OpenHands?style=social) (Software Development)
- awesome-research-agents - OpenHands
- jimsghstars - All-Hands-AI/OpenHands - ๐ OpenHands: Code Less, Make More (Python)
- Awesome-Local-LLM - _Git_ - hands.dev/) (Coding)
- Awesome-Local-LLM - _Git_ - hands.dev/) (Coding)
- awesome - All-Hands-AI/OpenHands - ๐ OpenHands: Code Less, Make More (Python)
- awesome-llm-agent - OpenHands
- awesome-copilots - OpenHands - Platform for software development agents (Coding Copilots / Web-Based Development Environments)
- definitive-opensource - OpenHands
- awesome - All-Hands-AI/OpenHands - ๐ OpenHands: Code Less, Make More (Python)
- awesome-clone-games - GitHubไปฃ็
- awesome-deep-research - OpenHands (fka OpenDevin) - An agentic AI software engineer that can understand high-level instructions and write code. (๐ค Deep Research Systems / ๐ Open-Source Deep Research Implementations)
- awesome-deep-research - OpenHands (fka OpenDevin) - An agentic AI software engineer that can understand high-level instructions and write code. (๐ค Deep Research Systems / ๐ Open-Source Deep Research Implementations)
- awesome-hacking-lists - All-Hands-AI/OpenHands - ๐ OpenHands: Code Less, Make More (Python)
- awesome-chatgpt - All-Hands-AI/OpenHands - OpenHands is an AI-powered platform that enables software development agents to perform coding, command execution, web browsing, and API interactions, streamlining the development process and enhancing productivity. (UIs / Command-line(shell) interface)
README
![]()
OpenHands: Code Less, Make More
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](https://docs.all-hands.dev), or [sign up for OpenHands Cloud](https://app.all-hands.dev) to get started.
> [!IMPORTANT]
> Using OpenHands for work? We'd love to chat! Fill out
> [this short form](https://docs.google.com/forms/d/e/1FAIpQLSet3VbGaz8z32gW9Wm-Grl4jpt5WgMXPgJ4EDPVmCETCBpJtQ/viewform)
> to join our Design Partner program, where you'll get early access to commercial features and the opportunity to provide input on our product roadmap.
## โ๏ธ OpenHands Cloud
The easiest way to get started with OpenHands is on [OpenHands Cloud](https://app.all-hands.dev),
which comes with $20 in free credits for new users.## ๐ป Running OpenHands Locally
OpenHands can also run on your local system using Docker.
See the [Running OpenHands](https://docs.all-hands.dev/usage/installation) guide for
system requirements and more information.> [!WARNING]
> On a public network? See our [Hardened Docker Installation Guide](https://docs.all-hands.dev/usage/runtimes/docker#hardened-docker-installation)
> to secure your deployment by restricting network binding and implementing additional security measures.```bash
docker pull docker.all-hands.dev/all-hands-ai/runtime:0.51-nikolaikdocker run -it --rm --pull=always \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.51-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.51
```> **Note**: If you used OpenHands before version 0.44, you may want to run `mv ~/.openhands-state ~/.openhands` to migrate your conversation history to the new location.
You'll find OpenHands running at [http://localhost:3000](http://localhost:3000)!
When you open the application, you'll be asked to choose an LLM provider and add an API key.
[Anthropic's Claude Sonnet 4](https://www.anthropic.com/api) (`anthropic/claude-sonnet-4-20250514`)
works best, but you have [many options](https://docs.all-hands.dev/usage/llms).## ๐ก Other ways to run OpenHands
> [!WARNING]
> OpenHands is meant to be run by a single user on their local workstation.
> It is not appropriate for multi-tenant deployments where multiple users share the same instance. There is no built-in authentication, isolation, or scalability.
>
> If you're interested in running OpenHands in a multi-tenant environment, check out the source-available, commercially-licensed
> [OpenHands Cloud Helm Chart](https://github.com/all-Hands-AI/OpenHands-cloud)You can [connect OpenHands to your local filesystem](https://docs.all-hands.dev/usage/runtimes/docker#connecting-to-your-filesystem),
run OpenHands in a scriptable [headless mode](https://docs.all-hands.dev/usage/how-to/headless-mode),
interact with it via a [friendly CLI](https://docs.all-hands.dev/usage/how-to/cli-mode),
or run it on tagged issues with [a github action](https://docs.all-hands.dev/usage/how-to/github-action).Visit [Running OpenHands](https://docs.all-hands.dev/usage/installation) for more information and setup instructions.
If you want to modify the OpenHands source code, check out [Development.md](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md).
Having issues? The [Troubleshooting Guide](https://docs.all-hands.dev/usage/troubleshooting) can help.
To learn more about the project, and for tips on using OpenHands,
check out our [documentation](https://docs.all-hands.dev/usage/getting-started).There you'll find resources on how to use different LLM providers,
troubleshooting resources, and advanced configuration options.## ๐ค How to Join the Community
OpenHands is a community-driven project, and we welcome contributions from everyone. We do most of our communication
through Slack, so this is the best place to start, but we also are happy to have you contact us on Discord or Github:- [Join our Slack workspace](https://join.slack.com/t/openhands-ai/shared_invite/zt-3847of6xi-xuYJIPa6YIPg4ElbDWbtSA) - Here we talk about research, architecture, and future development.
- [Join our Discord server](https://discord.gg/ESHStjSjD4) - This is a community-run server for general discussion, questions, and feedback.
- [Read or post Github Issues](https://github.com/All-Hands-AI/OpenHands/issues) - Check out the issues we're working on, or add your own ideas.See more about the community in [COMMUNITY.md](./COMMUNITY.md) or find details on contributing in [CONTRIBUTING.md](./CONTRIBUTING.md).
## ๐ Progress
See the monthly OpenHands roadmap [here](https://github.com/orgs/All-Hands-AI/projects/1) (updated at the maintainer's meeting at the end of each month).
## ๐ License
Distributed under the MIT License. See [`LICENSE`](./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](./CREDITS.md) file.
## ๐ Cite
```
@inproceedings{
wang2025openhands,
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},
booktitle={The Thirteenth International Conference on Learning Representations},
year={2025},
url={https://openreview.net/forum?id=OJd3ayDDoF}
}
```