metadata

title: 42CodeRunner Backend
emoji: 🚀
colorFrom: blue
colorTo: indigo
sdk: docker
sdk_version: latest
app_file: app.py
pinned: false

42CodeRunner - Backend

Este es el backend para 42CodeRunner, un servicio que permite compilar y ejecutar código C de forma segura a través de una API REST.

Requisitos

Python 3.8+
GCC (para compilar código C)
Docker (opcional, para ejecutar en contenedor)

Instalación

Instalación local

# Clonar el repositorio
git clone https://github.com/yourusername/42CodeRunner.git
cd 42CodeRunner/backend

# Crear entorno virtual (opcional pero recomendado)
python -m venv venv

# Activar entorno virtual
# En Windows
venv\Scripts\activate
# En Linux/Mac
# source venv/bin/activate

# Instalar dependencias
pip install -r requirements.txt

# Ejecutar el servidor
python app.py

El servidor estará disponible en http://localhost:5000

Instalación con Docker

# Construir la imagen
docker build -t 42coderunner-backend .

# Ejecutar el contenedor
docker run -p 5000:5000 42coderunner-backend

API

Ejecutar código C

Endpoint: POST /api/execute

Cuerpo de la solicitud:

{
  "code": "#include <stdio.h>\n\nint main() {\n    printf(\"Hello, World!\\n\");\n    return 0;\n}"
}

Respuesta exitosa:

{
  "success": true,
  "output": "Hello, World!\n",
  "error": "",
  "execution_time": 0.023
}

Respuesta con error:

{
  "success": false,
  "error": "main.c:3:5: error: expected ';' before 'printf'"
}

Verificar estado del servicio

Endpoint: GET /api/health

Respuesta:

{
  "status": "ok"
}

Seguridad

El servicio implementa las siguientes medidas de seguridad:

Límite de tiempo de ejecución (5 segundos por defecto)
Ejecución en archivos temporales con nombres aleatorios
Limpieza automática de archivos temporales

Despliegue en Hugging Face

Para desplegar este servicio en Hugging Face Spaces:

Crea un nuevo Space en Hugging Face
Selecciona Docker como tipo de espacio
Sube los archivos del backend (incluyendo el Dockerfile)
Configura el espacio para exponer el puerto 5000

Licencia

MIT