Skip to content

Conversation

@xingyaoww
Copy link
Contributor

  • I have read and reviewed the documentation changes to the best of my ability.
  • If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

This PR adds the --python 3.12 flag to all uv tool install openhands and uv tool upgrade openhands commands throughout the documentation. This ensures users install OpenHands with Python 3.12, preventing the version 0.0.0 installation issue that occurs when using unsupported Python versions (like Python 3.11).

Changes Made

Updated 4 documentation files with 8 total changes:

  1. openhands/usage/run-openhands/cli-mode.mdx (3 updates)

    • Install command in "Using uv (recommended)" tab
    • Upgrade command in "Using uv (recommended)" tab
    • Docker command that runs uv tool install
  2. openhands/usage/run-openhands/gui-mode.mdx (1 update)

    • Prerequisites section mentioning quick install command
  3. openhands/usage/run-openhands/local-setup.mdx (2 updates)

    • Install command in "Option 1: Using the CLI Launcher with uv"
    • Upgrade command in the same section
  4. openhands/usage/windows-without-wsl.mdx (2 updates)

    • Install command for Windows without WSL
    • Upgrade command for Windows without WSL

Context

Users have been reporting getting version 0.0.0 when installing OpenHands CLI without specifying the Python version. This issue is related to using Python versions outside the supported range. By explicitly specifying --python 3.12, we ensure a consistent and working installation experience for all users.

@xingyaoww can click here to continue refining the PR

This ensures users install OpenHands with Python 3.12, preventing the
version 0.0.0 installation issue that occurs when using unsupported
Python versions.

Updated files:
- openhands/usage/run-openhands/cli-mode.mdx
- openhands/usage/run-openhands/gui-mode.mdx
- openhands/usage/run-openhands/local-setup.mdx
- openhands/usage/windows-without-wsl.mdx

All instances of 'uv tool install openhands' and 'uv tool upgrade openhands'
now include the '--python 3.12' flag.
@xingyaoww xingyaoww marked this pull request as ready for review December 4, 2025 21:21
@xingyaoww xingyaoww requested a review from mamoodi as a code owner December 4, 2025 21:21
Copy link
Contributor

@malhotra5 malhotra5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@xingyaoww xingyaoww merged commit 19b76bb into main Dec 4, 2025
2 checks passed
@xingyaoww xingyaoww deleted the add-python-version-to-uv-install branch December 4, 2025 21:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants