README.md

metadata

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.

# 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.