ivanoctaviogaitansantos's picture
Create app.py
59aa795 verified
raw
history blame
3 kB
# 🐾 BATUTO_encicloPromt🐾
**BATUTO_encicloPromt** es un gestor visual y clasificador automático de prompts, diseñado para creadores que buscan organizar, explorar y compartir sus prompts de forma profesional.
Incluye un **modo cliente** (solo lectura) y un **modo admin** protegido por contraseña para agregar, editar o eliminar contenido.
---
## ✨ Características
- **Clasificación automática**: Detecta si un prompt es de **Personajes** o **Fotografía profesional** según palabras clave.
- **Dos espacios separados**:
- 📂 **Personajes**: prompts de diseño de personajes, criaturas, retratos, etc.
- 📂 **Fotografía profesional**: prompts de producto, moda, macro, editorial, etc.
- **Modo cliente**:
- Visualiza todos los prompts por categoría.
- Copia todos los prompts de una categoría con un clic.
- Descarga la categoría completa en formato `.json`.
- **Modo admin** (protegido por contraseña):
- Agregar prompts uno por uno o en lista masiva.
- Editar o eliminar prompts existentes.
- Clasificación automática al agregar.
- **Persistencia local** en `prompts.json` para mantener los datos entre sesiones.
- **Interfaz amigable** construida con [Gradio](https://gradio.app/).
---
## 📂 Estructura del proyecto
| Archivo / Carpeta | Descripción |
|-------------------|-------------|
| `app.py` | Código principal de la aplicación Gradio. Contiene la lógica de clasificación, gestión de prompts y la interfaz. |
| `requirements.txt` | Lista de dependencias necesarias para ejecutar la app en Hugging Face Spaces. |
| `prompts.json` | Base de datos local en formato JSON con todos los prompts clasificados. |
| `README.md` | Este documento de presentación y guía de uso. |
| `LICENSE` *(opcional)* | Licencia del proyecto, define los términos de uso. |
---
## 🚀 Despliegue en Hugging Face Spaces
1. **Crear un Space** en [Hugging Face](https://huggingface.co/spaces):
- Tipo: **Gradio**.
- Licencia: la que prefieras.
2. **Subir archivos**: `app.py`, `requirements.txt`, `README.md` y opcionalmente `LICENSE`.
3. **Configurar Secrets** (en *Settings → Repository secrets*):
- `ADMIN_PASSWORD`: tu contraseña para el modo admin.
4. **Guardar y construir** el Space.
Hugging Face instalará automáticamente las dependencias y lanzará la app.
---
## 🔑 Uso del modo admin
1. En la interfaz, busca la sección **Acceso admin**.
2. Ingresa la contraseña configurada en `ADMIN_PASSWORD`.
3. Una vez validada, se desbloquearán las herramientas para:
- Agregar prompts (individual o lista).
- Editar o eliminar existentes.
4. Los cambios se guardan automáticamente en `prompts.json`.
---
## 👥 Uso del modo cliente
- **Explorar**: Navega por las categorías Personajes y Fotografía profesional.
- **Copiar todos**: Botón para copiar todos los prompts de una categoría.
- **Descargar JSON**: Botón para descargar la categoría completa.
---
## 📌 Ejemplo de prompt
**Categoría:** Personajes