README.md

---
license: other
title: Savant RRF Φ12.0 – Dirac-Resonant Conceptual Quality API
sdk: docker
emoji: 🐢
colorFrom: red
colorTo: green
pinned: true
short_description: API de evaluación conceptual resonante para LLM
---
# Savant RRF Φ12.0 – Dirac-Resonant Conceptual Quality API

Savant RRF Φ12.0 es una API de evaluación conceptual resonante para texto generado por modelos de lenguaje (LLMs).  

Dado un `prompt` y una `answer`, la API devuelve:

- **SRRF** – Resonant Quality Score (probabilidad de “respuesta buena” según meta-logit).
- **CRRF** – Coherent Resonant Score (SRRF modulado por alineación semántica).
- **E_phi** – Resonant Health Score (promedio entre SRRF y entropía resonante normalizada).
- **p_good** – probabilidad directa del meta-logit binario.
- Features físicos: entropía, energía, chirality de una **shell de Dirac icosaédrica**.

El encoder principal es `antonypamo/RRFSAVANTMADE` y el meta-logit se carga desde el repo de HF `antonypamo/RRFSavantMetaLogit` (por defecto `logreg_rrf_savant.joblib`).

---

## Estructura del repo

```text
.
├── main.py             # Código de la API (FastAPI + Savant RRF Φ12.0 core)
├── requirements.txt    # Dependencias Python
└── Dockerfile          # Imagen Docker de la API

# Savant RRF Φ12.0 – Dirac-Resonant Quality API

This API exposes the **Savant RRF Φ12.0** conceptual quality layer as a web service.
It combines:

- `antonypamo/RRFSAVANTMADE` (encoder)
- `antonypamo/RRFSavantMetaLogit` → `logreg_rrf_savant.joblib` (meta-logit classifier)
- A Dirac operator on an icosahedral lattice (Φ12.0 resonant shell)

## Endpoints

### `GET /health`

Simple healthcheck.

```json
{"status": "ok"}