mirror of
https://github.com/All-Hands-AI/OpenHands.git
synced 2026-04-29 03:00:45 -04:00
154 lines
8.2 KiB
Markdown
154 lines
8.2 KiB
Markdown
<a name="readme-top"></a>
|
||
|
||
<div align="center">
|
||
<img src="https://raw.githubusercontent.com/OpenHands/docs/main/openhands/static/img/logo.png" alt="Logo" width="200">
|
||
<h1 align="center" style="border-bottom: none">OpenHands: AI-Driven Development</h1>
|
||
</div>
|
||
|
||
|
||
<div align="center">
|
||
<a href="https://github.com/OpenHands/OpenHands/blob/main/LICENSE"><img src="https://img.shields.io/badge/LICENSE-MIT-20B2AA?style=for-the-badge" alt="MIT License"></a>
|
||
<a href="https://docs.google.com/spreadsheets/d/1wOUdFCMyY6Nt0AIqF705KN4JKOWgeI4wUGUP60krXXs/edit?gid=811504672#gid=811504672"><img src="https://img.shields.io/badge/SWEBench-77.6-00cc00?logoColor=FFE165&style=for-the-badge" alt="Benchmark Score"></a>
|
||
<br/>
|
||
<a href="https://docs.openhands.dev/sdk"><img src="https://img.shields.io/badge/Documentation-000?logo=googledocs&logoColor=FFE165&style=for-the-badge" alt="Check out the documentation"></a>
|
||
<a href="https://arxiv.org/abs/2511.03690"><img src="https://img.shields.io/badge/Paper-000?logoColor=FFE165&logo=arxiv&style=for-the-badge" alt="Tech Report"></a>
|
||
|
||
|
||
<!-- Keep these links. Translations will automatically update with the README. -->
|
||
<a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=de">Deutsch</a> |
|
||
<a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=es">Español</a> |
|
||
<a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=fr">français</a> |
|
||
<a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ja">日本語</a> |
|
||
<a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ko">한국어</a> |
|
||
<a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=pt">Português</a> |
|
||
<a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ru">Русский</a> |
|
||
<a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=zh">中文</a>
|
||
</div>
|
||
|
||
<hr>
|
||
|
||
🙌 Welcome to OpenHands, a [community](COMMUNITY.md) focused on AI-driven development. We’d love for you to [join us on Slack](https://dub.sh/openhands).
|
||
|
||
There are a few ways to work with OpenHands:
|
||
|
||
### OpenHands Software Agent SDK
|
||
The SDK is a composable Python library that contains all of our agentic tech. It's the engine that powers everything else below.
|
||
|
||
Define agents in code, then run them locally, or scale to 1000s of agents in the cloud.
|
||
|
||
[Check out the docs](https://docs.openhands.dev/sdk) or [view the source](https://github.com/OpenHands/software-agent-sdk/)
|
||
|
||
### OpenHands CLI
|
||
The CLI is the easiest way to start using OpenHands. The experience will be familiar to anyone who has worked
|
||
with e.g. Claude Code or Codex. You can power it with Claude, GPT, or any other LLM.
|
||
|
||
[Check out the docs](https://docs.openhands.dev/openhands/usage/run-openhands/cli-mode) or [view the source](https://github.com/OpenHands/OpenHands-CLI)
|
||
|
||
### OpenHands Local GUI
|
||
Use the Local GUI for running agents on your laptop. It comes with a REST API and a single-page React application.
|
||
The experience will be familiar to anyone who has used Devin or Jules.
|
||
|
||
[Check out the docs](https://docs.openhands.dev/openhands/usage/run-openhands/local-setup) or view the source in this repo.
|
||
|
||
### OpenHands Cloud
|
||
This is a deployment of OpenHands GUI, running on hosted infrastructure.
|
||
|
||
You can try it for free using the Minimax model by [signing in with your GitHub or GitLab account](https://app.all-hands.dev).
|
||
|
||
OpenHands Cloud comes with source-available features and integrations:
|
||
- Integrations with Slack, Jira, and Linear
|
||
- Multi-user support
|
||
- RBAC and permissions
|
||
- Collaboration features (e.g., conversation sharing)
|
||
|
||
### OpenHands Enterprise
|
||
Large enterprises can work with us to self-host OpenHands Cloud in their own VPC, via Kubernetes.
|
||
OpenHands Enterprise can also work with the CLI and SDK above.
|
||
|
||
OpenHands Enterprise is source-available--you can see all the source code here in the enterprise/ directory,
|
||
but you'll need to purchase a license if you want to run it for more than one month.
|
||
|
||
Enterprise contracts also come with extended support and access to our research team.
|
||
|
||
Learn more at [openhands.dev/enterprise](https://openhands.dev/enterprise)
|
||
|
||
### Everything Else
|
||
|
||
Check out our [Product Roadmap](https://github.com/orgs/openhands/projects/1), and feel free to
|
||
[open up an issue](https://github.com/OpenHands/OpenHands/issues) if there's something you'd like to see!
|
||
|
||
You might also be interested in our [evaluation infrastructure](https://github.com/OpenHands/benchmarks), our [chrome extension](https://github.com/OpenHands/openhands-chrome-extension/), or our [Theory-of-Mind module](https://github.com/OpenHands/ToM-SWE).
|
||
|
||
All our work is available under the MIT license, except for the `enterprise/` directory in this repository (see the [enterprise license](enterprise/LICENSE) for details).
|
||
The core `openhands` and `agent-server` Docker images are fully MIT-licensed as well.
|
||
|
||
If you need help with anything, or just want to chat, [come find us on Slack](https://dub.sh/openhands).
|
||
|
||
<hr>
|
||
|
||
### Thank You to Our Contributors
|
||
|
||
<div align="center">
|
||
|
||
[](https://github.com/OpenHands/OpenHands/graphs/contributors)
|
||
|
||
</div>
|
||
|
||
<hr>
|
||
|
||
### Trusted by Engineers at
|
||
|
||
<div align="center">
|
||
<br/><br/>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/tiktok.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/tiktok.svg" alt="TikTok" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/vmware.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/vmware.svg" alt="VMware" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/roche.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/roche.svg" alt="Roche" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/amazon.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/amazon.svg" alt="Amazon" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/c3-ai.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/c3-ai.svg" alt="C3 AI" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/netflix.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/netflix.svg" alt="Netflix" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/mastercard.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/mastercard.svg" alt="Mastercard" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/red-hat.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/red-hat.svg" alt="Red Hat" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/mongodb.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/mongodb.svg" alt="MongoDB" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/apple.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/apple.svg" alt="Apple" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/nvidia.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/nvidia.svg" alt="NVIDIA" height="17" hspace="5">
|
||
</picture>
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://assets.openhands.dev/logos/external/white/google.svg">
|
||
<img src="https://assets.openhands.dev/logos/external/black/google.svg" alt="Google" height="17" hspace="5">
|
||
</picture>
|
||
</div>
|
||
|
||
</div>
|