# OpenHands — AI-Driven Development Agent

> OpenHands is an MIT open-source dev agent for agentic coding, with docs, an SDK, and a Docker-first runtime to run tasks reproducibly.

## Install

Copy the content below into your project:

## Quick Use

```bash
git clone https://github.com/OpenHands/OpenHands.git && cd OpenHands
docker compose up
# Docs: https://docs.openhands.dev/
```

## Intro

OpenHands is an MIT open-source dev agent for agentic coding, with docs, an SDK, and a Docker-first runtime to run tasks reproducibly.

**Best for:** teams who want an open-source baseline for dev agents and reproducible task execution

**Works with:** Docker/Docker Compose, agent runtimes, tool integrations (repo access, tests, build pipelines)

**Setup time:** 12-20 minutes

### Key facts (verified)

- GitHub: 73321 stars · 9270 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `git clone https://github.com/OpenHands/OpenHands.git && cd OpenHands`.

## Main

- Use OpenHands as a baseline: start with its default runtime, then layer your own tools and policies for your repo.

- Make runs reproducible: lock versions, prefer containers, and keep a clear boundary between agent state and project state.

- For teams, define guardrails: what the agent can modify, which commands are allowed, and how reviews/approvals happen.

### Source-backed notes

- README positions OpenHands as “AI-Driven Development” with a docs site link.
- Repository license indicates MIT for content outside the enterprise directory.
- Repo is active and widely adopted based on stars and frequent pushes.

### FAQ

- **Is it free and open source?**: Core is MIT licensed; enterprise/ may carry different terms (see LICENSE).
- **How do I run it quickly?**: README suggests Docker-first usage; start with `docker compose up`.
- **What should I add first?**: Add repo-specific tooling (tests, linters) and a clear approval workflow.

## Source & Thanks

> Source: https://github.com/OpenHands/OpenHands
> License: MIT
> GitHub stars: 73321 · forks: 9270

---

<!-- ZH -->

## Quick Use

```bash
git clone https://github.com/OpenHands/OpenHands.git && cd OpenHands
docker compose up
# Docs: https://docs.openhands.dev/
```

## Intro

OpenHands 是 MIT 许可的开源开发 agent，面向 agentic coding；提供文档与 SDK，并以 Docker 为核心的运行方式让任务执行更可复现、便于团队协作与复盘。

**Best for:** 想要用开源基线搭建开发 agent，并强调可复现执行的团队

**Works with:** Docker/Docker Compose、常见 agent 运行时、仓库/测试/构建等工具集成

**Setup time:** 12-20 minutes

### Key facts (verified)

- GitHub：73321 stars · 9270 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`git clone https://github.com/OpenHands/OpenHands.git && cd OpenHands`。

## Main

- 把它当基线：先跑通默认运行方式，再逐步叠加你们仓库需要的工具与策略。

- 让执行可复现：固定版本、优先容器化，并明确 agent 状态与项目状态的边界。

- 团队场景要先定护栏：能改哪些文件、允许哪些命令、评审/审批如何流转。

### Source-backed notes

- README 将 OpenHands 定位为“AI-Driven Development”，并提供官方文档链接。
- LICENSE 说明 enterprise 目录外内容为 MIT 许可。
- 从 stars 与近期更新看，项目活跃且被广泛使用。

### FAQ

- **它是免费开源的吗？**：核心部分为 MIT；enterprise/ 目录可能不同（以 LICENSE 为准）。
- **最快怎么跑起来？**：按 README 的 Docker-first 路径，从 `docker compose up` 开始。
- **第一步该加什么？**：把你们仓库的测试/格式化等工具接入，并设定清晰的审批流程。

## Source & Thanks

> Source: https://github.com/OpenHands/OpenHands
> License: MIT
> GitHub stars: 73321 · forks: 9270


---
Source: https://tokrepo.com/en/workflows/openhands-ai-driven-development-agent
Author: Agent Toolkit