Skip to content

$ adk throws ModuleNotFoundError: No module named 'deprecated' exception on Python 3.12.8 google-adk==0.3.0 #2647

@toransahu

Description

@toransahu

Describe the bug
Command $ adk throws ModuleNotFoundError: No module named 'deprecated' exception on Python 3.12.8 google-adk==0.3.0. However it should have shown the help message without any exception.

To Reproduce

Steps to reproduce the behavior:

  1. Env
$ uname -a
Darwin toran9G4CXDm 24.4.0 Darwin Kernel Version 24.4.0: Fri Apr 11 18:32:50 PDT 2025; root:xnu-11417.101.15~117/RELEASE_ARM64_T6041 arm64 arm Darwin
$ python --version
Python 3.12.8
(.venv)
$ pip show google-adk
Name: google-adk
Version: 0.3.0
Summary: Agent Development Kit
Home-page: https://google.github.io/adk-docs/
Author:
Author-email: Google LLC <googleapis-packages@google.com>
License:
Location: /Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages
Requires: authlib, click, fastapi, google-api-python-client, google-cloud-aiplatform, google-cloud-secret-manager, google-cloud-speech, google-cloud-storage, google-genai, graphviz, mcp, opentelemetry-api, opentelemetry-exporter-gcp-trace, opentelemetry-sdk, pydantic, python-dotenv, PyYAML, sqlalchemy, tzlocal, uvicorn
Required-by:
  1. Install
(.venv)
$ pip install google-adk==0.3.0
  1. Run
(.venv)
$ adk
  1. See error
$ adk
Traceback (most recent call last):
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/bin/adk", line 4, in <module>
    from google.adk.cli import main
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/__init__.py", line 16, in <module>
    from .agents.llm_agent import Agent
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/agents/__init__.py", line 15, in <module>
    from .base_agent import BaseAgent
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/agents/base_agent.py", line 32, in <module>
    from ..events.event import Event
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/events/__init__.py", line 15, in <module>
    from .event import Event
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/events/event.py", line 25, in <module>
    from ..models.llm_response import LlmResponse
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/models/__init__.py", line 19, in <module>
    from .llm_request import LlmRequest
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/models/llm_request.py", line 24, in <module>
    from ..tools.base_tool import BaseTool
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/tools/__init__.py", line 15, in <module>
    from .base_tool import BaseTool
  File "/Users/toran/disk/E/workspace/github.com/toransahu/agentic-ai-eg/.venv/lib/python3.12/site-packages/google/adk/tools/base_tool.py", line 23, in <module>
    from deprecated import deprecated
ModuleNotFoundError: No module named 'deprecated'

Expected behavior

Help message without any exception

(.venv)
$ adk
Usage: adk [OPTIONS] COMMAND [ARGS]...

  Agent Development Kit CLI tools.

Options:
  --help  Show this message and exit.

Commands:
  api_server  Starts a FastAPI server for agents.
  create      Creates a new app in the current folder with...
  deploy      Deploys agent to hosted environments.
  eval        Evaluates an agent given the eval sets.
  run         Runs an interactive CLI for a certain agent.
  web         Starts a FastAPI server with Web UI for agents.

Desktop (please complete the following information):

  • OS: macOS
  • Python version(python -V): 3.12.8
  • ADK version(pip show google-adk): 0.3.0

Metadata

Metadata

Assignees

Labels

bot triaged[Bot] This issue is triaged by ADK bottools[Component] This issue is related to tools

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions