Skip to content

Proc Launcher (f8.proclauncher)

Launches an external OS process (optionally detached).

  • Service class: f8.proclauncher
  • Version: 0.0.1
  • Source directory: f8/proclauncher
  • Tags: utility, process, launcher

When to Use

  • Use f8.proclauncher when the graph needs to start an external helper tool, bridge, browser, or companion process.
  • It is useful when a scenario depends on non-Feel8 software being started alongside the graph.
  • It works best as a lifecycle helper rather than as a data-processing module.

Common Wiring Patterns

  • Treat it as a runtime dependency node rather than a transformation node.
  • Keep it near the part of the graph that depends on the launched tool so the dependency is visually obvious.
  • If only one instance should exist, keep singleton-style settings enabled.

Pitfalls / Gotchas

  • Incorrect path quoting is the most common failure mode, especially on Windows.
  • Detached processes can survive after the graph stops if that behavior is enabled.
  • Prefer absolute paths when the launched tool depends on working directory or environment assumptions.

Service Reference

How to Run

pixi run -e default f8proclauncher
  • Workdir: ../../../
  • Environment overrides: none

Typical Inputs / Outputs

  • Data inputs: none
  • Data outputs: monitor
  • Commands: none

Service State Fields

Name Access Required On Node Schema Description
programPath rw true true string / default= Executable path or command line (quoted if it contains spaces). Cleared when exporting publish JSON.
singleton rw true false boolean / default=True If true, do not start if a previous launch for the same command is still running.
detached rw true false boolean / default=True If true, do not stop the launched process when this service stops.
active rw true false boolean / default=True Service lifecycle state (activate/deactivate).
svcId ro true false string Readonly: current service instance id (svcId).

Key Fields That Matter

  • programPath (Program Path, rw): Executable path or command line (quoted if it contains spaces). Cleared when exporting publish JSON. Schema: string / default=.
  • singleton (Singleton, rw): If true, do not start if a previous launch for the same command is still running. Schema: boolean / default=True.
  • detached (Detached, rw): If true, do not stop the launched process when this service stops. Schema: boolean / default=True.
  • active (Active, rw): Service lifecycle state (activate/deactivate). Schema: boolean / default=True.
  • svcId (Service Id, ro): Readonly: current service instance id (svcId). Schema: string.

Service Commands

None

Service Data Input Ports

None

Service Data Output Ports

Name Required On Node Schema Description
monitor true false object{active, alive, cpu, error, ...} Unified runtime monitor snapshots (health/resource/perf/error).

Operators

None

  • No bundled scenario references this node yet.