StackA2A
utilityOfficialgoogle-adkpython

Adk Facts (Official Sample)

59

by A2A Project

Official A2A python sample agent: Adk Facts

1,329 starsUpdated 2026-02-22apache-2.0
Quality Score59/100
Community
70
Freshness
100
Official
100
Skills
10
Protocol
30
🔒 Security
20

Getting Started

1Clone the repository
$ git clone https://github.com/a2aproject/a2a-samples
2Navigate to the project
$ cd a2a-samples/samples/python/agents/adk_facts
3Install dependencies
$ pip install -r requirements.txt
4Run the agent
$ python main.py

README

ADK Agent

This sample uses the Agent Development Kit (ADK) to create a simple fun facts generator which communicates using A2A.

Prerequisites

  • Python 3.10 or higher
  • Access to an LLM and API Key

Running the Sample

  1. Navigate to the samples directory:

    cd samples/python/agents/adk_facts
    
  2. Install Requirements

    pip install -r requirements.txt
    
  3. Create a .env file with your Gemini API Key:

    echo "GOOGLE_API_KEY=your_api_key_here" > .env
    
  4. Run the A2A agent:

    uvicorn agent:a2a_app --host localhost --port 8001
    
  5. Run the ADK Web Server

    # In a separate terminal, run the adk web server
    adk web samples/python/agents/
    

In the Web UI, select the adk_facts agent.

Deploy to Google Cloud Run

gcloud run deploy sample-a2a-agent \
    --port=8080 \
    --source=. \
    --allow-unauthenticated \
    --region="us-central1" \
    --project=$GOOGLE_CLOUD_PROJECT \
    --set-env-vars=GOOGLE_CLOUD_PROJECT=$GOOGLE_CLOUD_PROJECT,GOOGLE_CLOUD_LOCATION=us-central1,GOOGLE_GENAI_USE_VERTEXAI=true

Capabilities

StreamingPush NotificationsMulti-TurnAuth: none
official-samplepython

Part of these stacks

View on GitHub