---
name: "Run software engineering tasks with OpenHands"
slug: "run-software-engineering-tasks-with-openhands"
description: "Use OpenHands to run supervised software-engineering agents that inspect repositories, edit code, execute commands, and return reviewable implementation evidence."
github_stars: 74226
verification: "security_reviewed"
source: "https://github.com/OpenHands/OpenHands"
author: "OpenHands"
publisher_type: "organization"
category: "Developer Tools"
framework: "Custom Agents"
tool_ecosystem:
  github_repo: "OpenHands/OpenHands"
  github_stars: 74226
---

# Run software engineering tasks with OpenHands

Use OpenHands to run supervised software-engineering agents that inspect repositories, edit code, execute commands, and return reviewable implementation evidence.

## Prerequisites

OpenHands runtime, model provider credentials, target repository or workspace, Docker or supported local/cloud runtime

## Installation

Requirements and caveats from upstream:
- The SDK is a composable Python library that contains all of our agentic tech. It's the engine that powers everything else below.
- The core openhands and agent-server Docker images are fully MIT-licensed as well.

Basic usage or getting-started notes:
- 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/openhands/usage/run-openhands/cli-mode) or [view the source](https://github.com/OpenHands/OpenHands-CLI)
- [Check out the docs](https://docs.openhands.dev/openhands/usage/run-openhands/local-setup) or view the source in this repo.

- Source: https://github.com/OpenHands/OpenHands
- Extracted from upstream docs: https://raw.githubusercontent.com/OpenHands/OpenHands/HEAD/README.md

## Documentation

- https://openhands.dev

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/run-software-engineering-tasks-with-openhands/)