Inspiration

DevOps beginners struggle with cryptic CI/CD and Docker error logs. Most tools are built for experts, not learners. This inspired us to build a mentor-style tool that explains failures clearly instead of just showing logs.

What it does

ExplainMyPipeline helps beginners understand DevOps errors by converting CI/CD and Docker logs into plain-language explanations with severity, safe fixes, security notes, and prevention tips. And the app explains :

  • What went wrong (in plain language).
  • How severe the issue is.
  • How to fix it safely.
  • Any security implications.
  • Tips to avoid the issue in the future. The goal is to help users understand, not just fix errors.

How we built it

We built a lightweight web app using Flask, HTML/CSS/JavaScript, and the Gemini API. The system analyzes logs through AI and includes fallback logic to handle external API failures gracefully.

Challenges we ran into

We faced AI SDK instability, model availability issues, and external API failures. Handling these taught us the importance of error handling, resilience, and realistic scoping.

  • API and SDK instability: Gemini SDK versions and model availability changed frequently, leading to multiple 404 and compatibility errors.
  • Model access limitations: Some models were not enabled for our API key or region.
  • Error handling: External AI failures initially broke the app until we implemented proper fallback responses.
  • Balancing scope: We had to consciously avoid overengineering and focus on a minimal but meaningful MVP. ## Accomplishments that we're proud of
  • A fully working web application
  • Beginner-friendly, structured explanations
  • Graceful handling of AI failures
  • Integration of DevOps and security concepts

What we learned

We learned how DevOps errors occur, how to integrate AI APIs reliably, and how to design beginner-first tools that teach rather than overwhelm.

  • How CI/CD and Docker errors commonly occur and how to explain them clearly.
  • How to integrate and troubleshoot third-party AI APIs.
  • That good DevOps tools should teach, not intimidate.

What's next for ExplainMyPipeline – AI DevSecOps Guide for Beginners

Future plans include support for more CI/CD platforms, improved output formatting, deployment as a hosted service, and migration to newer AI SDKs.

  • Support for more CI/CD platforms (GitHub Actions, GitLab CI, Jenkins).
  • Structured highlighting of output sections (Severity, Fix, Security).
  • Deployment as a hosted web service.
  • User feedback and log history.
  • Migration to the latest stable AI SDK when available.

Built With

Share this project:

Updates