README.md

---
title: Prompt Compiler API
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---
# Prompt Compiler v3.2

Un **Compilador de Prompts Industrial** Offline-First, diseñado para transformar lenguaje natural (humano) en sintaxis técnica perfecta (máquina) para modelos de generación de imágenes (SDXL, Pony, Illustrious, etc.).

## 🚀 Propuesta de Valor

- **Traductor Dual Inteligente:** Entiende prompts imperfectos en **Español** e **Inglés**, y los traduce internamente a la sintaxis exacta (tags, pesos, negativos) que requiere la IA.
- **Tolerancia a Errores (Entity Normalization):** Ignora errores de mayúsculas/minúsculas y resuelve ambigüedades gramaticales (ej. diferenciar entre "la sombra" y el personaje "Shadow").
- **Determinismo Absoluto:** A diferencia de un LLM, si ingresas el mismo prompt 100 veces, obtienes el mismo string perfecto 100 veces, sin alucinaciones.
- **Rendimiento Edge (<10ms):** Funciona 100% en local usando motores de CPU quantizados (`ONNX int8`). No requiere GPUs costosas ni APIs en la nube.
- **Enriquecimiento Experto:** Al detectar un personaje o concepto, inyecta automáticamente metadatos visuales canónicos desde una base de conocimiento SQLite.

## 🛠️ Características Principales

- **Parsing Híbrido:** Combinación de análisis lingüístico (spaCy) y búsqueda semántica (FAISS + Sentence-Transformers).
- **Perfiles YAML:** Adaptación instantánea de la salida para diferentes modelos de imagen (Pony, SDXL, Generic).
- **Explainability:** Trazas de ejecución completas para cada resolución.

## 📦 Instalación y Uso Rápido

Requiere **Python 3.12+** y `uv`.

```bash
# Clonar e instalar dependencias
git clone <repositorio>
cd model_create_prompt
uv sync

# Ejecutar el compilador por CLI (Ejemplo en Español)
uv run prompt-compiler "amy rose con un vestido rojo en la playa" --profile pony --semantic --runtime onnx
```

También disponible vía API REST (FastAPI) y contenedor Docker para integración B2B "Plug & Play".

Consulte la carpeta `docs/` para detalles de arquitectura.