Hugging Face's logo

Spaces:
Agnuxo
/
DEMO-nebula-emergent
Sleeping

App Files
xet
Community
DEMO-nebula-emergent / nebula_deployment_instructions.md
Agnuxo's picture
Agnuxo
Upload 6 files
4a0fa9c verified
preview code
|
raw
history blame
6.96 kB

📘 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):
pip install huggingface-hub
  1. Iniciar sesión en Hugging Face:
huggingface-cli login

Ingresa tu token cuando se te solicite.

  1. Crear una carpeta para el proyecto:
mkdir nebula-emergent-deployment
cd nebula-emergent-deployment

  1. 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

  2. Hacer el script ejecutable:

chmod +x deploy.sh
  1. Ejecutar el script de despliegue:
./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

  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:
git clone https://huggingface.co/spaces/Agnuxo/nebula-emergent
cd nebula-emergent
  1. Copia los archivos al repositorio:
# Asumiendo que tienes los archivos en el directorio padre
cp ../app.py .
cp ../requirements.txt .
cp ../README.md .
  1. Añade y confirma los cambios:
git add .
git commit -m "🚀 Deploy NEBULA EMERGENT - Physical Neural Computing System"
  1. Sube los cambios:
git push origin main

Paso 3: Verificar el Despliegue

  1. Ve a tu Space: 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:
pip install -r requirements.txt
  1. Ejecutar la aplicación:
python app.py
  1. 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:
git add .
git commit -m "Update: [descripción de los cambios]"
git push origin main
  1. 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
  2. Comunidad de Hugging Face: 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