Quick start: Google ADK + A2A in 5 minutes

Prerequisites

Docker — the entire system runs in containers. You don’t need Python or additional dependencies on your machine.
Gemini API key — the system uses Gemini 2.5 Flash as the base model for all 7 agents.

Installation

Clone the repository:

git clone https://github.com/nneira/google-adk-a2a-idp.git
cd google-adk-a2a-idp

Configure your API key as an environment variable:
```
export GEMINI_API_KEY="your-api-key-here"
```
Build the Docker image:
```
docker build -t adk-agents:hybrid .
```
This step takes a few minutes the first time — it downloads all dependencies inside the container.

Automatic mode — end-to-end pipeline

The 7 agents run in sequence with no human intervention. You’ll see each agent’s progress in the terminal in real time.

./start-demo-nicolasneira.sh "Build IDP for Python FastAPI apps"

When done (~4.5 min), the 21 files will be in test-outputs/idp-adk-sequential/.

The prompt defines the stack. The Platform Architect analyzes it and makes real decisions on each run:

# Python stack with FastAPI
./start-demo-nicolasneira.sh "Build IDP for Python FastAPI apps"

# Go stack with Gin and PostgreSQL
./start-demo-nicolasneira.sh "Build IDP for Go microservices with PostgreSQL"

# With specific deploy preferences
./start-demo-nicolasneira.sh "Build IDP for Node.js apps, deploy to Google Cloud"

The same task can produce different stacks between runs — the model reasons, it doesn’t fill a template.

Interactive mode — web interface at localhost:8000

Chat with each agent individually from the browser. Ideal for exploring each agent’s decisions, changing the stack during the session or understanding step by step how the system works.

./start-interactive-nicolasneira.sh

Then open http://localhost:8000 in your browser.

From the interface you can:

Select a specific agent from the system
Send requests in natural language
See decisions in real time as they’re made
Change the stack during the conversation (the Architect adapts its recommendations)
Test the Security Agent’s behavior when previous agents haven’t run

Verify it worked

After automatic mode, verify the files were generated:

ls test-outputs/idp-adk-sequential/

You should see: platform-config.yaml, docker-compose/, security-report.json, cicd/, grafana-dashboards/, cli-tool/, portal/, orchestration-report.json.

Launch the generated infrastructure

Once the files are generated, you can launch the entire infrastructure with a single command:

cd test-outputs/idp-adk-sequential
docker-compose -f docker-compose/app-stack.yml up -d

Available services:

Service	URL
IDP web portal	`http://localhost:8001`
Grafana (pre-configured dashboards)	`http://localhost:3000`
Jenkins (configured CI/CD pipeline)	`http://localhost:8080`