---
id: openhands
version: "1.16.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# openhands — OpenHands CLI - Terminal User Interface for OpenHands AI Agent

License: permissive · Maintenance: active · Downloads: 1.1M/mo

## What it is and what it does

OpenHands is a command-line interface for running an AI agent that can automate software development tasks. It connects to language models (via configurable LLM settings) and executes actions like writing code, running tests, and fixing bugs either interactively in your terminal or headlessly in CI pipelines. The package ships with multiple modes: a terminal UI for interactive development, IDE integration for editors like VSCode and JetBrains, a headless mode for automation, and a web interface for browser-based access.

The agent stores configuration locally under ~/.openhands/ and supports Model Context Protocol (MCP) servers to extend its capabilities. It includes confirmation modes to control whether actions require approval, can be auto-approved, or validated by an LLM-based security analyzer. The package depends on 13 runtime libraries including Textual for the terminal UI, Pydantic for configuration, and the OpenHands SDK and tools packages that provide the core agent functionality.

Use it for:

- Run an interactive AI agent in your terminal to write code, debug issues, or refactor files in real time.
- Integrate OpenHands into CI/CD pipelines to automate code generation, testing, or bug fixes without manual intervention.
- Use headless mode to execute one-off development tasks from scripts or scheduled jobs with JSON output for parsing.
- Connect IDE plugins (Zed, VSCode, JetBrains) to OpenHands for in-editor AI-assisted development.
- Deploy a web-based GUI server to share an AI agent interface across a team or run tasks on OpenHands Cloud.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

OpenHands is a CLI tool that runs an AI agent in your terminal, IDE, browser, or CI pipeline to automate development tasks like writing code, fixing bugs, and running tests.

Yes, if you need an AI agent for development automation and are willing to commit to Python 3.12. The package is actively maintained, has no known vulnerabilities, low install friction, and offers multiple modes (terminal, headless, web, IDE) for different workflows. The strict Python 3.12 requirement is a real constraint—verify your environment supports it before installing.

## Install

pip install openhands
uv add openhands
poetry add openhands

## Installing openhands

Before you install: Low install friction with a pure-Python wheel distribution. Requires Python 3.12 specifically; the package is actively maintained with a recent release.

License in practice: MIT license is permissive and places no restrictions on use, modification, or redistribution in commercial or private projects.

Quickstart:

pip install openhands

openhands

# Or in headless mode:
openhands --headless -t "Write unit tests for auth.py"

Requires Python 3.12 exactly (not 3.11 or 3.13); the package pins to 3.12.* only.

Verify before relying:

- Whether the 13 runtime dependencies (including textual, pydantic, httpx, and others) are all stable and well-maintained.
- Performance characteristics and resource consumption when running agents locally versus on OpenHands Cloud.
- How the MCP server integration works in practice and what additional setup is required beyond the CLI.

## Package facts

- License: MIT (permissive)
- Python support: capped_below_current
- Install friction: low
- Maintenance: active
- Downloads: 1.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ai agent cli terminal, automated code generation, ai coding assistant, headless ai agent, ci cd automation agent, terminal ui ai development, llm-powered task automation, ai-agent, cli-tool, automation

[View on SkillFed](https://skillfed.io/packages/openhands) · [View on PyPI](https://pypi.org/project/openhands/)