# 🧠 Agentic Reliability Framework MVP

**Author:** [Juan D. Petter](https://github.com/petter2025)  
**Stack:** Python 3.10 · Gradio 5.49.1 · FastAPI · FAISS · SentenceTransformers · Hugging Face Router API  

---

## 🚀 Overview

The **Agentic Reliability Framework MVP** is an intelligent observability and self-healing system that combines:

- **Adaptive anomaly detection** (latency/error-rate monitoring)  
- **AI-driven root cause analysis** powered by Hugging Face’s Inference Router  
- **Persistent FAISS vector memory** for incident recall and similarity search  
- **Agentic self-healing simulation** (automated reliability responses)

This MVP runs entirely in a Hugging Face Space and doubles as both:
- a **visual Gradio dashboard**, and  
- a **REST API backend** (via FastAPI).

---

## ⚙️ Features

| Module | Description |
|--------|--------------|
| **Anomaly Detection** | Adaptive thresholding + random test anomalies |
| **AI Insight Generation** | Uses `mistralai/Mixtral-8x7B-Instruct-v0.1` via Hugging Face Router |
| **Self-Healing Simulation** | Randomized corrective actions |
| **Persistent Memory** | FAISS + JSON persistence with file locks |
| **REST API** | `/add-event` route secured with an optional API key |
| **UI Dashboard** | Live anomaly visualization via Gradio Blocks |

---

## 🧩 Tech Stack

| Component | Purpose |
|------------|----------|
| `gradio` | Dashboard / UI |
| `fastapi` | API backend |
| `sentence-transformers` | Embeddings for FAISS |
| `faiss-cpu` | Vector memory store |
| `requests` | Hugging Face Inference Router calls |
| `filelock` | Safe concurrent persistence |

---

## 🧠 Architecture Flow