Welcome to the Gemma-4 DevOps Agents workspace. This repository contains nine specialized, self-hosted AI-driven DevOps/SRE agents powered by Google's Gemma 4 model. These agents are packaged as Model Context Protocol (MCP) servers to analyze, monitor, and troubleshoot infrastructure components.
This workspace is organized into 31 distinct sub-agents, each tailored to a specific environment, model configuration, and serving stack:
| Sub-Agent Directory | Purpose / Role | Model Configuration | Serving Engine | Target Infrastructure |
|---|---|---|---|---|
| g2-4-12B-qat-L4-devops-agent | Serverless cloud SRE leveraging the 12B parameter QAT model on L4 GPU via Cloud Run Gen2. | google/gemma-4-12B-it-qat-w4a16-ct |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-12B-6000-devops-agent | Serverless cloud SRE running the 12B configuration on an NVIDIA RTX 6000 GPU. | gemma-4-12B-it |
vLLM | Google Cloud Run (RTX 6000 GPU) |
| gpu-12B-L4-devops-agent | Serverless cloud SRE running the 12B configuration on an NVIDIA L4 GPU. | gemma-4-12B-it |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-12B-qat-L4-devops-agent | Serverless cloud SRE running the 12B QAT configuration on an NVIDIA L4 GPU. | google/gemma-4-12B-it-qat-w4a16-ct |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-12B-qat-mtp-6000-devops-agent | Serverless cloud SRE running the 12B QAT configuration with Multi-Token Prediction (MTP) on an RTX 6000 GPU. | google/gemma-4-12B-it-qat-w4a16-ct |
vLLM | Google Cloud Run (RTX 6000 GPU) |
| gpu-12B-qat-mtp-L4-devops-agent | Serverless cloud SRE running the 12B QAT configuration with Multi-Token Prediction (MTP) on an NVIDIA L4 GPU. | google/gemma-4-12B-it-qat-w4a16-ct |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-26B-6000-devops-agent | Serverless cloud SRE running the 26B configuration on an NVIDIA RTX 6000 GPU. | google/gemma-4-26B-it |
vLLM | Google Cloud Run (RTX 6000 GPU) |
| gpu-26B-L4-devops-agent | Serverless cloud SRE running the 26B configuration on an NVIDIA L4 GPU. | nvidia/gemma-4-26B-A4B-NVFP4 |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-26B-qat-L4-devops-agent | Serverless cloud SRE leveraging the 26B QAT configuration on an NVIDIA L4 GPU. | google/gemma-4-26B-A4B-it-qat-w4a16-ct |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-31B-6000-devops-agent | Serverless cloud SRE running the 31B configuration on an NVIDIA RTX 6000 GPU. | google/gemma-4-31B-it |
vLLM | Google Cloud Run (RTX 6000 GPU) |
| gpu-31B-L4-devops-agent | Serverless cloud SRE running the 31B NVFP4 quantized configuration on an NVIDIA L4 GPU. | nvidia/Gemma-4-31B-IT-NVFP4 |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-31B-qat-L4-devops-agent | Serverless cloud SRE leveraging the 31B QAT configuration on an NVIDIA L4 GPU. | google/gemma-4-31B-it-qat-w4a16-ct |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-4B-6000-devops-agent | Serverless cloud SRE running the 4B configuration on an NVIDIA RTX 6000 GPU. | google/gemma-4-E4B-it |
vLLM | Google Cloud Run (RTX 6000 GPU) |
| gpu-4B-L4-devops-agent | Serverless cloud SRE running the 4B configuration on an NVIDIA L4 GPU. | google/gemma-4-E4B-it |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-4B-qat-L4-devops-agent | Serverless cloud SRE leveraging the 4B QAT configuration on an NVIDIA L4 GPU. | google/gemma-4-E4B-it-qat-w4a16-ct |
vLLM | Google Cloud Run (L4 GPU) |
| gpu-6000-devops-agent | Cloud-based SRE managing GPU-accelerated serverless endpoints (RTX 6000 GPU configuration). | google/gemma-4-E4B-it |
vLLM | Google Cloud Run (RTX 6000 GPU) |
| gpu-vllm-devops-agent | Cloud-based SRE managing GPU-accelerated serverless endpoints (L4 GPU configuration). | google/gemma-4-E4B-it |
vLLM | Google Cloud Run (L4 GPU) |
| local-2B-devops-agent | Local CPU/GPU DevOps/SRE Agent optimized for 2B parameter model execution. | gemma4:e2b |
Ollama / vLLM | Local Workstation (Docker CPU/GPU) |
| local-devops-agent | Specialized SRE for local CPU/GPU containerized workloads. | google/gemma-4-31B-it |
Ollama / vLLM | Local Workstation (Docker CPU/GPU) |
| mac-2B-devops-agent | Local macOS/Apple Silicon SRE Agent optimized for 2B parameter model execution on local hardware. | gemma4:e2b |
Ollama / vLLM | Local macOS (Apple Silicon) |
| mac-4B-devops-agent | Local macOS/Apple Silicon SRE Agent optimized for 4B parameter model execution on local hardware. | gemma4:e4b |
Ollama / vLLM | Local macOS (Apple Silicon) |
| tpu-12B-mtp-v6e1-devops-agent | High-performance TPU SRE/DevOps running the 12B configuration with Multi-Token Prediction (MTP) on a v6e-1 TPU VM. | google/gemma-4-12B-it |
vLLM | Google Cloud TPUs (v6e Trillium v6e-1) |
| tpu-12B-quant-v6e1-devops-agent | High-performance TPU SRE/DevOps running the quantized 12B configuration (FP8) on a v6e-1 TPU VM. | vrfai/gemma-4-12B-it-fp8 |
vLLM | Google Cloud TPUs (v6e Trillium v6e-1) |
| tpu-12B-v6e1-devops-agent | High-performance TPU SRE/DevOps managing TPU workloads with the 12B configuration on a v6e-1 TPU VM. | google/gemma-4-12B-it |
vLLM | Google Cloud TPUs (v6e Trillium v6e-1) |
| tpu-12B-v6e4-devops-agent | High-performance TPU SRE/DevOps managing TPU workloads with the 12B configuration on a v6e-4 TPU VM. | google/gemma-4-12B-it |
Ollama / vLLM | Google Cloud TPUs (v6e Trillium v6e-4) |
| tpu-26B-devops-agent | High-performance TPU SRE/DevOps running the 26B configuration (running 31B model) on a v6e-1 TPU VM. | google/gemma-4-31B-it |
vLLM | Google Cloud TPUs (v6e Trillium v6e-1) |
| tpu-2B-v6e1-devops-agent | High-performance TPU SRE/DevOps managing TPU workloads with the 2B configuration on a v6e-1 TPU VM. | google/gemma-4-E2B-it |
Ollama / vLLM | Google Cloud TPUs (v6e Trillium v6e-1) |
| tpu-2B-v6e4-devops-agent | High-performance TPU SRE/DevOps managing TPU workloads with the 2B configuration on a v6e-4 TPU VM. | google/gemma-4-E2B-it |
Ollama / vLLM | Google Cloud TPUs (v6e Trillium v6e-4) |
| tpu-31B-devops-agent | High-performance TPU SRE/DevOps running the 31B configuration on a v6e-1 TPU VM. | google/gemma-4-31B-it |
vLLM | Google Cloud TPUs (v6e Trillium v6e-1) |
| tpu-4B-v6e1-devops-agent | High-performance TPU SRE/DevOps managing TPU workloads with the 4B configuration on a v6e-1 TPU VM. | google/gemma-4-E4B-it |
Ollama / vLLM | Google Cloud TPUs (v6e Trillium v6e-1) |
| tpu-4B-v6e4-devops-agent | High-performance TPU SRE/DevOps managing TPU workloads with the 4B configuration on a v6e-4 TPU VM. | google/gemma-4-E4B-it |
Ollama / vLLM | Google Cloud TPUs (v6e Trillium v6e-4) |
--- | :--- | :--- | :--- | | Local DevOps Agent | CPU/GPU local analysis & prototyping | Ollama / vLLM | Local Docker / Workstations | | GPU DevOps Agent (4B L4) | Serverless cloud SRE (4B model on L4 GPU) | vLLM | Google Cloud Run (us-east4) | | GPU DevOps Agent (4B 6000) | Serverless cloud SRE (4B model on RTX 6000 GPU) | vLLM | Google Cloud Run (us-central1) | | GPU DevOps Agent (26B 6000) | Serverless cloud SRE (26B model on RTX 6000 GPU) | vLLM | Google Cloud Run (us-central1) | | GPU DevOps Agent (31B 6000) | Serverless cloud SRE (31B model on RTX 6000 GPU) | vLLM | Google Cloud Run (us-central1) | | GPU DevOps Agent (6000) | Serverless cloud SRE (RTX 6000 GPU configuration) | vLLM | Google Cloud Run (us-central1) | | GPU DevOps Agent (vLLM) | Serverless cloud SRE (L4 GPU configuration) | vLLM | Google Cloud Run (us-east4) | | GPU DevOps Agent (31B QAT L4) | Serverless cloud SRE (31B QAT model on L4 GPU) | vLLM | Google Cloud Run (us-east4) | | TPU DevOps Agent (26B) | Ultra-high performance TPU SRE (26B configuration) | vLLM | Google Cloud TPUs (v6e Trillium) | | TPU DevOps Agent (31B) | Ultra-high performance TPU SRE (31B configuration) | vLLM | Google Cloud TPUs (v6e Trillium) | | TPU DevOps Agent (12B v6e-1) | Ultra-high performance TPU SRE (12B configuration) | vLLM | Google Cloud TPUs (v6e Trillium) |
- Automated SRE Diagnostics: Fetches and reviews system, container, and Cloud Logging entries using Gemma 4 to identify root causes and generate 3-step remediation plans.
- Serving Stack Control: Built-in tools to provision, start, stop, restart, and scale your vLLM and Ollama containers or Cloud TPU Queued Resources.
- Observability Dashboards: Real-time dashboards monitoring HBM usage, Tensor Core pressure, Prometheus metrics, and service latencies.
- Model Benchmarking: Tools to run load tests and vLLM's internal benchmark suites, returning performance metrics (TTFT, throughput, P95 latency).
- Gemini CLI Integration: Custom setup instructions using a LiteLLM Proxy to route standard Gemini CLI commands directly to your private, self-hosted Gemma 4 instance.
A root Makefile is provided to manage the sub-agents collectively:
- Help / Display commands:
make all
- Install dependencies in all subdirectories:
make install
- Run tests across all agents:
make test - Lint all Python directories:
make lint
- Clean build/cache folders:
make clean
- Role: Serverless cloud SRE leveraging the 12B parameter QAT model on L4 GPU via Cloud Run Gen2.
- Inference Stack: Runs
google/gemma-4-12B-it-qat-w4a16-ctvia vLLM. - Documentation: See g2-4-12B-qat-L4-devops-agent/README.md and g2-4-12B-qat-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 12B configuration on an NVIDIA RTX 6000 GPU.
- Inference Stack: Runs
gemma-4-12B-itvia vLLM. - Documentation: See gpu-12B-6000-devops-agent/README.md and gpu-12B-6000-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 12B configuration on an NVIDIA L4 GPU.
- Inference Stack: Runs
gemma-4-12B-itvia vLLM. - Documentation: See gpu-12B-L4-devops-agent/README.md and gpu-12B-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 12B QAT configuration on an NVIDIA L4 GPU.
- Inference Stack: Runs
google/gemma-4-12B-it-qat-w4a16-ctvia vLLM. - Documentation: See gpu-12B-qat-L4-devops-agent/README.md and gpu-12B-qat-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 12B QAT configuration with Multi-Token Prediction (MTP) on an RTX 6000 GPU.
- Inference Stack: Runs
google/gemma-4-12B-it-qat-w4a16-ctvia vLLM. - Documentation: See gpu-12B-qat-mtp-6000-devops-agent/README.md and gpu-12B-qat-mtp-6000-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 12B QAT configuration with Multi-Token Prediction (MTP) on an NVIDIA L4 GPU.
- Inference Stack: Runs
google/gemma-4-12B-it-qat-w4a16-ctvia vLLM. - Documentation: See gpu-12B-qat-mtp-L4-devops-agent/README.md and gpu-12B-qat-mtp-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 26B configuration on an NVIDIA RTX 6000 GPU.
- Inference Stack: Runs
google/gemma-4-26B-itvia vLLM. - Documentation: See gpu-26B-6000-devops-agent/README.md and gpu-26B-6000-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 26B configuration on an NVIDIA L4 GPU.
- Inference Stack: Runs
nvidia/gemma-4-26B-A4B-NVFP4via vLLM. - Documentation: See gpu-26B-L4-devops-agent/README.md and gpu-26B-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE leveraging the 26B QAT configuration on an NVIDIA L4 GPU.
- Inference Stack: Runs
google/gemma-4-26B-A4B-it-qat-w4a16-ctvia vLLM. - Documentation: See gpu-26B-qat-L4-devops-agent/README.md and gpu-26B-qat-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 31B configuration on an NVIDIA RTX 6000 GPU.
- Inference Stack: Runs
google/gemma-4-31B-itvia vLLM. - Documentation: See gpu-31B-6000-devops-agent/README.md and gpu-31B-6000-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 31B NVFP4 quantized configuration on an NVIDIA L4 GPU.
- Inference Stack: Runs
nvidia/Gemma-4-31B-IT-NVFP4via vLLM. - Documentation: See gpu-31B-L4-devops-agent/README.md and gpu-31B-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE leveraging the 31B QAT configuration on an NVIDIA L4 GPU.
- Inference Stack: Runs
google/gemma-4-31B-it-qat-w4a16-ctvia vLLM. - Documentation: See gpu-31B-qat-L4-devops-agent/README.md and gpu-31B-qat-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 4B configuration on an NVIDIA RTX 6000 GPU.
- Inference Stack: Runs
google/gemma-4-E4B-itvia vLLM. - Documentation: See gpu-4B-6000-devops-agent/README.md and gpu-4B-6000-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE running the 4B configuration on an NVIDIA L4 GPU.
- Inference Stack: Runs
google/gemma-4-E4B-itvia vLLM. - Documentation: See gpu-4B-L4-devops-agent/README.md and gpu-4B-L4-devops-agent/GEMINI.md.
- Role: Serverless cloud SRE leveraging the 4B QAT configuration on an NVIDIA L4 GPU.
- Inference Stack: Runs
google/gemma-4-E4B-it-qat-w4a16-ctvia vLLM. - Documentation: See gpu-4B-qat-L4-devops-agent/README.md and gpu-4B-qat-L4-devops-agent/GEMINI.md.
- Role: Cloud-based SRE managing GPU-accelerated serverless endpoints (RTX 6000 GPU configuration).
- Inference Stack: Runs
google/gemma-4-E4B-itvia vLLM. - Documentation: See gpu-6000-devops-agent/README.md and gpu-6000-devops-agent/GEMINI.md.
- Role: Cloud-based SRE managing GPU-accelerated serverless endpoints (L4 GPU configuration).
- Inference Stack: Runs
google/gemma-4-E4B-itvia vLLM. - Documentation: See gpu-vllm-devops-agent/README.md and gpu-vllm-devops-agent/GEMINI.md.
- Role: Local CPU/GPU DevOps/SRE Agent optimized for 2B parameter model execution.
- Inference Stack: Runs
gemma4:e2bvia Ollama / vLLM. - Documentation: See local-2B-devops-agent/README.md and local-2B-devops-agent/GEMINI.md.
- Role: Specialized SRE for local CPU/GPU containerized workloads.
- Inference Stack: Runs
google/gemma-4-31B-itvia Ollama / vLLM. - Documentation: See local-devops-agent/README.md and local-devops-agent/GEMINI.md.
- Role: Local macOS/Apple Silicon SRE Agent optimized for 2B parameter model execution on local hardware.
- Inference Stack: Runs
gemma4:e2bvia Ollama / vLLM. - Documentation: See mac-2B-devops-agent/README.md and mac-2B-devops-agent/GEMINI.md.
- Role: Local macOS/Apple Silicon SRE Agent optimized for 4B parameter model execution on local hardware.
- Inference Stack: Runs
gemma4:e4bvia Ollama / vLLM. - Documentation: See mac-4B-devops-agent/README.md and mac-4B-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps running the 12B configuration with Multi-Token Prediction (MTP) on a v6e-1 TPU VM.
- Inference Stack: Runs
google/gemma-4-12B-itvia vLLM. - Documentation: See tpu-12B-mtp-v6e1-devops-agent/README.md and tpu-12B-mtp-v6e1-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps running the quantized 12B configuration (FP8) on a v6e-1 TPU VM.
- Inference Stack: Runs
vrfai/gemma-4-12B-it-fp8via vLLM. - Documentation: See tpu-12B-quant-v6e1-devops-agent/README.md and tpu-12B-quant-v6e1-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps managing TPU workloads with the 12B configuration on a v6e-1 TPU VM.
- Inference Stack: Runs
google/gemma-4-12B-itvia vLLM. - Documentation: See tpu-12B-v6e1-devops-agent/README.md and tpu-12B-v6e1-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps managing TPU workloads with the 12B configuration on a v6e-4 TPU VM.
- Inference Stack: Runs
google/gemma-4-12B-itvia Ollama / vLLM. - Documentation: See tpu-12B-v6e4-devops-agent/README.md and tpu-12B-v6e4-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps running the 26B configuration (running 31B model) on a v6e-1 TPU VM.
- Inference Stack: Runs
google/gemma-4-31B-itvia vLLM. - Documentation: See tpu-26B-devops-agent/README.md and tpu-26B-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps managing TPU workloads with the 2B configuration on a v6e-1 TPU VM.
- Inference Stack: Runs
google/gemma-4-E2B-itvia Ollama / vLLM. - Documentation: See tpu-2B-v6e1-devops-agent/README.md and tpu-2B-v6e1-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps managing TPU workloads with the 2B configuration on a v6e-4 TPU VM.
- Inference Stack: Runs
google/gemma-4-E2B-itvia Ollama / vLLM. - Documentation: See tpu-2B-v6e4-devops-agent/README.md and tpu-2B-v6e4-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps running the 31B configuration on a v6e-1 TPU VM.
- Inference Stack: Runs
google/gemma-4-31B-itvia vLLM. - Documentation: See tpu-31B-devops-agent/README.md and tpu-31B-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps managing TPU workloads with the 4B configuration on a v6e-1 TPU VM.
- Inference Stack: Runs
google/gemma-4-E4B-itvia Ollama / vLLM. - Documentation: See tpu-4B-v6e1-devops-agent/README.md and tpu-4B-v6e1-devops-agent/GEMINI.md.
- Role: High-performance TPU SRE/DevOps managing TPU workloads with the 4B configuration on a v6e-4 TPU VM.
- Inference Stack: Runs
google/gemma-4-E4B-itvia Ollama / vLLM. - Documentation: See tpu-4B-v6e4-devops-agent/README.md and tpu-4B-v6e4-devops-agent/GEMINI.md.
When deploying to Google Cloud or Hugging Face, secure credentials using:
- Hugging Face Access Token: Saved locally or to Google Secret Manager.
- Application Default Credentials (ADC): Set up using GCP credentials helper scripts.
Google Cloud credits are provided for this project.
#AgenticArchitect #GoogleAntigravity
