{"id":45695,"library":"openhands","title":"OpenHands CLI","description":"OpenHands CLI is a terminal user interface (TUI) for the OpenHands AI agent, enabling interactive development and deployment workflows. Current version is 1.16.0, requiring Python 3.12 exactly. Released on PyPI with frequent updates.","status":"active","version":"1.16.0","language":"python","source_language":"en","source_url":"https://github.com/All-Hands-AI/OpenHands","tags":["cli","ai-agent","terminal","llm","openhands"],"install":[{"cmd":"pip install openhands","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Requires Python 3.12.* exactly","package":"python","optional":false}],"imports":[{"wrong":"from openhands import OpenHands","symbol":"OpenHands","correct":"from openhands_cli import OpenHands"}],"quickstart":{"code":"from openhands import OpenHands\nimport os\nagent = OpenHands(api_key=os.environ.get('OPENHANDS_API_KEY', ''))\nresponse = agent.run('Hello, OpenHands!')\nprint(response)","lang":"python","description":"Initialize the OpenHands agent with an API key (or set OPENHANDS_API_KEY env var) and run a prompt."},"warnings":[{"fix":"Replace `OpenHandsCLI` with `OpenHands` in imports and instantiations.","message":"Version 1.14.0 renamed the main class from `OpenHandsCLI` to `OpenHands`. Code using the old class name will break.","severity":"breaking","affected_versions":">=1.14.0"},{"fix":"Use Python 3.12 if using this library. Consider using a version manager (e.g., pyenv) to manage Python versions.","message":"Requires Python 3.12 exactly. Will not install on Python 3.11 or 3.13.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Set the OPENHANDS_API_KEY environment variable or pass `api_key` parameter. Use `OpenHands(api_key='your-key')`.","message":"API key is mandatory unless running in local mode. Missing key causes authentication errors silently.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.16.0':25 '3.12':28 'agent':15,39 'ai':14,38 'ai-ag':37 'cli':2,4,36 'current':22 'deploy':20 'develop':18 'enabl':16 'exact':29 'frequent':34 'interact':17 'interfac':9 'llm':41 'openhand':1,3,13,42 'pypi':32 'python':27 'releas':30 'requir':26 'termin':7,40 'tui':10 'updat':35 'user':8 'version':23 'workflow':21","created_at":"2026-06-07T12:56:16.660891+00:00","updated_at":"2026-06-07T12:56:16.660891+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'OpenHands' from 'openhands_cli' (/tmp/tmptopwix07/venv/lib/python3.12/site-packages/openhands_cli/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}