Stop debugging pipelines manually.
PipelineGuard connects to your GitLab project, reads the failure logs, and returns a structured root-cause analysis with code fixes — in seconds.
Root-Cause in Seconds
Gemini 2.5 Flash reads pipeline logs and pinpoints the exact cause — missing env vars, dependency conflicts, flaky tests, auth failures.
Diff-Ready Fix Patches
Returns unified diffs with confidence levels (high/medium/low). Copy-paste directly into your CI config or source file.
Auto MR Comments
Optionally posts the full diagnosis on the failing merge request so your team sees it immediately.
Zero-Touch Webhook
Register once as a GitLab Pipeline webhook. Every failure triggers an automatic diagnosis — no engineer action needed.
Splunk Integration
Ingest pipeline events into Splunk and run natural-language investigations across historical failure data.
Cloud-Native
Deploys to Google Cloud Run in one command. Scales to zero when idle. Uses Vertex AI for enterprise-grade inference.
▶ Interactive Demo
Select a scenario below to see a real PipelineGuard diagnosis. These outputs were produced by Gemini 2.5 Flash against actual GitLab pipelines.
🎥 Demo Video
▶ Full walkthrough video showing PipelineGuard diagnosing a real failing pipeline, posting an MR comment, and the Splunk integration.
🧱 Architecture
The agent uses the GitLab MCP Server (Model Context Protocol)
to give Gemini structured access to pipeline data — no prompt engineering for log parsing.
Falls back to direct python-gitlab calls when MCP is unavailable.
📖 API Reference
/
Landing page
/health
Health check → {"status":"ok","service":"PipelineGuard"}
/demo
Read-only live diagnosis — body: {"project":"org/repo","pipeline_id":123}
/webhook/gitlab
GitLab Pipeline webhook receiver — auto-diagnoses and posts MR comment
/docs
OpenAPI / Swagger UI — interactive API explorer
Self-host:
pip install pipelineguard[web] then
GITLAB_TOKEN=xxx GEMINI_API_KEY=yyy pipelineguard serve