README.md

---
title: Agentic Reliability Framework (ARF) v4 API
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 6.9.0
python_version: '3.10'
app_file: hf_demo.py
pinned: false
---

# Agentic Reliability Framework (ARF) v4 API

This Space hosts the **ARF v4 API** with an optional Gradio dashboard. It provides endpoints for risk assessment, decision history, and incident evaluation, as used by the [ARF frontend](https://arf-frontend-sandy.vercel.app).

## 🚀 Endpoints

| Method | Path | Description |
|--------|------|-------------|
| `GET` | `/health` | Health check |
| `GET` | `/api/v1/get_risk` | Current system risk (demo) |
| `GET` | `/api/v1/history` | Recent decisions |
| `POST` | `/api/v1/incidents/evaluate` | Evaluate an incident (placeholder) |
| `POST` | `/api/v1/feedback` | Record outcome of a decision |

Interactive API documentation is available at `/docs` (FastAPI Swagger UI).

## 🧪 Try It

You can test the API directly using the Swagger UI:  
[https://a-r-f-agentic-reliability-framework-api.hf.space/docs](https://a-r-f-agentic-reliability-framework-api.hf.space/docs)

Or use the Gradio dashboard (mounted at the root) for a visual demo.

## 🔧 Local Development

To run this Space locally:

```bash
pip install -r requirements.txt
python hf_demo.py
```

The app will be available at http://localhost:7860.

📚 About ARF
------------

Agentic Reliability Framework is an open‑source advisory engine for cloud infrastructure governance, powered by Bayesian inference. Learn more at [github.com/arf-foundation](https://github.com/arf-foundation).