README_VECTOR_GRAPHICS.md

🎨 Gráficos Vectoriales SVG - NTIA Space

📋 Descripción

Esta funcionalidad permite generar gráficos vectoriales SVG de alta calidad usando modelos de IA especializados. Los gráficos vectoriales son escalables sin pérdida de calidad y perfectos para iconos, logos, ilustraciones y elementos de diseño.

🚀 Modelos Disponibles

🎨 SVGDreamer (Principal)

• Modelo: jree423/svgdreamer
• Descripción: Modelo avanzado de texto a SVG con múltiples estilos
• Características:
  • Generación multi-partícula (hasta 8 variantes simultáneas)
  • 4 estilos diferentes: iconography, pixel_art, sketch, painting
  • Optimizado para ZeroGPU H200
  • Formato de salida: SVG escalable

🏢 Modelos Microsoft (Especializados)

• IconGenerator: Generador de iconos vectoriales
• LogoMaker: Creador de logos corporativos
• VectorArt: Arte vectorial general
• IllustrationGen: Ilustraciones editoriales
• PatternMaker: Generador de patrones
• DiagramGen: Diagramas técnicos
• ChartMaker: Gráficos de datos
• FlowchartGen: Diagramas de flujo
• MindMapGen: Mapas mentales
• InfographicGen: Infografías
• PosterMaker: Pósters vectoriales
• BannerGen: Banners web
• CardMaker: Tarjetas de presentación
• BadgeGen: Insignias y premios
• StickerMaker: Stickers vectoriales
• EmojiGen: Emojis personalizados
• IconSetGen: Conjuntos de iconos
• UIElementGen: Elementos de interfaz

🎯 Estilos Disponibles

1. Iconography

• Descripción: Iconos limpios y minimalistas
• Uso: Logos, iconos de apps, símbolos
• Ejemplo: "a simple house icon"

2. Pixel Art

• Descripción: Estilo retro con píxeles visibles
• Uso: Juegos, arte retro, nostalgia
• Ejemplo: "a pixel art character"

3. Sketch

• Descripción: Dibujo a mano alzada
• Uso: Bocetos, ilustraciones artísticas
• Ejemplo: "a sketch of a mountain landscape"

4. Painting

• Descripción: Estilo pictórico con pinceladas
• Uso: Arte digital, ilustraciones expresivas
• Ejemplo: "an oil painting of a sunset"

⚙️ Parámetros de Configuración

Parámetros Principales

• Número de partículas: 1-8 (más partículas = más variantes)
• Iteraciones: 100-1000 (más iteraciones = mejor calidad)
• Guidance scale: 1.0-15.0 (controla adherencia al prompt)
• Dimensiones: 64x64 a 512x512 píxeles

Optimización para ZeroGPU

• Timeout: 45 segundos máximo
• Memoria: Optimizado para H200
• Cuota: Estimación precisa de uso

📝 Ejemplos de Prompts

🦅 Naturaleza

• "a majestic eagle soaring through clouds"
• "ocean waves crashing on rocks"
• "a field of sunflowers under blue sky"

🤖 Personajes y Objetos

• "a friendly robot character"
• "a vintage bicycle"
• "a magical wizard casting spells"

🎨 Arte Abstracto

• "geometric patterns in bright colors"
• "flowing organic shapes"
• "mandala design with intricate details"

🏢 Elementos Corporativos

• "modern company logo with geometric shapes"
• "professional business card design"
• "corporate presentation template"

🔧 Uso Técnico

API Directa

from huggingface_hub import InferenceClient

client = InferenceClient("jree423/svgdreamer")
result = client.post(
    json={
        "inputs": "a cyberpunk cityscape at night",
        "parameters": {
            "n_particle": 4,
            "style": "pixel_art",
            "guidance_scale": 8.0
        }
    }
)

Parámetros Completos

payload = {
    "inputs": "tu prompt aquí",
    "parameters": {
        "n_particle": 6,        # Número de variantes
        "num_iter": 1000,       # Iteraciones de optimización
        "guidance_scale": 7.5,  # Control de adherencia
        "style": "iconography", # Estilo artístico
        "width": 224,           # Ancho en píxeles
        "height": 224,          # Alto en píxeles
        "seed": 42              # Semilla para reproducibilidad
    }
}

📊 Formato de Salida

SVGDreamer

• Formato: Lista de objetos JSON
• Contenido: SVG como string + metadatos
• Partículas: Múltiples variantes por request

Otros Modelos

• Formato: SVG único
• Contenido: Código SVG directo
• Metadatos: Información del modelo usado

⚡ Optimizaciones de Rendimiento

Para ZeroGPU H200

• Memoria: Uso optimizado de VRAM
• Velocidad: Configuración turbo para H200
• Cuota: Estimación precisa de tiempo

Parámetros Recomendados

• Rápido: 1 partícula, 100 iteraciones
• Balanceado: 4 partículas, 500 iteraciones
• Alta calidad: 8 partículas, 1000 iteraciones

🎨 Casos de Uso

1. Diseño de Marca

• Logos corporativos
• Identidad visual
• Elementos de marca

2. Desarrollo Web

• Iconos de interfaz
• Elementos UI/UX
• Gráficos responsivos

3. Marketing Digital

• Banners publicitarios
• Infografías
• Material promocional

4. Contenido Educativo

• Diagramas técnicos
• Mapas conceptuales
• Ilustraciones didácticas

5. Arte Digital

• Ilustraciones personalizadas
• Patrones decorativos
• Elementos artísticos

🔍 Solución de Problemas

Error de Cuota

• Síntoma: "Cuota de ZeroGPU agotada"
• Solución: Esperar unos minutos y reintentar
• Prevención: Usar menos partículas/iteraciones

Error de Autenticación

• Síntoma: "Error de autenticación"
• Solución: Verificar HF_TOKEN
• Prevención: Configurar token correctamente

Error de Memoria

• Síntoma: "Error de memoria GPU"
• Solución: Reducir parámetros
• Prevención: Usar configuraciones conservadoras

Timeout

• Síntoma: "Timeout en la generación"
• Solución: Usar modelo más rápido
• Prevención: Optimizar parámetros

📈 Métricas de Rendimiento

SVGDreamer

• Tiempo promedio: 15-30 segundos
• Calidad: Alta (escalable sin pérdida)
• Variedad: Excelente (múltiples estilos)

Modelos Microsoft

• Tiempo promedio: 10-20 segundos
• Calidad: Especializada por dominio
• Variedad: Específica por tipo

🚀 Próximas Mejoras

• Soporte para más estilos artísticos
• Integración con editores SVG
• Exportación a formatos adicionales
• Optimización de velocidad
• Más modelos especializados

📞 Soporte

Para problemas técnicos o sugerencias:

• Revisar logs del Space
• Verificar configuración de ZeroGPU
• Consultar documentación de Hugging Face

---

🎨 ¡Disfruta creando gráficos vectoriales increíbles con IA!