repowisegoogle/adk-python

Code health of google/adk-python

Repowise scores google/adk-python at 6.7 out of 10 for code health, which reads as fair, alongside maintainability 7.9 and static performance 9.8 on the same scale. There are 6,303 open findings across the three pillars, and the lowest-scoring file is functions.py at 1.0. Scores are computed from complexity, duplication, churn and git fix history, not from a linter.

Findings by severity

358 critical, 738 high, 1,758 medium, 3,233 low.

Hotspots

237 files are flagged as hotspots. The top 5:

  • tests/unittests/artifacts/test_artifact_service.py: 11 commits in the last 90 days from 6 contributors with 10 recent bug fixes
  • tests/unittests/agents/test_remote_a2a_agent.py: 9 commits in the last 90 days from 5 contributors with 6 recent bug fixes
  • src/google/adk/plugins/bigquery_agent_analytics_plugin.py: 14 commits in the last 90 days from 4 contributors with 5 recent bug fixes
  • tests/unittests/flows/llm_flows/test_request_confirmation.py: 7 commits in the last 90 days from 5 contributors with 4 recent bug fixes
  • tests/unittests/tools/test_agent_tool.py: 9 commits in the last 90 days from 4 contributors with 8 recent bug fixes

Lowest-scoring files

  • src/google/adk/flows/llm_flows/functions.py: 1.0 out of 10 with 4 bug fixes in the last 180 days
  • src/google/adk/models/lite_llm.py: 1.0 out of 10 with 9 bug fixes in the last 180 days
  • src/google/adk/agents/llm_agent.py: 1.0 out of 10 with 5 bug fixes in the last 180 days
  • src/google/adk/a2a/converters/to_adk_event.py: 1.0 out of 10 with 4 bug fixes in the last 180 days
  • src/google/adk/sessions/database_session_service.py: 1.0 out of 10 with 6 bug fixes in the last 180 days

Checked against bug fixes

Of the 20 files Repowise scores lowest, 20 had a bug fix in the last 180 days. Across all 2,369 scored files, 70.2% had a bug fix in that window.

Dead code and refactoring

Repowise found 155 unused exports. 298 refactoring targets across 298 files would raise the score.

More on adk-python: summary and FAQ, codebase overview, architecture.

Related guide: Best dead code detection tools by language