# OpenHands

OpenHands is an open-source AI software development agent that writes, reviews, and tests code. It is open source and self-hosted, installable on Umbrel, ZimaOS and Unraid.

Canonical page: https://ourlocalhost.com/app/3159/openhands

## Description

OpenHands is an open-source AI software development agent that writes, reviews, and tests code. It runs locally by default and can connect to multiple agent backends, making it useful for developers who want a self-hosted, always-on coding assistant.

## Platform availability

Available on 7 of 10 platforms: Unraid, Umbrel, ZimaOS, Mac, Windows, Linux, Any server.

## Desktop and other devices

Mac, Windows, Linux.

## Health score

85/100 (Excellent), based on 4 of 4 factors.
- Maintained: 98 (last commit 53 days ago)
- Popular: 99 (89,461 GitHub stars)
- Easy to install: 85 (6 install platforms, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Umbrel: https://apps.umbrel.com/app/openhands
- ZimaOS: https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/OpenHands
- desktop: https://github.com/OpenHands/OpenHands/releases/latest
- Unraid: https://ca.unraid.net/apps/openhands-11lx1wx1yjp30t?q=OpenHands
- Official website: https://openhands.dev
- Documentation: https://docs.openhands.dev

## Common questions

### Do I need to install anything before installing Agent Canvas?

Yes, install Node.js 22.12 or newer and uv first, then install @openhands/agent-canvas with npm; without them the install command can fail or the app may not start.

### Do OpenHands tools run on the host or in a container by default?

A local process backend runs Agent Server and tools directly on its host. Docker, Kubernetes, Sandbox Server, Cloud, and Enterprise deployments can provide stronger isolation based on their configuration.

### Why are custom skills missing when OpenHands runs via Docker?

The agent-server container cannot see the host filesystem by default, so skills in host ~/.openhands/skills/ or ~/.agents/skills/ are not loaded.

### How is the self-hosted deployment structured?

It is a single-host multi-service stack orchestrated by an ingress proxy. The npx @openhands/agent-canvas entrypoint manages the lifecycle of three primary backends.

### What does self-hosting cost per resolved task?

Published community analysis puts it at roughly $0.20 to $1.05 per resolved task at H100 GPU rates, depending on the model.

---
Source: Our Local Host (https://ourlocalhost.com/app/3159/openhands), the self-hosted and open-source app directory.
