Caracteristicas y Especificaciones
Agents-ADK es una arquitectura híbrida que orquesta Google ADK (Agent Development Kit) dentro de un contenedor Docker, mientras Ollama corre nativamente en el host para aprovechar al máximo la GPU vía drivers NVIDIA. La comunicación entre ambos se resuelve con LiteLLM como capa de integración unificada y network_mode: host para que el contenedor pueda alcanzar la API de Ollama en localhost:11434.
El resultado: una aplicación conversacional con interfaz web en localhost:8000, aceleración GPU nativa y un entorno completamente reproducible con docker compose up --build -d
Tres agentes, tres casos de uso
El repositorio incluye tres implementaciones que demuestran la versatilidad del framework
| Agente | Propósito | Lo que demuestra |
|---|---|---|
| Cybersecurity Tutor | Asistente pedagógico en seguridad informática | Metodologías PTES/OWASP, analizadores de herramientas y patrones de aprendizaje activo |
| CV Analyst | Experto en reclutamiento para análisis de CV | Metodología STAR, optimización ATS y evaluación de perfiles |
| Pokédex Agent | Demostración minimalista | Integración con APIs externas (PokéAPI) y uso básico de herramientas |
Cada agente sigue el patrón estándar de la clase ADKAgent de Google y se sirve vía CLI de ADK.
Tecnologías y decisiones de arquitectura
- Python 3.11+ con
uvpara gestión ultrarrápida de dependencias - Docker Compose para entornos reproducibles y despliegue en un solo comando
- SQLite como backend de persistencia, con volúmenes Docker que preservan los datos entre reconstrucciones
- Variables de entorno para configuración flexible en diferentes entornos
- Google ADK v1.14.1+ como framework orquestador de agentes
Resultado
Un sistema listo para producción que demuestra mi capacidad para:
- Diseñar arquitecturas híbridas que optimizan recursos (GPU + contenedores)
- Integrar frameworks de Google con herramientas open-source como Ollama y LiteLLM
- Construir agentes conversacionales con casos de uso reales y diferenciales
- Entregar software reproducible, documentado y escalable desde el primer commit
Para conocer mas:
¿Interesado en la implementación? Explora el código fuente y la documentación detallada del proyecto en mi repositorio de GitHub.
Ver codigo del proyecto