Skip to content

README dependency versions diverge from sample manifests #263

Description

@dajiaohuang

Description

Eight tracked README files contain 18 dependency-version statements or install commands that contradict the dependency manifest in the same sample directory.

Confirmed groups at commit 0890278a6571e4190c1ab8cacd9becc147f74d9c:

  1. python/01-tutorials/01-agentkit-runtime/image_video_tools/README.md and README_en.md
    • README: AgentKit 0.5.10, Google ADK 1.32.0, VeADK 0.5.37
    • pyproject.toml: AgentKit 0.8.1, Google ADK 2.2.0, VeADK 1.0.10
  2. python/02-use-cases/ad_video_gen/README.md and README_en.md
    • README: AgentKit 0.5.10 and VeADK 0.5.37
    • pyproject.toml: AgentKit 0.8.1 and VeADK 1.0.10
  3. python/02-use-cases/partners/video_breakdown_agent/README.md
    • install examples: AgentKit 0.5.1
    • pyproject.toml: AgentKit 0.8.1
  4. python/02-use-cases/travel_planner/README.md and README_en.md
    • install examples: AgentKit 0.3.2
    • requirements.txt: AgentKit 0.8.1
  5. python/02-use-cases/video_breakdown_agent/README.md
    • install examples: AgentKit 0.5.1
    • pyproject.toml: AgentKit 0.8.1

The bilingual copies repeat the same stale versions, so updating only one language would leave the documented setup inconsistent.

Reproduction

Compare each version table/install command above with the colocated pyproject.toml or requirements.txt. A repository-wide exact-version extraction reports 18 stale occurrences across the eight README files.

Expected behavior

README dependency tables and manual installation commands should match the authoritative manifest used by the sample, or avoid duplicating exact versions when the manifest is intentionally the single source of truth.

Impact

Users following the README can construct an environment substantially older than the sample code and lock/configuration expect, including major-version differences for Google ADK and VeADK.

Duplicate check

Open/closed issues, all PR states, relevant commit history, and version/root-cause terms were searched. Open PR #240 changes several dependency manifests but does not update these README claims, so it is a related moving dependency change rather than an equivalent documentation fix.

Why there is no PR in this audit

PR #240 may change the target manifest versions again. Updating the READMEs to the current baseline while that dependency upgrade is unresolved could immediately make them stale a second time or conflict with the maintainer's intended versions. Once the manifest target is settled, all eight localized/source documents should be updated together and checked by a manifest-vs-doc consistency test.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions