Skip to content

openhands-cli

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

openhands-cli

README.md

OpenHands V1 CLI

A lightweight, modern CLI to interact with the OpenHands agent (powered by agent-sdk).

The OpenHands V0 CLI (legacy) is being deprecated.

Quickstart

  • Prerequisites: Python 3.12+, curl
  • Install uv (package manager): 
    curl -LsSf https://astral.sh/uv/install.sh | sh # Restart your shell so "uv" is on PATH, or follow the installer hint

Run the CLI locally

make install # Start the CLI make run # or uv run openhands

Build a standalone executable

# Build (installs PyInstaller if needed) ./build.sh --install-pyinstaller # The binary will be in dist/ ./dist/openhands # macOS/Linux # dist/openhands.exe # Windows