petter2025's picture
Update README.md
047e6c3 verified
|
raw
history blame
1.68 kB
# 馃 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鈥檚 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