github/OpenHands
1
0
Fork 0
mirror of https://github.com/OpenHands/OpenHands.git synced 2025-12-26 13:52:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
OpenHands/openhands-cli
History
Engel Nyst b83e2877ec
CLI: align with agent-sdk renames (#11643) 
Co-authored-by: openhands <openhands@all-hands.dev>
Co-authored-by: rohitvinodmalhotra@gmail.com <rohitvinodmalhotra@gmail.com>
2025-11-07 11:30:37 -05:00
..
hooks
CLI(V1) (#11220)
2025-10-04 17:14:36 -04:00
openhands_cli
CLI: align with agent-sdk renames (#11643)
2025-11-07 11:30:37 -05:00
tests
CLI: align with agent-sdk renames (#11643)
2025-11-07 11:30:37 -05:00
.gitignore
CLI: align with agent-sdk renames (#11643)
2025-11-07 11:30:37 -05:00
build.py
CLI: align with agent-sdk renames (#11643)
2025-11-07 11:30:37 -05:00
build.sh
CLI(V1) (#11220)
2025-10-04 17:14:36 -04:00
Makefile
CLI(V1) (#11220)
2025-10-04 17:14:36 -04:00
openhands.spec
CLI: align with agent-sdk renames (#11643)
2025-11-07 11:30:37 -05:00
pyproject.toml
CLI: align with agent-sdk renames (#11643)
2025-11-07 11:30:37 -05:00
README.md
Fix deprecated links (#11605)
2025-11-01 12:37:32 -04:00
uv.lock
CLI: align with agent-sdk renames (#11643)
2025-11-07 11:30:37 -05:00

README.md

OpenHands V1 CLI

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

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