We have released new Analysis runtimes to bring you better performance, modern language features, and more control over your dependencies.
If you check your existing scripts, you will notice your current environment is now labeled node-legacy or python-legacy. While these scripts continue to run, we encourage upgrading to our new 2025 runtimes to take advantage of faster execution and better security.
Here is how to choose the right upgrade path.
1. The Recommended Path: Move to Deno
Target: Most users currently on node-legacy.
If you are upgrading from node-legacy, we strongly recommend switching to deno-rt2025.
The old legacy runtime came with libraries (like the SDK and Moment.js) pre-installed. Deno keeps this simplicity but makes it modern and faster. You don’t need to bundle code or manage a package.json file. You simply import the libraries you need via URL, and they are cached automatically.
Why switch to Deno?
- Zero config: No bundling required.
- Modern Syntax: Native TypeScript support and top-level await.
- Speed: Faster cold starts compared to Node.js.
- Package Versioning: Reliable dependency versioning for your script.
How to migrate:
Change your imports. Instead of require, use standard import statements.
// Old (Node Legacy)
const { Analysis } = require("@tago-io/sdk");
// New (Deno)
import { Analysis } from "npm:@tago-io/sdk";
2. Local Development: node-rt2025
Target: Teams with local build pipelines using tagoio-builder.
It is important to note that node-rt2025 is not a direct drop-in replacement for node-legacy.
The legacy runtime included several pre-installed libraries (like the TagoIO SDK). The new node-rt2025 is a clean environment. It does not have the SDK or other libraries pre-installed.
Who is this for?
This runtime is designed for companies and developers who already have a production-grade workflow. If you develop locally and use the TagoIO CLI or tagoio-builder to bundle your dependencies before uploading, this is the runtime for you.
- Choose this if: You already pack your application locally and prefer not have to update to Deno.
- Avoid this if: You write code directly in the browser and expect
require('@tago-io/sdk')to work instantly without local setup. Use Deno instead.
3. Python Users: python-rt2025
For Python developers, the upgrade is straightforward and brings a major improvement: Remote Package Installation.
You no longer need to rely only on pre-installed packages. You can declare your requirements inside the script metadata, and the runtime will install them for you.
# /// script
# dependencies = [
# "tagoio-sdk",
# "pandas",
# "requests"
# ]
# ///
from tagoio_sdk import Analysis
import pandas as pd
Documentation
You can learn more about the specifics of each environment in our documentation:
Read Analysis Runtimes Documentation →