README.md

metadata

title: Prompteador
emoji: 🚀
colorFrom: red
colorTo: yellow
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
license: mit
short_description: Enriquecimiento de prompts visuales

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:

[
  {
    "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 🇦🇷