openagent @ openhands ~ $

cat README.md

OpenHands

Open-source AI software development agent for coding tasks, repositories, and developer workflows.

# 71K Stars · 9.0K Forks · MIT License // verified 2026-04-19
openhands/main
$git clone https://github.com/OpenHands/OpenHands.git
Installing OpenHands...
OpenHands ready
$openhands --help
Reading openhands configuration & environment...
# core strengths

What makes OpenHands different

Repository-level coding agent

OpenHands is designed around software development tasks, not only answering programming questions.

Real coding assistance requires file edits, terminal work, testing, and iteration.

Open implementation for agent workflows

The public repository lets builders inspect how the system approaches planning, execution, and developer controls.

Coding agents touch valuable codebases, so inspectability matters.

Strong fit for coding-agent comparison

OpenHands is a useful reference point when comparing open coding agents against proprietary tools.

Teams can evaluate tradeoffs around local control, hosted convenience, and engineering safety.
# quick start

Your first command

terminal
$git clone https://github.com/OpenHands/OpenHands.git
# use cases

How developers use OpenHands

01

Issue triage and code changes

Use OpenHands as a candidate when an agent needs to inspect a repository and propose implementation changes.

02

Coding-agent research

Study how an open coding agent handles tasks, tools, sandboxing, and developer feedback.

03

Self-hosted developer automation

Evaluate whether parts of your coding workflow can run in an inspectable open-source environment.

# comparison

How OpenHands compares

Choose OpenHands for software development workflows vs browser automation agents

browser-use and OpenClaw are stronger for web workflows. OpenHands is more directly focused on repositories, code tasks, and software engineering.

# faq

Questions

Q: What should I check before using OpenHands?

Start with one safe workflow for OpenHands. Inspect official setup instructions, required credentials, execution logs, approval points, and failure recovery before expanding from a sandbox task into production automation.

Q: Is OpenHands open source?

OpenHands is listed with MIT based on the official source links in this profile. Re-check the repository, model card, or docs before production use.

Q: Who should evaluate OpenHands?

OpenHands is most worth evaluating for developers evaluating open-source coding agents.

Decision brief

Should you use OpenHands?

JSON
Best for
  • Developers evaluating open-source coding agents
  • Teams that want an inspectable alternative to closed coding-agent products
  • Researchers studying repository-level task automation and software engineering agents
Not for
  • Non-technical users looking for a general personal assistant
  • Teams unwilling to review sandboxing and repository permissions before using coding agents
Trust and freshness
  • Verified 2026-04-19
  • License: MIT
  • Repo: OpenHands/OpenHands
  • Open-source signal
Deployment

self hosted, cloud

Permission surface

shell/files

Decision signals

Self-hostable, Docker

Agent packet

Structured decision data for OpenHands

This packet is the compact machine-readable view agents should use before following source links or taking action.

Capabilities

workflow orchestration, tool calling

Constraints

open source, self hosted, docker

Deployment

self hosted, cloud

Permission surface

shell/files

Recommended workflows

Coding agent workflow

Overview

What OpenHands does

What it is

OpenHands is an open agent resource to evaluate by action surface: what software it can operate, which tools or browser steps it touches, and how much supervision it needs before it can run real work.

Why it matters

Coding agents need more trust than chatbots because they can change files, run commands, and touch repositories. OpenHands is useful because its implementation can be inspected, tested, and compared against closed coding-agent products.

How to evaluate it

Start with one safe workflow for OpenHands. Inspect official setup instructions, required credentials, execution logs, approval points, and failure recovery before expanding from a sandbox task into production automation.

Facts

Known metadata and operating surface

These fields are separated from editorial interpretation so agents can reason over facts and missing checks.

Resource type agent
Category Agents
Maturity active
Difficulty Unknown
License MIT
Pricing open source
Verified 2026-04-19
Source confidence high
Risk level moderate
Fit matrix

Where OpenHands fits in an agent stack

strong

Coding agent workflow

OpenHands has multiple signals for coding agent workflow, including matching tags, capabilities, category, or positioning.

  • Run a small repository change and inspect the diff, tests, and rollback path.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial

Browser automation

OpenHands has at least one signal for browser automation, but should be checked against a real task before adoption.

  • Run one non-sensitive website task and inspect clicks, waits, retries, and changed URLs.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial

Evaluation and observability

OpenHands has at least one signal for evaluation and observability, but should be checked against a real task before adoption.

  • Add one repeatable test case and confirm results can run again in review or CI.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial

Local or private AI stack

OpenHands has at least one signal for local or private ai stack, but should be checked against a real task before adoption.

  • Verify hardware requirements, data path, storage, and whether all calls stay in your environment.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial

Reusable skill workflow

OpenHands has at least one signal for reusable skill workflow, but should be checked against a real task before adoption.

  • Run one skill end to end and check whether it produces evidence or structured output.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
weak

Connector or protocol layer

OpenHands is not primarily positioned for connector or protocol layer in the current metadata.

  • Connect one low-risk service, then inspect schemas, auth scope, errors, and logs.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
Inputs and outputs

What an agent should inspect

Likely inputs

  • Repositories, files, issues, terminal output, and test results
  • Official setup instructions and a small real workflow

Likely outputs

  • Diffs, commits, explanations, test results, or review notes
  • Scores, traces, regression results, dashboards, or failure cases
  • A decision on whether this resource fits the target workflow
Evidence

Sources, claims, and missing checks

Claims are marked separately from source links so future crawlers and reviewers can update them without rewriting the page.

verified

OpenHands is listed as open source.

License metadata: MIT
verified

OpenHands has a recorded GitHub repository: OpenHands/OpenHands.

Resource facts and GitHub source link.
inferred

OpenHands supports these recorded deployment modes: self hosted, cloud.

OpenAgent decision signal metadata.
inferred

OpenHands is tagged with workflow orchestration, tool calling capabilities.

OpenAgent capability taxonomy.
Missing checks
  • Repository freshness has not been recorded.
Next action

How to start evaluating OpenHands

Inspect repository

Check license, recent activity, issues, examples, and security-sensitive code paths.

Open source

Open Homepage

Start from the official source before adopting third-party instructions.

Open source

Read setup docs

Use docs as the source of truth for installation and supported interfaces.

Open source

Clone the OpenHands repository

Start with the official repository and follow the docs for the current Docker or runtime setup.

git clone https://github.com/OpenHands/OpenHands.git
Compare

Alternatives and nearby resources

Use related resources to compare category fit, license, deployment model, and first-workflow behavior.

FAQ

Common questions about OpenHands

What should I check before using OpenHands?

Start with one safe workflow for OpenHands. Inspect official setup instructions, required credentials, execution logs, approval points, and failure recovery before expanding from a sandbox task into production automation.

Is OpenHands open source?

OpenHands is listed with MIT based on the official source links in this profile. Re-check the repository, model card, or docs before production use.

Who should evaluate OpenHands?

OpenHands is most worth evaluating for developers evaluating open-source coding agents.

Is OpenHands only for developers?

Yes, its clearest fit is software development and repository workflows.

Should I use OpenHands on production code immediately?

No. Start with a sandbox repository and review every change before moving to important code.