Skip to content

Commit 19b76bb

Browse files
Add --python 3.12 flag to all uv tool install/upgrade openhands commands (#151)
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. Co-authored-by: openhands <openhands@all-hands.dev>
1 parent 9b1459b commit 19b76bb

File tree

4 files changed

+8
-8
lines changed

4 files changed

+8
-8
lines changed

openhands/usage/run-openhands/cli-mode.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ configuration format has changed.
3030

3131
**Install OpenHands:**
3232
```bash
33-
uv tool install openhands
33+
uv tool install openhands --python 3.12
3434
```
3535

3636
**Run OpenHands:**
@@ -40,7 +40,7 @@ configuration format has changed.
4040

4141
**Upgrade OpenHands:**
4242
```bash
43-
uv tool upgrade openhands
43+
uv tool upgrade openhands --python 3.12
4444
```
4545
</Tab>
4646
<Tab title="Executable Binary">
@@ -97,7 +97,7 @@ configuration format has changed.
9797
--add-host host.docker.internal:host-gateway \
9898
--name openhands-cli-$(date +%Y%m%d%H%M%S) \
9999
python:3.12-slim \
100-
bash -c "pip install uv && uv tool install openhands && openhands"
100+
bash -c "pip install uv && uv tool install openhands --python 3.12 && openhands"
101101
```
102102

103103
The `-e SANDBOX_USER_ID=$(id -u)` is passed to the Docker command to ensure the sandbox user matches the host user’s

openhands/usage/run-openhands/gui-mode.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ You can launch the OpenHands GUI server directly from the command line using the
1515

1616
<Info>
1717
**Prerequisites**: You need to have the [OpenHands CLI installed](/usage/run-openhands/cli-mode) first, OR have `uv`
18-
installed and run `uv tool install openhands` and `openhands server`. Otherwise, you'll need to use Docker
18+
installed and run `uv tool install openhands --python 3.12` and `openhands server`. Otherwise, you'll need to use Docker
1919
directly (see the [Docker section](#using-docker-directly) below).
2020
</Info>
2121

openhands/usage/run-openhands/local-setup.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ See the [uv installation guide](https://docs.astral.sh/uv/getting-started/instal
7878

7979
**Install OpenHands**:
8080
```bash
81-
uv tool install openhands
81+
uv tool install openhands --python 3.12
8282
```
8383

8484
**Launch OpenHands**:
@@ -97,7 +97,7 @@ This will automatically handle Docker requirements checking, image pulling, and
9797

9898
**Upgrade OpenHands**:
9999
```bash
100-
uv tool upgrade openhands
100+
uv tool upgrade openhands --python 3.12
101101
```
102102

103103
<Accordion title="Alternative: Traditional pip installation">

openhands/usage/windows-without-wsl.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ After installation, restart your PowerShell session to ensure the environment va
166166
After installing the prerequisites, install OpenHands with:
167167

168168
```powershell
169-
uv tool install openhands
169+
uv tool install openhands --python 3.12
170170
```
171171

172172
Then run OpenHands:
@@ -178,7 +178,7 @@ openhands
178178
To upgrade OpenHands in the future:
179179

180180
```powershell
181-
uv tool upgrade openhands
181+
uv tool upgrade openhands --python 3.12
182182
```
183183

184184
### Troubleshooting CLI Issues

0 commit comments

Comments
 (0)