Generador de imágenes SD3

Una aplicación ligera en Streamlit para generar imágenes usando el modelo SD3 de Stability AI.
Incluye interfaz en español, previsualización y descarga de imágenes.

---

✨ Características

• Interfaz sencilla y clara en español.
• Campo para introducir el prompt (texto) y opciones básicas: relación de aspecto, formato y semilla.
• Previsualización de la imagen generada y botón de descarga.
• Comprobación automática de la variable de entorno STABILITY_KEY con ayuda en caso de que falte.
• Manejo de resultados bloqueados por el filtro de contenido (CONTENT_FILTERED).

---

📦 Requisitos

• Python 3.10+ recomendado.
• Acceso a la API de Stability AI (clave en STABILITY_KEY).

Las dependencias principales están listadas en requirements.txt.

---

⚡ Instalación rápida

1. Clona el repositorio o descarga los archivos:

   git clone https://github.com/VictoriaCabirta/sd3-image-generator.git
   cd sd3-image-generator

2. Crea y activa un entorno virtual (recomendado):

   python -m venv .venv
   source .venv/bin/activate   # En Linux / macOS
   .venv\Scripts\activate      # En Windows (PowerShell)

3. Instala las dependencias:

   python -m pip install -r requirements.txt

---

🔑 Obtener la clave de Stability AI (API Key)

Para usar esta app necesitas una clave de API de Stability AI. Sigue estos pasos:

1. Crea una cuenta en Stability AI.

2. Accede a tu panel en Stability API Keys.

3. Genera una nueva clave (copiala y guárdala en un lugar seguro).

4. Configura la variable de entorno STABILITY_KEY en tu equipo:

   Opción 1: archivo .env (recomendado) Crea un archivo .env en la raíz del proyecto con el siguiente contenido:

   STABILITY_KEY=tu_clave_de_api_aqui

   Opción 2: exportar variable en shell

   export STABILITY_KEY="tu_clave_de_api_aqui"   # Linux / macOS
   setx STABILITY_KEY "tu_clave_de_api_aqui"     # Windows (cmd/PowerShell)

La app mostrará un mensaje de error en rojo si la clave no está configurada.

---

▶️ Ejecutar la app

En la raíz del proyecto, ejecuta:

streamlit run main.py

Esto abrirá una interfaz web donde podrás introducir tu prompt, elegir formato y generar la imagen.

---

💡 Uso y recomendaciones

• El prompt puede ser tan simple o detallado como quieras; para resultados consistentes, incluye estilo, iluminación y composición.
• Si la generación es bloqueada (CONTENT_FILTERED), la app mostrará una advertencia y no descargará la imagen.
• Para guardar automáticamente en una carpeta, crea output/ y activa el guardado en el código.

---

🛠️ Solución de problemas

• ImportError: asegúrate de activar el entorno virtual e instalar dependencias.
• Clave no encontrada: revisa que STABILITY_KEY esté configurada sin espacios ni comillas extra.
• Errores HTTP: comprueba que tu clave sea válida y que la API de Stability esté disponible.

---

🤝 Contribuir

Si quieres mejorar la app (mejorar la UI, añadir guardado automático, soporte para más modelos, etc.), crea una rama y un pull request. Se recomiendan contribuciones pequeñas y probadas.

---

📄 Licencia

Este proyecto se distribuye bajo la GNU Affero General Public License v3 (AGPLv3). Consulta el archivo LICENSE para más detalles.

Copyright (C) 2025 Victoria Cabirta

---

👩‍💻 Autora

• GitHub: github.com/VictoriaCabirta
• LinkedIn: linkedin.com/in/victoria-cabirta
• Email: victoriacabirta@gmail.com