Update README.md

README.md

@@ -11,4 +11,189 @@ license: mit
 short_description: Enriquecimiento de prompts visuales
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# PromptCraft: Refinamiento Estructural de Prompts
+
+**PromptCraft** es un sistema de ingeniería de prompts asistida por IA que transforma ideas en lenguaje natural en prompts optimizados para modelos de difusión (Midjourney, FLUX, SDXL).  
+A diferencia de los refinadores basados en parafraseo, **PromptCraft analiza la gramática descriptiva de 100.000 prompts profesionales** y reconstruye el concepto del usuario imitando esa estructura real.
+
+> **No impone plantillas. No inventa. Solo estructura.**
+
+---
+
+## 🌐 Flujo del sistema
+Usuario (castellano)
+↓
+Traducción local (es → en)
+↓
+Recuperación semántica (FAISS + categoría)
+↓
+Re-ranking con Cross-Encoder (top 6)
+↓
+Reconstrucción con LLaMA-3.2-3B (gramática del dataset)
+↓
+Generación con SDXL
+
+
+---
+
+## 🔑 Características clave
+
+- **Refinamiento estructural**: el LLM imita la gramática de prompts reales, no sigue una plantilla abstracta.
+- **Categorización contextual**: filtra ejemplos por tipo (entidad, estilo, composición, etc.).
+- **Transparencia total**: muestra los 6 ejemplos del dataset usados para el refinamiento.
+- **Iteración libre**: refina el prompt tantas veces como necesites antes de generar.
+- **100% funcional en CPU**: traducción y análisis locales; solo la generación usa la nube.
+
+---
+
+## 🛠️ Cómo usarlo
+
+1. **Escribe tu idea en castellano** (ej: *"un mercado en Antigua Guatemala"*).
+2. **(Opcional) Selecciona una categoría**:
+   - **Automática**: el sistema decide.
+   - **Entidad**: personas, objetos, criaturas.
+   - **Composición**: escenas, entornos, narrativas.
+   - **Estilo artístico**: pintura, ilustración, fotografía.
+   - **Imaginativo**: fantasía, ciencia ficción.
+   - **Texto**: tipografía, logotipos.
+3. Haz clic en **"🔄 Refinar prompt"**.
+4. Si no te gusta el resultado, **refina de nuevo**.
+5. Cuando estés satisfecho, haz clic en **"🎨 Generar imagen"**.
+
+---
+
+## 📁 Requisitos del dataset
+
+Tu `metadata.json` debe tener este formato:
+```json
+[
+  {
+    "caption": "a cyberpunk street at night, neon signs...",
+    "category": "composition"
+  },
+  {
+    "caption": "oil painting of a forest, style of Van Gogh",
+    "category": "style"
+  }
+]
+
+Sin el campo "category", el sistema funciona en modo "Automática" (sin filtrar). 
+
+📦 Dependencias
+gradio==4.24.0
+Pillow
+huggingface-hub>=0.24.0
+sentence-transformers>=2.3.0
+faiss-cpu==1.7.4
+datasets>=2.10.0
+torch
+transformers
+sentencepiece
+profile
+Qwen3-Max
+7:48 pm
+¡Claro, socio! Aquí tienes el README.md completo en un solo bloque de código, listo para copiar y pegar, con los créditos finales como pediste.
+
+markdown
+
+
+1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+⌄
+⌄
+# PromptCraft: Refinamiento Estructural de Prompts
+
+**PromptCraft** es un sistema de ingeniería de prompts asistida por IA que transforma ideas en lenguaje natural en prompts optimizados para modelos de difusión (Midjourney, FLUX, SDXL).  
+A diferencia de los refinadores basados en parafraseo, **PromptCraft analiza la gramática descriptiva de 100.000 prompts profesionales** y reconstruye el concepto del usuario imitando esa estructura real.
+
+> **No impone plantillas. No inventa. Solo estructura.**
+
+---
+
+## 🌐 Flujo del sistema
+
+Usuario (castellano)
+↓
+Traducción local (es → en)
+↓
+Recuperación semántica (FAISS + categoría)
+↓
+Re-ranking con Cross-Encoder (top 6)
+↓
+Reconstrucción con LLaMA-3.2-3B (gramática del dataset)
+↓
+Generación con SDXL
+
+---
+
+## 🔑 Características clave
+
+- **Refinamiento estructural**: el LLM imita la gramática de prompts reales, no sigue una plantilla abstracta.
+- **Categorización contextual**: filtra ejemplos por tipo (entidad, estilo, composición, etc.).
+- **Transparencia total**: muestra los 6 ejemplos del dataset usados para el refinamiento.
+- **Iteración libre**: refina el prompt tantas veces como necesites antes de generar.
+- **100% funcional en CPU**: traducción y análisis locales; solo la generación usa la nube.
+
+---
+
+## 🛠️ Cómo usarlo
+
+1. **Escribe tu idea en castellano** (ej: *"un mercado en Antigua Guatemala"*).
+2. **(Opcional) Selecciona una categoría**:
+   - **Automática**: el sistema decide.
+   - **Entidad**: personas, objetos, criaturas.
+   - **Composición**: escenas, entornos, narrativas.
+   - **Estilo artístico**: pintura, ilustración, fotografía.
+   - **Imaginativo**: fantasía, ciencia ficción.
+   - **Texto**: tipografía, logotipos.
+3. Haz clic en **"🔄 Refinar prompt"**.
+4. Si no te gusta el resultado, **refina de nuevo**.
+5. Cuando estés satisfecho, haz clic en **"🎨 Generar imagen"**.
+
+---
+
+## 📁 Requisitos del dataset
+
+Tu `metadata.json` debe tener este formato:
+```json
+[
+  {
+    "caption": "a cyberpunk street at night, neon signs...",
+    "category": "composition"
+  },
+  {
+    "caption": "oil painting of a forest, style of Van Gogh",
+    "category": "style"
+  }
+]
+Sin el campo "category", el sistema funciona en modo "Automática" (sin filtrar). 
+
+📦 Dependencias
+
+gradio==4.24.0
+Pillow
+huggingface-hub>=0.24.0
+sentence-transformers>=2.3.0
+faiss-cpu==1.7.4
+datasets>=2.10.0
+torch
+transformers
+sentencepiece
+
+🚀 Créditos
+Motor semántico: FAISS + bge-small-en-v1.5 + Cross-Encoder.
+Traducción: Helsinki-NLP/opus-mt-es-en (local, CPU).
+Refinamiento: meta-llama/Llama-3.2-3B-Instruct.
+Generación: stabilityai/stable-diffusion-xl-base-1.0.
+Este proyecto nace de la necesidad de coherencia narrativa y control estructural en la generación de imágenes por IA, especialmente para cineastas, escritores y artistas visuales.
+
+Creado por Angel E. Pariente 🇬🇹 según la idea de Nacho Ravinovich 🇦🇷