Skip to content

Update to python v3.14 in Quickstart #2507

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JanPokorny merged 1 commit into from
Apr 3, 2026
+4 −4
Merged

Update to python v3.14 in Quickstart #2507

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/development/introduction/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ On Linux, Lima requires QEMU. Install it via these ([instructions](https://www.q
Open a new terminal and run:

```bash
uv python install --quiet --python-preference=only-managed --no-bin 3.13 && uv tool install --refresh --force --python-preference=only-managed --python=3.13 agentstack-cli && agentstack self install
uv python install --quiet --python-preference=only-managed --no-bin 3.14 && uv tool install --refresh --force --python-preference=only-managed --python=3.14 agentstack-cli && agentstack self install
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot Apr 2, 2026

Choose a reason for hiding this comment

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

medium

Python 3.14 is currently an experimental/pre-release version (alpha) and is not scheduled for a stable release until late 2025. Recommending an unstable Python version in a Quickstart guide is highly unusual and may lead to installation failures or environment instability for users. If agentstack-cli v0.7.1 is failing to install on Python 3.13, it is likely due to an overly restrictive Requires-Python metadata in the package itself. The recommended approach is to correct the package metadata to support stable Python versions (e.g., >=3.10) rather than requiring users to install an alpha version of Python.

```

Follow the interactive prompts to finish setup and optionally start the VM.
Expand Down Expand Up @@ -161,7 +161,7 @@ This will make local agents accessible over the local network, which is needed f
Run in PowerShell:

```bash
uv python install --quiet --python-preference=only-managed --no-bin 3.13; uv tool install --refresh --force --python-preference=only-managed --python=3.13 agentstack-cli; agentstack self install
uv python install --quiet --python-preference=only-managed --no-bin 3.14; uv tool install --refresh --force --python-preference=only-managed --python=3.14 agentstack-cli; agentstack self install
```

Follow the interactive prompts to finish the installation and setup.
Expand Down
4 changes: 2 additions & 2 deletions docs/stable/introduction/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ On Linux, Lima requires QEMU. Install it via these ([instructions](https://www.q
Open a new terminal and run:

```bash
uv python install --quiet --python-preference=only-managed --no-bin 3.13 && uv tool install --refresh --force --python-preference=only-managed --python=3.13 agentstack-cli && agentstack self install
uv python install --quiet --python-preference=only-managed --no-bin 3.14 && uv tool install --refresh --force --python-preference=only-managed --python=3.14 agentstack-cli && agentstack self install
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot Apr 2, 2026

Choose a reason for hiding this comment

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

medium

Recommending Python 3.14 in the stable documentation is risky as it is not yet a stable release. This may cause significant friction for new users attempting to follow the Quickstart. It is strongly recommended to investigate why the package requires 3.14 and fix the dependency constraints in the package metadata instead.

```

Follow the interactive prompts to finish setup and optionally start the VM.
Expand Down Expand Up @@ -161,7 +161,7 @@ This will make local agents accessible over the local network, which is needed f
Run in PowerShell:

```bash
uv python install --quiet --python-preference=only-managed --no-bin 3.13; uv tool install --refresh --force --python-preference=only-managed --python=3.13 agentstack-cli; agentstack self install
uv python install --quiet --python-preference=only-managed --no-bin 3.14; uv tool install --refresh --force --python-preference=only-managed --python=3.14 agentstack-cli; agentstack self install
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot Apr 2, 2026

Choose a reason for hiding this comment

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

medium

Consistent with other sections, using Python 3.14 (alpha) in PowerShell instructions for a stable release guide is discouraged. Please consider reverting to a stable Python version like 3.13 once the package metadata is corrected.

```

Follow the interactive prompts to finish the installation and setup.
Expand Down
Loading