Skip to main content
The OpenHands CLI is no longer actively maintained. These instructions are retained for legacy users. For a maintained local installation, use Agent Canvas with npm, npx, or Docker.
Windows users: All commands below should be run inside the WSL terminal (Ubuntu). Use wsl -d Ubuntu in PowerShell or search “Ubuntu” in the Start menu to access the Ubuntu terminal. We also have a step-by-step video tutorial available.

Legacy CLI Installation Methods

Requires Python 3.12+ and uv 0.11.6 or newer.Install OpenHands:
Run OpenHands:
Upgrade OpenHands:

First Run

The first time you run the CLI, it will take you through configuring the required LLM settings. These will be saved for future sessions in ~/.openhands/agent_settings.json. CLI preferences are stored in ~/.openhands/cli_config.json, and MCP server configuration is stored in ~/.openhands/mcp.json. The conversation history will be saved in ~/.openhands/conversations.
If you’re upgrading from a CLI version before release 1.0.0, you’ll need to redo your settings setup as the configuration format has changed.

Next Steps