utilityOfficialgoogle-adkpython
Adk Facts (Official Sample)
59by 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
-
Navigate to the samples directory:
cd samples/python/agents/adk_facts -
Install Requirements
pip install -r requirements.txt -
Create a
.envfile with your Gemini API Key:echo "GOOGLE_API_KEY=your_api_key_here" > .env -
Run the A2A agent:
uvicorn agent:a2a_app --host localhost --port 8001 -
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