Flowire Code Nodes

Code execution node package for Flowire workflow automation.

This package is intentionally separate from fw-nodes-core so servers can opt into code execution support by installing this package.

Installation

cd flowire-app/backend
uv pip install fw-nodes-code

Enable it in your .env file:

INSTALLED_NODE_PACKAGES=fw-nodes-core,fw-nodes-code

Included Node

The node supports a runtime input (default latest) so you can route different versions to different sandbox services (for example 3.13, 3.9, 20).

Sandbox Services

This package includes the sandbox runtimes used by the Code node:

• js-sandbox/ - JavaScript sandbox (isolated-vm + Fastify)
• py-sandbox/ - Python sandbox (FastAPI + subprocess execution)

Local sandbox commands

cd fw-nodes-code
just js-sandbox-install
just py-sandbox-install
just js-sandbox
just py-sandbox

Environment Variables

• CODE_NODE_SANDBOX_URL_MAP - JSON object mapping runtime keys to sandbox URLs.

Example:

CODE_NODE_SANDBOX_URL_MAP='{
  "javascript@latest":"http://localhost:3100",
  "javascript@20":"http://localhost:3110",
  "python@latest":"http://localhost:3200",
  "python@3.13":"http://localhost:3213",
  "python@3.9":"http://localhost:3209"
}'

Runtime keys are resolved as:

1. {language}@{runtime} (for example python@3.13)
2. {language}@latest
3. (no fallback route; configuration must exist in the map)

If CODE_NODE_SANDBOX_URL_MAP is not set, defaults are used:

• javascript@latest -> http://localhost:3100
• python@latest -> http://localhost:3200

Development

just install
just js-sandbox-install
just py-sandbox-install
just js-sandbox
just py-sandbox
just test
just lint