Conversation
Signed-off-by: Ken Ocheltree <kochel@us.ibm.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
dosubot
bot
added
the
size:XS
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request updates the Python version from 3.13 to 3.14 in the quickstart documentation for both development and stable releases. Review feedback highlights that Python 3.14 is currently an alpha release and should not be recommended in documentation, as it may lead to installation issues and environment instability. It is suggested to update the agentstack-cli package metadata to support stable Python versions instead of requiring an experimental one.
|
|
||
| ```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 |
There was a problem hiding this comment.
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.
|
|
||
| ```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 |
There was a problem hiding this comment.
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.
|
|
||
| ```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 |
There was a problem hiding this comment.
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.
1 participant
Summary
When the quickstart is used, it will only install v0.6.3 due to the specified v3.13 of Python. Changing this to Pyhton V3.14 allows v0.7.1 agnetstack to be installed
Linked Issues
#2495
Documentation
If this PR adds new feature or changes existing. Make sure documentation is adjusted accordingly. If the docs is not needed, please explain why.