Calling Python Functions from Node.js Using a Command‑Line Interface

In Node.js, calling Python methods is often done through REST APIs or RPC, but for simple, occasional calls building a full service is costly; this article introduces a lightweight approach.

Principle

The method relies on the command‑line interface: first turn the Python script into a CLI tool, then run that command from Node, allowing seamless invocation of Python code.

Example: a Python function that uses the Pillow (PIL) library to obtain the frame count of a GIF image is wrapped with the fire library to expose a CLI.

1. Write the Python script p.py :

The script installs PIL and fire via pip or pipenv . Using PIL , the n_frames attribute gives the number of frames in a GIF; for PNG/JPG it is 1, and accessing it raises AttributeError , which should be caught.

2. Convert the function to a CLI with fire , then run it from the terminal:

python3 p.py 24m.gif

This command returns the frame count of 24m.gif .

3. Call the CLI from Node.js:

Use child_process.spawn to execute the same command, capturing the output and handling errors as needed.

Conclusion

The key is generating a CLI for the Python code with fire ; its documentation provides further usage details.

Compared with using GraphicsMagick ( gm ) in Node to extract GIF frames—which can take around twenty seconds for a 24 MB, 47‑frame GIF—the Python/PIL approach completes almost instantly.

Both Node and Python have strengths; this lightweight CLI method lets developers combine them flexibly and efficiently to meet business requirements.