EXECUTIONS

Ejecuta código en la nube.
Directamente desde tu aplicación.

Integra la ejecución de código en tu producto por SDK o API. Procesa archivos y tareas en máquinas virtuales aisladas, con recursos definidos para cada ejecución.

Una máquina virtual
para cada Execution.

Cada Execution inicia una máquina virtual para ejecutar tu código. Genera PDF, transforma datos o procesa archivos enviados por tu aplicación.

Cuando termina la Execution, la máquina se apaga. Los resultados y archivos recopilados siguen disponibles para que los recuperes.

Cómo usar Executions.

Ejecuta desde el terminal, usa el panel o integra con tu aplicación.

Usa la CLI.

Inicia una ejecución y consulta su estado desde el terminal. Usa los mismos comandos en scripts para automatizar Executions recurrentes.

Usa el panel.

Crea y supervisa ejecuciones en el panel de runvibe_. Elige el código y los recursos y consulta el estado, los registros y los archivos generados.

Integra tu aplicación con el SDK.

Inicia Executions desde el código de tu aplicación con el SDK. Sigue la ejecución y usa su resultado en el siguiente paso del procesamiento.

Ejecución dentro de tu producto.

Tu aplicación envía una tarea, sigue la ejecución y usa el resultado en el siguiente paso. runvibe_ verifica los permisos y la configuración antes de empezar.

Una aplicación de IA puede enviar un archivo para procesarlo y recuperar los resultados recopilados para continuar la tarea.

Conecta tus herramientas de IA.

Conecta una herramienta compatible con MCP, como Codex, Claude Code o Cursor, para iniciar Executions y recuperar resultados.

CodexKiroGeminiChatGPTGrokDeepSeek

Configura ejecuciones
reutilizables.

Manifiestos TOML.

Describe qué ejecutar y los recursos necesarios en un archivo TOML. Incluye variables, volúmenes, reglas de red y un límite de tiempo. Reutiliza el manifiesto para iniciar ejecuciones con la misma configuración.

Packages en el manifiesto.

Especifica el Package que se usará, el archivo de entrada y sus argumentos. La Execution inicia ese archivo; las llamadas a funciones concretas se realizan en el propio código.

En los usos sujetos a revisión, el contenido exacto del Package debe estar aprobado. La aprobación no sustituye los permisos ni las políticas de ejecución.

Conoce el flujo de aprobación ↗

Volúmenes con datos de entrada.

Pon los archivos del volumen a disposición en la ruta que espera tu script o contenedor. La Execution conserva el volumen original; las copias editables en contenedores son temporales.

Variables de entorno.

Declara en el manifiesto los valores de configuración que necesita el proceso. En las Executions con contenedores, define las variables de cada contenedor.

Credenciales con Secrets.

Guarda tokens, contraseñas y claves de API en el almacén de Secrets. En la configuración de la Execution, asigna una referencia a un Secret a la variable de entorno que espera tu aplicación. El proceso recibe el valor durante la ejecución, sin escribirlo en el código ni en el manifiesto.

Controles de red.

Sin acceso externo.

Desactiva la red de salida para Executions que solo procesan los datos proporcionados.

Destinos permitidos.

Restringe el tráfico saliente por IP, rango o dominio, con protocolos y puertos definidos.

Política aplicada por el host.

El host aplica las reglas y bloquea el acceso a redes privadas, direcciones locales y metadatos de infraestructura, también en modo público.

Separa la descarga de imágenes y la ejecución.

En los contenedores, configura una política para descargar imágenes y otra para ejecutar código. Permitir un registro durante la descarga no permite acceder a él durante la Execution.

Elige el formato
para tu ejecución.

Envía un script, un Package o una configuración de contenedores. Los scripts y Packages pueden usar una imagen preparada en los entornos de ejecución compatibles.

Scripts de Python y Node.js.

Envía código Python o JavaScript directamente y elige un entorno de ejecución. El script se inicia en su directorio de trabajo con las variables y volúmenes que has configurado.

Usa este formato para automatizaciones puntuales, transformaciones de datos o código generado por IA. Las cargas directas no requieren empaquetar el proyecto en un ZIP.

Images con un entorno preparado.

Usa una imagen con herramientas y dependencias ya instaladas. Puedes prepararla en un Workspace. Los scripts y Packages utilizan este entorno en los entornos de ejecución compatibles.

Cada ejecución recibe una copia editable de la imagen. Las instalaciones y cambios se quedan en esa copia, conservando la imagen publicada para futuras Executions.

Contenedores a partir de imágenes OCI.

Especifica una imagen OCI, un comando y variables de entorno. Agrega servicios de apoyo cuando tu Execution los necesite. Los contenedores de una misma Execution comparten CPU, memoria y red.

Usa este formato para aplicaciones ya empaquetadas en contenedores. Los códigos de salida y los registros de cada contenedor están disponibles tras su recopilación.

Packages reutilizables.

Agrupa el código y los archivos del proyecto en un ZIP para subirlos juntos. Usa Packages cuando el procesamiento dependa de varios archivos, como módulos Python y plantillas de informes.

Reutiliza un Package en nuevas Executions sin volver a subir los archivos.

Recupera resultados
y descarga archivos.

Tras la recopilación, usa el ID de la Execution para recuperar resultados y archivos mediante la API, la CLI o MCP. Escribe los resultados estructurados en result.json y los archivos en outputs/.

Resultados estructurados mediante la API.

Escribe datos en result.json. Recupera el resultado JSON mediante la API y úsalo en tu aplicación.

Archivos generados por la Execution.

Guarda informes, documentos y otros archivos en outputs/. Recupera los artefactos mediante la API y solicita el archivo que necesitas. La disponibilidad está sujeta a los límites y periodos de retención de la plataforma.

Usa la CLI o una herramienta de IA.

Usa la CLI para recuperar resultados y descargar artefactos con el ID de la Execution. Con una herramienta de IA conectada mediante MCP, pídele que recupere los resultados o archivos generados y sigue trabajando con ellos.

Registros y métricas de ejecución.

Revisa la salida estándar y los errores en stdout y stderr. Consulta el estado, la duración y las métricas de recursos. Los registros de los contenedores están disponibles tras su recopilación al finalizar la ejecución.

Aislamiento y controles
para cada ejecución.

Kernel dedicado

La Execution se ejecuta en una máquina virtual con un kernel separado del host y de otras ejecuciones. Los contenedores de una misma Execution comparten el kernel de esa máquina.

Redirige puertos para acceso local

Redirige puertos mediante la CLI para Executions activas de contenedores o Packages configuradas sin límite de duración. Los scripts directos no admiten este acceso. La redirección termina con la Execution.

Define los recursos

Elige CPU y memoria para cada ejecución según el trabajo que deba realizar.

Límite de tiempo y cancelación

Establece un límite de tiempo para la Execution y solicita su cancelación cuando necesites detenerla.

Paga por el tiempo
que se ejecuta tu código.

En la nube runvibe_, el procesamiento consume el saldo del plan según los recursos y el tiempo de ejecución.

Los cargos de ejecución terminan con la tarea; la mensualidad y el almacenamiento siguen las reglas del plan.

Calcula mi uso ↗

Inicia la Execution

Código, entradas y configuración definidos

Ejecuta en la nube

El uso depende de los recursos elegidos y del tiempo de ejecución

Recupera los resultados

Ejecución terminada · entorno de cómputo liberado

Preguntas frecuentes.

¿Tengo que crear primero un Workspace?

No. Inicia una Execution con código Python o Node.js, un Package o contenedores. Usa un Workspace cuando quieras preparar y probar una imagen de entorno para reutilizarla.

¿Cómo funcionan juntos un Package y un manifiesto?

Un Package contiene el código y los archivos; el manifiesto define cómo ejecutarlos y qué recursos utilizar. Ver configuración ↗

¿Cómo recibo los resultados en mi aplicación?

Escribe los datos en result.json y los archivos en outputs/. Recupéralos tras su recopilación con el ID de la Execution. Ver resultados y archivos ↗

¿Puedo usar una imagen preparada en un Workspace?

Sí, en los entornos de ejecución que admitan imágenes preparadas. Esto te permite reutilizar un entorno con dependencias instaladas. Las Executions con contenedores utilizan imágenes OCI y su propia configuración.

¿Dónde puedo consultar los errores y el uso de recursos?

En los detalles de la ejecución, consulta el estado, stdout, stderr y las métricas registradas. Los registros de los contenedores se recopilan al finalizar una Execution.

¿Cuándo debo elegir Execution o Workspace?

Usa Execution para procesamientos con un inicio y un final definidos, integrados en tu aplicación o automatización. Elige Workspace para desarrollar, probar tu aplicación y retomar el trabajo en el mismo entorno.

Solicita acceso
para usar Executions.

Explora los planes ↗