README.md

---
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:

1. **🔍 Analyze** - Deep dive into your incident details
2. **🧩 Find** - Identify the root cause with precision
3. **🛠️ Solve** - Generate actionable solution recommendations
4. **📚 Create** - Craft entertaining comic narratives
5. **🎨 Generate** - Produce comic-style visual panels
6. **🎬 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
```bash
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
```bash
python mcp_server.py
```
Running the Gradio App locally
```bash
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  ![sample_incidents.md](./sample_incidents.md) 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

1. **Input**: Describe your incident or upload documentation
2. **Analysis**: AI agent analyzes symptoms and context
3. **Root Cause**: Identifies underlying technical issues
4. **Solution**: Generates step-by-step resolution recommendations
5. **Story**: Creates an entertaining comic narrative
6. **Visuals**: Generates comic-style illustrations
7. **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
![The Tale of the Grumpy Database Dragon](./Examples/db_kingdom.png)


## Some More Example Output Images ....

### The Database Resource Exhaustion Case
![The Database Resource Exhaustion Case](./Examples/db_resource_exhaustion.png)
### The Great Banking BlackOut 
![The Great Banking BlackOut](./Examples/db_issue.png)
### The Epic Server Room Flood 
![The Epic Server Room Flood](./Examples/epic_flood.png)
### The Mystery of uneven User flow
![The Mystery of uneven User flow](./Examples/uneven_user_flow_high_latency.png)
### Finally, Issue Resolved 
![Finally Issue Resolved](./Examples/finally_issue_resolved.png)



## 🌟 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](https://huggingface.co/)** - AI model hosting and deployment
- **[Gradio](https://gradio.app/)** - Interactive web interface framework
- **[MCP](https://modelcontextprotocol.io/)** - Model Context Protocol integration
- **[Anthropic](https://anthropic.com/)** - Claude AI models for reasoning
- **[OpenAI](https://openai.com/)** - GPT models and image generation
- **[smolagents](https://github.com/huggingface/smolagents)** - Multi-step agent framework
- **[Nebius](https://nebius.com/)** - Cloud infrastructure and compute
- **[Mistral](https://mistral.ai/)** - Advanced language models and AI reasoning
- **[Hyperbolic](https://hyperbolic.xyz/)** - High-performance AI inference platform
- **[Modal](https://modal.com/)** - 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!* 🎭