feat(deploy): despliegue a Hugging Face Spaces (Dockerfile raíz + deploy_hf.ps1 + frontmatter)

.env.example

@@ -29,21 +29,26 @@ CONFIDENCE_THRESHOLD=0.25
 MAX_UPLOAD_MB=50
 
 # -----------------------------------------------------------------------------------
-# 3) Despliegue UI -> ShinyApps.io (rsconnect)
-#    Tokens en: https://www.shinyapps.io/admin/#/tokens
-#    Uso: rsconnect add --account $SHINYAPPS_ACCOUNT --name $SHINYAPPS_ACCOUNT \
-#         --token $SHINYAPPS_TOKEN --secret $SHINYAPPS_SECRET
-# -----------------------------------------------------------------------------------
-SHINYAPPS_ACCOUNT=
-SHINYAPPS_TOKEN=
-SHINYAPPS_SECRET=
+# 3) Despliegue -> Hugging Face Spaces (SDK Docker)  [VÍA ACTIVA — ver docs/ejecucion.md §5]
+#    HF construye el Dockerfile de la raíz (gateway FastAPI: UI / + API /api).
+#    Token (write) en: https://huggingface.co/settings/tokens
+#    Crea el Space (una vez, web): https://huggingface.co/new-space -> SDK "Docker".
+#    Deploy:  .\scripts\deploy_hf.ps1
+# -----------------------------------------------------------------------------------
+HF_SPACE_ID=                              # <usuario>/<space>, p. ej. alexprieto/agrovision
+# (HF_TOKEN se define en la sección 5; sirve tanto para el Space como para el modelo.)
 
 # -----------------------------------------------------------------------------------
-# 4) Despliegue Backend -> Render (opcional, para deploy por API/CI)
-#    API Key en: https://dashboard.render.com/u/settings
+# 3b) Alternativas de despliegue (opcionales):
+#   - Render (Docker, free): backend/Dockerfile + render.yaml. API en dashboard.render.com/u/settings
+#   - Posit Connect (de pago): rsconnect deploy fastapi (scripts/deploy_prod.ps1).
+#     OJO: shinyapps.io NO hospeda FastAPI (solo Shiny); estas vars solo aplican a Posit Connect.
 # -----------------------------------------------------------------------------------
 RENDER_API_KEY=
 RENDER_SERVICE_ID=
+SHINYAPPS_ACCOUNT=
+SHINYAPPS_TOKEN=
+SHINYAPPS_SECRET=
 
 # -----------------------------------------------------------------------------------
 # 5) Modelo de conteo + Hugging Face Hub

Dockerfile

@@ -0,0 +1,49 @@
+# =====================================================================================
+# Dockerfile para Hugging Face Spaces (SDK: docker) — gateway AgroVisión.
+# HF construye ESTE archivo (debe estar en la raíz del repo) y lo corre como el
+# usuario 1000 (HOME=/home/user). El gateway FastAPI sirve la UI Astro compilada en /
+# y la API en /api. Puerto: 8000 (declarado en README.md con `app_port: 8000`).
+#
+# Multi-stage: (1) Node compila Astro; (2) Python/uv corre el gateway con el build
+# de Astro copiado a backend/static. BYOK: sin secretos en la imagen (las llaves de
+# datos las pone el usuario por sesión vía cabeceras X-User-*).
+#
+# Local/Render usan backend/Dockerfile; este es el equivalente endurecido para HF.
+# =====================================================================================
+
+# --- Stage 1: build de la UI Astro ---
+FROM node:22-bookworm-slim AS ui
+WORKDIR /ui
+RUN corepack enable
+COPY frontend/package.json frontend/pnpm-lock.yaml frontend/pnpm-workspace.yaml ./
+RUN pnpm install --frozen-lockfile
+COPY frontend/ ./
+RUN pnpm build
+
+# --- Stage 2: backend FastAPI (CPU), como usuario no-root (requisito de HF Spaces) ---
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
+
+# HF Spaces ejecuta el contenedor como UID 1000: crear el usuario ANTES de copiar.
+RUN useradd -m -u 1000 user
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH \
+    UV_PROJECT_ENVIRONMENT=/home/user/app/.venv \
+    UV_LINK_MODE=copy \
+    UV_CACHE_DIR=/home/user/.cache/uv \
+    COUNTING_ENABLED=false \
+    EVENTS_PERSIST=false
+
+WORKDIR /home/user/app
+
+# Dependencias (capa cacheable) — desde el lockfile, sin dev.
+COPY --chown=user pyproject.toml uv.lock ./
+USER user
+RUN uv sync --no-dev --frozen
+
+# Código + UI Astro compilada (servida por el gateway en /).
+COPY --chown=user backend/ ./backend/
+COPY --chown=user --from=ui /ui/dist/ ./backend/static/
+
+EXPOSE 8000
+# --no-sync: usa el venv ya construido en el build (no re-resuelve en runtime).
+CMD ["uv", "run", "--no-sync", "uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -1,3 +1,17 @@
+---
+title: AgroVisión
+emoji: 🫐
+colorFrom: green
+colorTo: blue
+sdk: docker
+app_port: 8000
+pinned: false
+license: agpl-3.0
+---
+
+<!-- ↑ Frontmatter requerido por Hugging Face Spaces (SDK Docker). En GitHub se ve
+     como una tabla. El runbook de despliegue está en docs/ejecucion.md §5. -->
+
 # AgroVisión — Plataforma de Monitoreo Agronómico
 
 Plataforma de [AgroVisión](docs/reference/description_proyecto_agrovision.md) para monitoreo agronómico de precisión: **gestión de parcelas**, **teledetección NDVI** (Sentinel-2, 5 años), **agente conversacional (RAG)** y **conteo de plantas por dron** (este último **en desarrollo**). Backend **FastAPI** (monolito modular), persistencia **Supabase (PostGIS) BYOK**, y UI en **migración de Shiny → Astro + Tailwind** (Agro-Stack).

scripts/deploy_hf.ps1

@@ -0,0 +1,64 @@
+# scripts/deploy_hf.ps1 — Despliegue de AgroVisión a Hugging Face Spaces (SDK Docker).
+#
+# El Space es un repo git en huggingface.co. HF construye el `Dockerfile` de la raíz
+# (gateway FastAPI: UI Astro en / + API en /api) y lo sirve en el puerto `app_port`
+# del README.md (8000). NO se compila ni empaqueta en local: solo se hace `git push`
+# y HF construye en su lado.
+#
+# Requisitos (en .env, NO se versiona):
+#   HF_TOKEN=hf_xxx              # token con permiso de escritura (huggingface.co/settings/tokens)
+#   HF_SPACE_ID=<usuario>/<space>   # p. ej. alexprieto/agrovision  (crea el Space ANTES, SDK=Docker)
+#
+# Crear el Space una vez (web): huggingface.co/new-space -> SDK "Docker" -> Blank.
+# BYOK: no se ponen secretos de datos en el Space; el usuario pega sus llaves por sesión.
+#
+# Uso:  .\scripts\deploy_hf.ps1
+param(
+    [string]$SpaceId = "",   # si se omite, se toma de HF_SPACE_ID (.env)
+    [switch]$Force           # fuerza el push (sobrescribe el historial del Space)
+)
+$ErrorActionPreference = "Stop"
+$root = Split-Path -Parent $PSScriptRoot
+Set-Location $root
+
+Write-Host "=== Deploy AgroVisión -> Hugging Face Spaces ===" -ForegroundColor Cyan
+
+# Cargar HF_TOKEN / HF_SPACE_ID del .env (sin pisar lo que ya exista en la sesión).
+if (Test-Path ".env") {
+    Get-Content ".env" | ForEach-Object {
+        if ($_ -match '^\s*(HF_TOKEN|HF_SPACE_ID)\s*=\s*(.+)$') {
+            $k = $matches[1]; $v = $matches[2].Trim().Trim('"').Trim("'")
+            if ($v -and -not [Environment]::GetEnvironmentVariable($k)) { Set-Item "env:$k" $v }
+        }
+    }
+}
+if (-not $SpaceId) { $SpaceId = $env:HF_SPACE_ID }
+
+if (-not $env:HF_TOKEN) { Write-Error "Falta HF_TOKEN en .env (token de escritura de Hugging Face)."; exit 1 }
+if (-not $SpaceId -or $SpaceId -notmatch '^[^/]+/[^/]+$') {
+    Write-Error "Falta HF_SPACE_ID válido (formato <usuario>/<space>). Pon HF_SPACE_ID en .env o pasa -SpaceId."
+    exit 1
+}
+
+# El dueño del Space (parte antes de '/') hace de usuario en la URL autenticada.
+$owner = $SpaceId.Split("/")[0]
+$remote = "https://${owner}:$($env:HF_TOKEN)@huggingface.co/spaces/$SpaceId"
+
+# Aviso: el Space debe existir (SDK Docker). El primer push suele necesitar -Force
+# porque el Space arranca con un commit inicial (README) distinto a nuestro historial.
+Write-Host "Space: huggingface.co/spaces/$SpaceId  (rama main)" -ForegroundColor Yellow
+Write-Host "Empujando el repo (HEAD -> main); HF construirá el Dockerfile..." -ForegroundColor Yellow
+
+$pushArgs = @("push")
+if ($Force) { $pushArgs += "--force" }
+$pushArgs += @($remote, "HEAD:main")
+
+# Nota: el token va en la URL solo para este push (no se guarda como remote).
+& git @pushArgs
+if ($LASTEXITCODE -ne 0) {
+    Write-Warning "El push falló. Si es el primer deploy, reintenta con:  .\scripts\deploy_hf.ps1 -Force"
+    exit 1
+}
+
+Write-Host "`n=== Push completado. Sigue el build en huggingface.co/spaces/$SpaceId ===" -ForegroundColor Green
+Write-Host "Cuando termine, abre la URL del Space: la UI carga en / y la API en /api." -ForegroundColor Green