Google ADK with PraisonAI

Run PraisonAI agents YAML with Google Agent Development Kit via praisonai-frameworks

framework: google_adk connects PraisonAI’s YAML and CLI to Google’s Agent Development Kit, running your tasks against Gemini models with a single install.

Quick Start

1. Install

   pip install "praisonai[google-adk]"

2. Set API Key

   export GOOGLE_API_KEY=your-key
   # or: export GEMINI_API_KEY=your-key

3. Create agents.yaml

   framework: google_adk
   topic: math
   roles:
     calculator:
       role: Calculator
       goal: Compute exactly
       backstory: Return only the numeric answer.
       tasks:
         add:
           description: What is 3 + 3?
           expected_output: "6"

4. Run

   praisonai agents.yaml --framework google_adk

How Google ADK Works

Every result begins with the sentinel prefix ### Google ADK Output ###. Downstream parsers can split on this to extract only the run output.

Capabilities

Models

Sequential Context (Task Chaining)

Tasks reference outputs of earlier tasks with context: [task_name]:

framework: google_adk
topic: numbers
roles:
  writer:
    role: Writer
    goal: Write numbers only
    backstory: Concise writer
    tasks:
      draft:
        description: Reply with only the number 3.
        expected_output: "3"
      polish:
        description: Add 3 to the previous result. Reply with only the number.
        expected_output: "6"
        context:
          - draft

Handoffs

Use handoff.to with a single router task; specialists are listed without tasks:

framework: google_adk
topic: language help
roles:
  triage:
    role: Triage Agent
    handoff:
      to:
        - English Agent
    tasks:
      route:
        description: Help with {topic}
  english:
    role: English Agent
    goal: Reply in English only
    backstory: English specialist.

Multi-task configs with handoff.to fall back to sequential execution (OpenAI parity).

Direct Adapter Use (Advanced)

Call the adapter without the CLI or YAML loader:

from praisonai_frameworks.google_adk.adapter import GoogleAdkAdapter

config = {
    "framework": "google_adk",
    "topic": "Quick test",
    "roles": {
        "helper": {
            "role": "Assistant",
            "goal": "Answer briefly",
            "backstory": "Helpful assistant",
            "tasks": {
                "answer": {
                    "description": "Reply with exactly the word OK.",
                    "expected_output": "OK",
                }
            },
        }
    },
}
llm_config = [{"model": "gemini-2.5-flash", "api_key": ""}]   # use $GOOGLE_API_KEY or $GEMINI_API_KEY
result = GoogleAdkAdapter().run(config, llm_config, "Quick test", tools_dict={})
# result starts with "### Google ADK Output ###"

Verify Installation

Check availability via praisonai doctor:

$ praisonai doctor
✓ Runtime 'google_adk' available
  name: Google ADK
  capabilities: agent_creation, tool_execution, sequential_execution, handoff, tool_loop

Or check from Python:

from praisonai._framework_availability import is_available

if is_available("google_adk"):
    print("Google ADK is installed and importable")

_google_adk_probe() checks three things in order:

1. importlib.metadata.distribution("google-adk") — the PyPI dist must be installed.
2. importlib.util.find_spec("google.adk") — the google.adk import namespace must be discoverable.
3. from google.adk.agents import Agent or from google.adk import Agent — the ADK’s Agent symbol must import without error (tries the submodule path first, falls back to the package root for older ADK layouts).

True from is_available("google_adk") guarantees the adapter can run, not just that the package is on disk.

Pip Extras Reference

Troubleshooting

framework='google_adk' is not a valid choice — you are running a pre-PR-#2506 PraisonAI version. Upgrade: pip install -U praisonai.

Framework 'google_adk' was requested but is not installed — run pip install 'praisonai[google-adk]' (from your project rather than praisonai-frameworks[google-adk] alone, so praisonai-tools is also pulled in).

ValueError: framework='google_adk' in workflow YAML is not supported for workflow execution — switch the file to the roles: agents.yaml shape used in the Quick Start above.

google.adk imports successfully but is_available("google_adk") returns False — the probe also requires google-adk to be visible to importlib.metadata.distribution(...). If the package was installed in editable or namespace-only mode without a real dist-info, the probe refuses. Install the published google-adk PyPI package.

API key not found — set either GOOGLE_API_KEY or GEMINI_API_KEY. The adapter checks GOOGLE_API_KEY first; if absent it falls back to GEMINI_API_KEY. If both are set, GOOGLE_API_KEY wins.

Best Practices

Related