Version de Escritorio

QANode Desktop es una aplicacion Community Edition sin restricciones en las funciones principales de flujo.

Ventajas del Escritorio

Instalacion

Consulta Instalacion para instrucciones completas.

Requisitos Minimos

• Windows 10/11 (64-bit)
• RAM: 4 GB minimo (8 GB recomendado)
• Disco: 500 MB para instalacion + espacio para datos

Primera Ejecucion

En el primer inicio, QANode:

1. Muestra progreso en splash screen
2. Inicializa PostgreSQL embebido
3. Ejecuta migraciones (crea tablas)
4. Inicia servidor API
5. Abre la interfaz principal

La primera inicializacion puede tardar algunos segundos extra mientras termina la preparacion de la base de datos.

Estructura de Datos

QANode guarda datos en carpetas de usuario:

%APPDATA%\QANode\
├── pg-data/              # Datos de PostgreSQL embebido
├── storage/              # Artefactos (screenshots, PDFs)
└── logs/                 # Logs de la app

%USERPROFILE%\Documents\QANode\
└── custom nodes/         # Nodos personalizados locales
    └── sample-hash-node/ # Nodo de ejemplo

Importante: no modifiques manualmente archivos dentro de pg-data/.

Nodos Personalizados Locales

Desktop soporta nodos locales: archivos JavaScript detectados y cargados automaticamente.

Carpeta de Nodos

%USERPROFILE%\Documents\QANode\custom nodes\

Crear un Nodo Local

1. Crea un archivo con extension .node.js, .node.mjs o .node.cjs
2. Exporta manifest y execute
3. QANode detecta cambios automaticamente en ~1.5 segundos

Ejemplo: .node.js (CommonJS)

// mi-nodo.node.js
module.exports = {
  manifest: {
    type: 'mi-nodo',
    name: 'Mi Nodo',
    category: 'Mis Nodos',
    inputSchema: {
      texto: { type: 'string', required: true },
    },
    outputSchema: {
      resultado: { type: 'string' },
    },
  },
  async execute({ inputs }) {
    return {
      status: 'success',
      outputs: { resultado: String(inputs.texto || '').toUpperCase() },
      logs: [`Procesado: ${inputs.texto}`],
      artifacts: [],
    };
  },
};

Ejemplo: .node.mjs (ESM)

// mi-nodo.node.mjs
export const manifest = {
  type: 'mi-nodo-mjs',
  name: 'Mi Nodo MJS',
  category: 'Mis Nodos',
  inputSchema: {
    texto: { type: 'string', required: true },
  },
  outputSchema: {
    resultado: { type: 'string' },
  },
};

export async function execute({ inputs }) {
  return {
    status: 'success',
    outputs: { resultado: String(inputs.texto || '').toUpperCase() },
    logs: [`Procesado: ${inputs.texto}`],
    artifacts: [],
  };
}

Detalles completos: Nodos Locales Desktop.

Hot Reload

El provider local monitorea la carpeta de nodos y recarga automaticamente:

• Intervalo: 1.5 segundos
• Deteccion: fecha de modificacion + tamano de archivo
• Recarga: automatica, sin reiniciar la app

Tema Nativo

Desktop soporta integracion con tema claro/oscuro:

• Claro: interfaz clara con barra de titulo clara
• Oscuro: interfaz oscura con barra de titulo oscura

Escritorio vs Web

Solucion de Problemas

La app no inicia

• Verifica que no haya otra instancia ejecutandose
• Prueba ejecutar como administrador
• Revisa conflictos de puertos

La base de datos no inicia

• %APPDATA%\QANode\pg-data puede estar corrupta
• Renombra/elimina la carpeta y reinicia (habra perdida de datos)

Los nodos locales no aparecen

• Verifica extension: .node.js, .node.mjs, .node.cjs
• Verifica exports: manifest y execute
• Para .node.js, usa CommonJS (module.exports) o configura type: "module" en package.json
• Abre %APPDATA%\@qanode\desktop\desktop-main.log y busca Failed loading

Verificacion rapida de errores de importacion

1. Abre Configuraciones > Providers y prueba Desktop Local JS Provider
2. Revisa %APPDATA%\@qanode\desktop\desktop-main.log
3. Busca mensajes como:

• Failed loading ".../tu-nodo.node.mjs": Cannot find package 'x'
• Unexpected token 'export' (normalmente .node.js con sintaxis ESM sin type: "module")

Consejos

• Usa .node.js con CommonJS para compatibilidad simple
• Usa .node.mjs cuando necesites ESM explicito
• Mantén una carpeta por nodo con su package.json
• Aprovecha hot-reload para iterar rapido