metadata

title: Outage Odyssey
emoji: 🦀
colorFrom: gray
colorTo: pink
sdk: docker
app_port: 7860
pinned: false
license: apache-2.0
short_description: Transform boring incidents into fun learning experiences.
tags:
  - mcp-server-track
  - agent-demo-track
  - custom-component-track
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/67af2623dad5fcb9007967e4/8CjcV_wvvnQKHmFNSGwCz.png

tags: - mcp-server-track - agent-demo-track - custom-component-track

🚨 Outage Odyssey 🧩

Transform boring IT incidents into hilarious learning experiences!

Outage Odyssey is an innovative hackathon project that converts mundane IT incident reports into engaging, educational comic stories. By leveraging AI agents and visual generation, it transforms technical troubleshooting into an entertaining and memorable learning experience.

🎯 What it Does

Outage Odyssey takes your IT incidents through a magical transformation:

🔍 Analyze - Deep dive into your incident details
🧩 Find - Identify the root cause with precision
🛠️ Solve - Generate actionable solution recommendations
📚 Create - Craft entertaining comic narratives
🎨 Generate - Produce comic-style visual panels
🎬 Deliver - Present as an educational comic strip

✨ Key Features

Smart Incident Analysis - Automatically categorizes and analyzes IT incidents
Root Cause Detection - Uses AI to identify underlying problems
Solution Recommendations - Generates actionable step-by-step resolution guides
Comic Story Generation - Transforms technical details into engaging narratives
Visual Comic Panels - Generates comic-style illustrations
Multi-format Support - Handles text, PDFs, logs, and documentation
Interactive UI - Beautiful Gradio interface with incident templates
Educational Focus - Makes learning from failures fun and memorable

Demo Video Link

Here is the demo video link: https://www.loom.com/share/93182321fd5b40afa5d20696e61e880b?sid=0bf3c689-70ef-4343-ae8f-dd8d492ff49c

🚀 Quick Start

Installation

git clone https://huggingface.co/Agents-MCP-Hackathon/OutageOdyssey
cd OutageOdyssey
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Running the MCP server

python mcp_server.py

Running the Gradio App locally

python app.py

Example Incident Input

🚨 Server Outage Incident
Incident ID: INC-2024-001
Title: Production Server Unresponsive
Severity: Critical
Description: Main application server became unresponsive at 14:30 UTC
Impact: 500+ users affected, business operations halted
Symptoms: High CPU usage, memory exhaustion
Actions taken: Attempted restart, no success

See for more examples.

🛠️ Technical Architecture

The project is built on several key components:

Agent Framework: Uses smolagents for multi-step AI reasoning
UI Framework: Custom Gradio interface with comic-themed styling
Image Processing: PIL integration for comic panel generation
File Handling: Support for various incident report formats
Streaming: Real-time agent response streaming

🎨 Supported File Types

Upload your incident documentation in various formats:

.pdf - Incident reports
.docx - Documentation
.txt - Plain text logs
.json - Structured data
.log - System logs
.csv - Data exports
.xlsx - Spreadsheets

🎭 How It Works

Input: Describe your incident or upload documentation
Analysis: AI agent analyzes symptoms and context
Root Cause: Identifies underlying technical issues
Solution: Generates step-by-step resolution recommendations
Story: Creates an entertaining comic narrative
Visuals: Generates comic-style illustrations
Output: Delivers complete educational comic strip

🎪 Example Outputs

The system transforms this:

"Database queries timing out, users reporting slow page loads"

Into this:

🎭 Comic Story: "The Tale of the Grumpy Database Dragon who was hoarding all the memory until the brave DevOps Knight optimized the queries!"

Complete with comic panels showing the "Database Dragon" and resolution steps!

The Tale of the Grumpy Database Dragon

Some More Example Output Images ....

The Database Resource Exhaustion Case

The Great Banking BlackOut

The Epic Server Room Flood

The Mystery of uneven User flow

Finally, Issue Resolved

🌟 Hackathon Integration

This project was specifically designed for Gradio Agents & MCP Hackathon featuring:

🏆 Technologies

HuggingFace - AI model hosting and deployment
Gradio - Interactive web interface framework
MCP - Model Context Protocol integration
Anthropic - Claude AI models for reasoning root cause analysis
OpenAI - GPT models and image generation
smolagents - Multi-step agent framework
Nebius - Cloud infrastructure and compute.
Mistral - Advanced language models and AI reasoning
Hyperbolic - High-performance AI inference platform

🎯 System Features

🤖 AI/ML Innovation - Novel use of agents for IT education
🎨 Creative Tech - Unique combination of technical analysis and storytelling
📚 EdTech - Making technical learning engaging and memorable
🛠️ DevOps Tools - Practical utility for IT professionals

Cloud Deployment

Compatible with major platforms:

Hugging Face Spaces
Google Colab
AWS/Azure/GCP
Nebius Cloud

➕ Enhancements

This project can be extended with:

Additional incident categories
More visual styles
Integration with monitoring tools
Multi-language support
Advanced root cause algorithms
Auto Solution/fix applying tools
Incident to Animated Video generation

📄 License

Open source hackathon project - see individual component licenses.

🎉 Acknowledgments

Special thanks to our hackathon sponsors who made this creative fusion of AI, education, and humor possible:

HuggingFace - AI model hosting and deployment
Gradio - Interactive web interface framework
MCP - Model Context Protocol integration
Anthropic - Claude AI models for reasoning
OpenAI - GPT models and image generation
smolagents - Multi-step agent framework
Nebius - Cloud infrastructure and compute
Mistral - Advanced language models and AI reasoning
Hyperbolic - High-performance AI inference platform
Modal - Serverless cloud computing for AI workloads

🚀 Built for the Gradio Agents MCP Hackathon

Making IT incidents fun to learn from, one comic at a time! 🎭