docs: Fix Helloworld Quick Start and document uv non-project alternative#641
Conversation
There was a problem hiding this comment.
Code Review
This pull request updates the README documentation to provide alternative setup and execution instructions using standard pip and virtualenv (Option A) alongside the existing uv-based instructions (Option B). The review feedback points out that the instructions for running the host/test clients are missing in both options, and suggests adding these steps to ensure the guides are complete and actionable.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
Description
This PR resolves issue #635 where the root README Quick Start for the Python helloworld sample was conflicting with
uv's parent project traversal.Since
helloworlddoes not contain apyproject.tomlfile (by design, to favor standardrequirements.txt/ pip environments), runninguv runinside the folder triggers resolution using the parent project'ssamples/python/pyproject.tomland locks the environment, leading to aModuleNotFoundErroron startup.Changes
python -m venv .venv) and install dependencies using standardpip(pip install -r requirements.txt).pip+ virtualenv) and Option B (uvforpyproject.tomlprojects).requirements.txtsamples withuvusing non-project mode (uv venvanduv pip install).Verification
python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txtbuilds the virtual environment with the correct SDK version (a2a-sdk>=1.1.0) and starts the server successfully.