nebula_deployment_instructions.md

# 📘 Instrucciones de Despliegue - NEBULA EMERGENT en Hugging Face Spaces

## 🚀 Opción 1: Despliegue Automático (Recomendado)

### Requisitos Previos
- Tener Git instalado en tu sistema
- Tener Python 3.8+ instalado
- Tener una cuenta en Hugging Face
- Tener tu token de acceso de Hugging Face

### Pasos Automáticos

1. **Instalar Hugging Face CLI** (si no lo tienes):
```bash
pip install huggingface-hub
```

2. **Iniciar sesión en Hugging Face**:
```bash
huggingface-cli login
```
Ingresa tu token cuando se te solicite.

3. **Crear una carpeta para el proyecto**:
```bash
mkdir nebula-emergent-deployment
cd nebula-emergent-deployment
```

4. **Guardar los archivos**:
   - Guarda `app.py` en la carpeta
   - Guarda `requirements.txt` en la carpeta
   - Guarda `README.md` en la carpeta
   - Guarda `deploy.sh` en la carpeta

5. **Hacer el script ejecutable**:
```bash
chmod +x deploy.sh
```

6. **Ejecutar el script de despliegue**:
```bash
./deploy.sh
```

---

## 🛠️ Opción 2: Despliegue Manual Paso a Paso

### Paso 1: Crear el Space en Hugging Face

1. Ve a [https://huggingface.co/new-space](https://huggingface.co/new-space)
2. Completa los campos:
   - **Space name**: `nebula-emergent`
   - **License**: MIT o Apache 2.0
   - **Select the Space SDK**: **Gradio**
   - **Space hardware**: CPU basic (gratis) o CPU upgrade para mejor rendimiento
   - **Visibility**: Public o Private según prefieras

3. Haz clic en **"Create Space"**

### Paso 2: Subir los Archivos

#### Opción A: Usando la Interfaz Web

1. Una vez creado el Space, estarás en la página del repositorio
2. Haz clic en **"Files"** en el menú superior
3. Haz clic en **"+ Add file"** → **"Upload files"**
4. Sube estos tres archivos:
   - `app.py` (archivo principal de la aplicación)
   - `requirements.txt` (dependencias)
   - `README.md` (documentación)
5. Escribe un mensaje de commit: "Initial deployment of NEBULA EMERGENT"
6. Haz clic en **"Commit changes to main"**

#### Opción B: Usando Git

1. Clona tu Space recién creado:
```bash
git clone https://huggingface.co/spaces/Agnuxo/nebula-emergent
cd nebula-emergent
```

2. Copia los archivos al repositorio:
```bash
# Asumiendo que tienes los archivos en el directorio padre
cp ../app.py .
cp ../requirements.txt .
cp ../README.md .
```

3. Añade y confirma los cambios:
```bash
git add .
git commit -m "🚀 Deploy NEBULA EMERGENT - Physical Neural Computing System"
```

4. Sube los cambios:
```bash
git push origin main
```

### Paso 3: Verificar el Despliegue

1. Ve a tu Space: [https://huggingface.co/spaces/Agnuxo/nebula-emergent](https://huggingface.co/spaces/Agnuxo/nebula-emergent)
2. Verás el estado de construcción en la parte superior
3. Espera 3-5 minutos para que se complete la construcción
4. Una vez listo, verás la interfaz de Gradio funcionando

---

## 🧪 Prueba Local (Opcional)

Antes de desplegar, puedes probar la aplicación localmente:

1. **Instalar dependencias**:
```bash
pip install -r requirements.txt
```

2. **Ejecutar la aplicación**:
```bash
python app.py
```

3. **Abrir en el navegador**:
   - Ve a `http://localhost:7860`
   - Prueba las diferentes funcionalidades

---

## 🔧 Solución de Problemas

### Error: "No module named 'numba'"
**Solución**: El Space puede tardar en instalar todas las dependencias. Espera 5-10 minutos y recarga la página.

### Error: "Memory limit exceeded"
**Solución**: 
- Reduce el número de neuronas en la configuración inicial
- Considera actualizar a un hardware con más memoria

### Error: "Build failed"
**Solución**:
1. Revisa los logs de construcción en la pestaña "Logs"
2. Verifica que todos los archivos estén presentes
3. Asegúrate de que `requirements.txt` esté correctamente formateado

### El Space no responde
**Solución**:
- Los Spaces gratuitos se duermen después de 48 horas de inactividad
- Haz clic en "Restart Space" para reactivarlo
- Considera cambiar a un hardware persistente si necesitas disponibilidad 24/7

---

## 📊 Configuración de Hardware Recomendada

| Tipo de Uso | Hardware | Neuronas Max | Costo |
|-------------|----------|--------------|-------|
| Demo/Pruebas | CPU basic | 1,000 | Gratis |
| Uso Regular | CPU upgrade | 10,000 | $0.03/hora |
| Producción | T4 GPU small | 100,000 | $0.60/hora |
| Investigación | A10G GPU | 1,000,000 | $1.05/hora |

---

## 🎯 Características del Space Desplegado

Una vez desplegado, tu Space tendrá:

### Pestañas Principales:
1. **🚀 System Control**: Control principal del sistema
   - Configuración de neuronas (100 - 100,000)
   - Activación/desactivación de física
   - Visualización 3D en tiempo real
   - Métricas del sistema

2. **🧩 Problem Solving**: Resolución de problemas
   - Reconocimiento de patrones en imágenes
   - Problema del viajante (TSP)
   - Visualización de soluciones

3. **📊 Data Export**: Exportación de datos
   - Estado del sistema en JSON
   - Historial de métricas en CSV

4. **📚 Documentation**: Documentación completa

### Funcionalidades:
- ✅ Simulación de hasta 100,000 neuronas
- ✅ Dinámicas gravitacionales Barnes-Hut
- ✅ Campo de fotones con propagación cuántica
- ✅ Efectos cuánticos (superposición y entrelazamiento)
- ✅ Termodinámica (recocido simulado)
- ✅ Visualización 3D interactiva con Plotly
- ✅ Métricas en tiempo real
- ✅ Exportación de datos

---

## 🔄 Actualización del Space

Para actualizar tu Space con nuevas características:

1. **Modifica los archivos localmente**
2. **Commit y push los cambios**:
```bash
git add .
git commit -m "Update: [descripción de los cambios]"
git push origin main
```
3. **El Space se reconstruirá automáticamente**

---

## 📞 Soporte y Contacto

Si tienes problemas con el despliegue:

1. **Revisa la documentación de Hugging Face Spaces**: [https://huggingface.co/docs/hub/spaces](https://huggingface.co/docs/hub/spaces)
2. **Comunidad de Hugging Face**: [https://discuss.huggingface.co/](https://discuss.huggingface.co/)
3. **Issues del proyecto**: Puedes abrir un issue en GitHub
4. **Contacto del autor**: [email protected]

---

## ✅ Checklist de Verificación

Antes de considerar el despliegue completo, verifica:

- [ ] El Space está accesible en la URL pública
- [ ] La visualización 3D funciona correctamente
- [ ] Puedes crear sistemas con diferentes números de neuronas
- [ ] La evolución del sistema se ejecuta sin errores
- [ ] Las métricas se actualizan en tiempo real
- [ ] El solver TSP genera soluciones
- [ ] La exportación de datos funciona
- [ ] El Space no muestra errores en los logs

---

## 🎉 ¡Felicitaciones!

Una vez completado el despliegue, tendrás tu propio sistema de computación neuronal física funcionando en la nube, accesible desde cualquier parte del mundo.

**URL de tu Space**: https://huggingface.co/spaces/Agnuxo/nebula-emergent

---

*Creado por Francisco Angulo de Lafuente - NEBULA EMERGENT v1.0.0*