Inicio rápido: Google ADK + A2A en 5 minutos

Prerrequisitos

Docker — todo el sistema corre en contenedores. No necesitas Python ni dependencias adicionales en tu máquina.
Gemini API key — el sistema usa Gemini 2.5 Flash como modelo base para los 7 agentes.

Instalación

Clona el repositorio:

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

Configura tu API key como variable de entorno:
```
export GEMINI_API_KEY="tu-api-key-aqui"
```
Construye la imagen Docker:
```
docker build -t adk-agents:hybrid .
```
Este paso tarda unos minutos la primera vez — descarga todas las dependencias dentro del contenedor.

Modo automático — pipeline end-to-end

Los 7 agentes corren en secuencia sin intervención humana. Verás el progreso de cada agente en la terminal en tiempo real.

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

Al terminar (~4.5 min), los 21 archivos estarán en test-outputs/idp-adk-sequential/.

El prompt define el stack. El Platform Architect lo analiza y toma decisiones reales en cada ejecución:

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

# Stack Go con Gin y PostgreSQL
./start-demo-nicolasneira.sh "Build IDP for Go microservices with PostgreSQL"

# Con preferencias de deploy específicas
./start-demo-nicolasneira.sh "Build IDP for Node.js apps, deploy to Google Cloud"

La misma tarea puede producir stacks diferentes entre ejecuciones — el modelo razona, no rellena un template.

Modo interactivo — interfaz web en localhost:8000

Conversa con cada agente individualmente desde el navegador. Ideal para explorar las decisiones de cada agente, cambiar el stack durante la sesión o entender paso a paso cómo funciona el sistema.

./start-interactive-nicolasneira.sh

Luego abre http://localhost:8000 en tu navegador.

Desde la interfaz puedes:

Seleccionar un agente específico del sistema
Enviar solicitudes en lenguaje natural
Ver las decisiones en tiempo real mientras se toman
Cambiar el stack durante la conversación (el Arquitecto adapta sus recomendaciones)
Probar el comportamiento del Security Agent cuando los agentes anteriores no han corrido

Verificar que funcionó

Después del modo automático, verifica que los archivos se generaron:

ls test-outputs/idp-adk-sequential/

Deberías ver: platform-config.yaml, docker-compose/, security-report.json, cicd/, grafana-dashboards/, cli-tool/, portal/, orchestration-report.json.

Levantar la infraestructura generada

Una vez generados los archivos, puedes levantar toda la infraestructura con un solo comando:

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

Servicios disponibles:

Servicio	URL
Portal web IDP	`http://localhost:8001`
Grafana (dashboards pre-configurados)	`http://localhost:3000`
Jenkins (pipeline CI/CD configurado)	`http://localhost:8080`