Primeros pasos

Esta guía te lleva desde una cuenta vacía hasta ver tu primer robot ejecutándose en NORA. Cada paso enlaza a la guía detallada correspondiente por si necesitas profundizar.

NORA es un orquestador de RPA: el servidor (la consola web) decide qué ejecutar y cuándo, y un agente instalado en una máquina Windows o macOS es quien ejecuta realmente el robot. Conviene tener clara esa separación antes de empezar; si quieres el panorama completo, consulta arquitectura.

flowchart TD
    A[1. Cuenta y workspace] --> B[2. Instalar el agente]
    B --> C[3. Máquina Online]
    C --> D[4. Empaquetar robot y crear proceso]
    D --> E[5. Lanzar job y ver logs]
    E --> F[6. Automatizar: programaciones o API]

1. Crear cuenta e iniciar sesión

1. Abre la consola en https://nora.valisoftconsulting.com y regístrate.
2. Al registrarte se crea tu workspace (organización). Todos tus recursos —máquinas, paquetes, procesos, jobs— pertenecen a ese workspace y están aislados de los demás.
3. Inicia sesión. Si tu organización tiene activado un segundo factor (MFA) o SSO, complétalo aquí.

Consejo

Puedes invitar a más miembros al workspace desde Settings. Los roles determinan quién puede crear máquinas, publicar releases o lanzar jobs.

2. Instalar el agente en una máquina

El agente es el software que corre en la máquina donde se ejecuta el robot. Antes de instalarlo, primero hay que crear la máquina en la consola (el siguiente paso te da la clave que el agente necesita).

• Sistemas soportados: Windows 10+ o macOS 12+.
• Conectividad: la máquina debe poder alcanzar el servidor por HTTPS (puerto 443).

El procedimiento completo (ejecutable, instalación con pip, servicio de arranque automático, logs y solución de problemas) está en instalación del agente.

3. Registrar y aprobar la máquina

1. En la consola ve a Machines y crea una nueva máquina.

2. Al crearla, NORA genera una Machine Key con el prefijo nora_mk_.... Es el secreto que autentica al agente; cópiala en ese momento.

3. Instala el agente (paso 2) usando esa clave. El paquete descargable trae un .env preconfigurado; si instalas desde el código fuente, define las variables:

   export NORA_API_URL=https://nora-api.valisoftconsulting.com/api/v1
   export NORA_MACHINE_KEY=nora_mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   python -m nora_agent

4. El agente envía un heartbeat cada 30 segundos. En menos de 30 s la máquina debería aparecer como Online en la consola.

La Machine Key es sensible

Si se pierde, se regenera desde Machines → (tu máquina) → Regenerar Key. Detalles de estados, conexión y mantenimiento en máquinas.

4. Empaquetar un robot y crear un proceso

Un robot es tu código (por ejemplo main.py más un requirements.txt). Para llevarlo a NORA se empaqueta como un release dentro de un paquete, y luego se crea un proceso que asocia ese paquete a las máquinas donde correrá.

Usa el CLI nora (incluido en el nora-sdk) desde la carpeta del robot:

pip install nora-sdk

# 1) Inicia sesión en el CLI
nora login --api-url https://nora-api.valisoftconsulting.com/api/v1

# 2) Empaqueta el robot (excluye venv, cachés y secretos automáticamente)
nora package --entry main.py

# 3) Publica el release en el Robots Center
#    (crea el paquete si no existe)
nora release push

• nora package genera un .zip y escribe/actualiza el manifiesto nora.json (campos name, version, entry_point). La versión se auto-incrementa (parche por defecto; usa --bump minor|major o --version X.Y.Z).
• Un escaneo de secretos aborta el empaquetado si detecta claves o .env reales; corrígelo antes de continuar (o, con cuidado, --allow-secrets).
• Tras publicar el release, crea el proceso en la consola: ve a Processes, elige el paquete/versión y las máquinas elegibles.

Más detalle sobre versiones, manifiesto y procesos en procesos y paquetes.

Nota

Si tu robot no incluye requirements.txt, el agente no instalará dependencias: empaquétalo junto al código.

5. Lanzar un job y ver los logs

Un job es una ejecución concreta de un proceso en una máquina.

1. En Processes, abre tu proceso y pulsa Run (Lanzar). Si tienes varias máquinas elegibles, elige una.
2. NORA crea el job y lo asigna a una máquina Online. El agente descarga el release, instala dependencias y ejecuta el entry_point.
3. Sigue la ejecución en Jobs: verás el estado (en cola, ejecutando, completado o fallido), el progreso y los logs en vivo que tu robot emite con sdk.log(...) y sdk.update_progress(...).

Estados, reintentos y diagnóstico en jobs.

6. Opcional: automatizar

Con tu primer robot funcionando, puedes dejar de lanzarlo a mano:

• Programaciones y triggers: ejecuta el proceso por horario (cron) o ante eventos. Ver programaciones y triggers.

• API pública: lanza jobs desde tus propios sistemas con una API Key (X-API-Key: nora_ak_...). Las respuestas vienen envueltas en {"success": true, "data": ...}.

  curl -X POST https://nora-api.valisoftconsulting.com/api/v1/jobs/trigger \
    -H "X-API-Key: nora_ak_xxxxxxxxxxxxxxxxxxxx" \
    -H "Content-Type: application/json" \
    -d '{"process_id": "00000000-0000-0000-0000-000000000000"}'

  El único campo obligatorio es process_id. Si omites machine_id, NORA elige automáticamente una máquina activa y en línea del workspace. Crea la clave en Settings → API Keys. Ver autenticación y disparar jobs.

Resumen del flujo

Paso	Dónde	Resultado
1	Consola web	Workspace creado, sesión iniciada
2	Máquina (Win/macOS)	Agente instalado
3	Machines	Máquina Online con nora_mk_...
4	CLI nora + Processes	Release publicado y proceso creado
5	Processes / Jobs	Primer job ejecutado, logs visibles
6	Schedules / API	Ejecución automatizada