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.
| Requirement | Version |
|---|---|
| Node.js | 18.0 or higher |
| Python | 3.10 or higher |
| Operating System | Linux, macOS, or Windows |
| Network | Outbound HTTPS to api.tensorify.io |
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.
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.
The CLI authenticates using an API key from your Tensorify workspace.
- Sign in at app.tensorify.io
- Go to Settings → API Keys
- 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.
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>"]
- Quick Start Guide — build and run your first workflow
- CLI Reference — all commands and flags
