Documentación1.0 (latest)
PáginasQuantCloud · 24 / 29

QuantCloud

QuantCloud ejecuta trabajos bulk forward en runners en la nube dedicados que siguen funcionando mientras tu estación de trabajo está apagada o QuantCraft está cerrado. Cada runner ejecuta un trabajo bulk forward a la vez, así que configuras y supervisas un lote por runner. Los runners ejecutan solo algoritmos del IDE: los agentes (incluidas las ejecuciones bulk de agentes) se ejecutan localmente desde AutoTrading. La aplicación de escritorio se conecta a los runners aprovisionados para tu cuenta después de iniciar sesión; no usa tu servicio local de Python para estos trabajos.

Es la contrapartida en la nube de AutoTrading, que ejecuta el mismo tipo de lote en tu máquina local. Esta página cubre lo que haces en la aplicación; la configuración y operación de servidores quedan fuera del alcance de esta documentación.

La página de QuantCloud y su entrada de navegación aparecen cuando la función QuantCloud está habilitada para tu versión.


Comprar un runner en la nube

Haz clic en Buy Cloud Runner y:

  1. Elige un nivel de máquina: cada tarjeta muestra el nombre del nivel, el precio ($X/mo), el tipo de instancia y una breve descripción.
  2. Haz clic en Continue to payment (o ← Back para cambiar de nivel). El siguiente paso muestra un resumen del pedido y los botones de suscripción de PayPal. El pago es una suscripción de PayPal; la aplicación no recopila directamente los datos de la tarjeta.
  3. Tras la aprobación, el runner se aprovisiona y aparece en la página en pocos minutos; usa Refresh runners para comprobarlo.

Necesitas una suscripción activa de QuantCraft que incluya QuantCloud (consulta tu plan).


Tarjetas de runner

Cada runner muestra un estado — Warmup, Running, Loading…, Unavailable o Ready — con su etiqueta y punto de conexión. Los runners recién aprovisionados muestran un banner de warmup (con el tiempo restante) que bloquea temporalmente las ejecuciones bulk, las instalaciones de dependencias y la actualización.

Acciones sobre un runner: Dependencies, New bulk run (o Edit / Stop / Delete / Resume cuando existe un trabajo) y Refresh. Un pie plegable muestra los Packages instalados y el último registro de instalación.


Instalar dependencias

Haz clic en Dependencies en un runner para instalar paquetes de PyPI (el runner usa el mismo Python que los algoritmos bulk/forward, no el .venv de tu IDE local). Si tu algoritmo importa paquetes además de los predeterminados (por ejemplo pandas, numpy), añádelos aquí:

  • Introduce nombres de paquetes separados por comas, opcionalmente con versiones (p. ej. pandas==2.1.0, numpy, scipy>=1.10). Volver a instalar un paquete con una versión nueva sustituye la fijación anterior.
  • Haz clic en Install para ver un registro de instalación en directo; el runner se reinicia tras una instalación correcta para que los paquetes nuevos se importen (puede tardar hasta un minuto).
  • Las instalaciones se bloquean mientras un trabajo bulk está en ejecución (detenlo primero) y durante el warmup.
  • Los paquetes instalados aparecen como insignias de colores (p. ej. pandas 2.1.0) en el panel Packages.
  • Los paquetes que añadiste tienen un botón × para eliminarlos (tras una confirmación Remove package?). Eliminar no reinicia el runner — surte efecto en la siguiente ejecución — y se bloquea mientras hay un trabajo bulk o una instalación en curso.

Instala las mismas bibliotecas que usas en el IDE en Packages (Dependencias) cuando esos paquetes sean necesarios en tiempo de ejecución.


Ejecutar un lote en un runner

  • En un runner inactivo, haz clic en New bulk run. Se abre el mismo cuadro New Run que en AutoTrading — consulta AutoTrading para las pestañas Algorithm / Targets / Schedule & data — vinculado a ese runner. Está disponible el ámbito de destino Screener, de modo que un trabajo en la nube puede operar lo que coincida con un filtro guardado y volver a filtrar según su propio calendario (Refresh interval (days) / Refresh time (ET)) sin que tu estación esté encendida. La primera ejecución de screener en un runner nuevo descarga todo el universo de datos fundamentales (lento); después se actualiza una vez por día UTC. El runner descarga con tu inicio de sesión de QuantCraft y no puede renovarlo, así que en una ejecución de muchos días los nuevos filtrados siguen usando los últimos datos cuando caduca el inicio de sesión. Consulta Screener.
  • Elige tu algoritmo compilado (.qcraft.json), los símbolos o el ámbito de destino, el periodo/marco temporal y, opcionalmente, parámetros del script. Establece timerIntervalMs si tu estrategia define on_timer (Ciclo de vida de la estrategia).
  • Un trabajo por runner: una vez que existe un trabajo verás Edit run, Stop bulk run, Delete run y Resume bulk run en lugar de New. Resume bulk run es para trabajos en pending resume y requiere una cuenta de trading activa.
  • La sección bulk del runner muestra Details y Logs (mismo diseño que la tarjeta bulk local), con Pause / Resume (pausa o reanuda solo el seguimiento del registro en vivo — no pausa el trabajo), Refresh, Download logs (CSV) y Clear logs.

Puedes usar Load / Save en la parte superior del cuadro para reutilizar un preajuste de ejecución (.qcs). Al editar una ejecución bulk existente, el algoritmo (algoId) es fijo: Load actualiza los destinos, el temporizador, el modo de tick y los params, pero no cambia el archivo del algoritmo.


Registros

Cada ejecución bulk forward transmite stdout, stderr y eventos de estado a la pestaña Logs del runner en QuantCloud:

AcciónQué hace
Live streamLas líneas de registro nuevas aparecen mientras se ejecuta.
Pause / ResumePausa o reanuda solo el seguimiento del registro en vivo — no pausa el trabajo; el runner sigue escribiendo.
RefreshVuelve a cargar el final reciente del registro desde el runner.
Download logsExporta el historial visible como CSV.
Clear logsBorra solo la lista en pantalla — no elimina el historial del servidor.

Las líneas más antiguas pueden descartarse cuando el volumen de registros es alto. Usa Refresh si sospechas que solo ves el final del historial completo. Eliminar una ejecución bulk borra el archivo de registro almacenado de ese trabajo en el runner, y los registros de un trabajo abandonado pueden purgarse tras unos 7 días.


Supervisión y detención

  • El estado bulk se consulta aproximadamente cada 5 segundos mientras la página de QuantCloud está activa y cada 30 segundos en caso contrario.
  • Stop bulk run y Delete bulk forward run piden confirmación; eliminar borra el estado guardado en el runner y quita el trabajo de la lista.

Consejos

  • Haz coincidir los paquetes del IDE y del runner — si Test pasa en local pero la ejecución en la nube falla con ImportError, añade el paquete que falta mediante Dependencies.
  • on_timer es para ejecuciones forward — el cuadro de backtest del IDE no configura temporizadores; establece timerIntervalMs en el cuadro bulk forward.
  • on_tick en ejecuciones forward — se activa con cada actualización de precio del bróker de tu bróker conectado mientras se ejecuta el algoritmo; consulta Ciclo de vida de la estrategia.
  • Credenciales del bróker — los trabajos bulk que operan en real o en papel pueden requerir credenciales de bróker enviadas en cada ejecución; sigue las indicaciones del cuadro según tu tipo de cuenta.
  • Carpeta de espacio de trabajo — guardar preajustes .qcs requiere una carpeta de espacio de trabajo vinculada.

Véase también

6 min de lecturaSugerir una edición ↗
QuantCloud — Documentación (1.0 (latest)) | QuantCraft