Installation & Requirements

Tensorify has two parts: the web editor at app.tensorify.io (no install needed) and the CLI that runs workflows on your machine or server.

System Requirements

RequirementVersion
Node.js18.0 or higher
Python3.10 or higher
Operating SystemLinux, macOS, or Windows
NetworkOutbound HTTPS to api.tensorify.io

Install the CLI

npm install -g @tensorify.io/cli

Verify the install:

tensorify --version

You should see a version number printed. If you get command not found, check that your npm global bin directory is on your PATH.

Set Up a Python Environment

Tensorify generates and runs Python code. We recommend a virtual environment to isolate workflow dependencies:

# Create the environment
python -m venv tensorify-env

# Activate — macOS / Linux
source tensorify-env/bin/activate

# Activate — Windows
tensorify-env\Scripts\activate

The CLI will use whichever Python environment is active when you run it.

Get Your API Key

The CLI authenticates using an API key from your Tensorify workspace.

  1. Sign in at app.tensorify.io
  2. Go to SettingsAPI Keys
  3. Click Create API Key, give it a name, and copy the key

Set it as an environment variable so every CLI command picks it up:

export TENSORIFY_API_KEY="your_key_here"

To make this permanent, add the export line to your shell profile (~/.bashrc, ~/.zshrc, etc.).

You can also pass the key inline for a single command:

TENSORIFY_API_KEY=your_key_here tensorify watch <workflowId>

Your API key has full access to your workspace. Keep it out of source control. Use environment variables or a secrets manager.

Docker

To run a workflow in a container, base your image on a Node.js image with Python available, install the CLI globally, and use tensorify run as your entrypoint:

FROM node:20-slim

RUN apt-get update && apt-get install -y python3 python3-pip python3-venv && rm -rf /var/lib/apt/lists/*
RUN npm install -g @tensorify.io/cli

ENV TENSORIFY_API_KEY=""
ENTRYPOINT ["tensorify", "run"]
CMD ["<your-workflow-id>"]

Next Steps

On this page