Skip to main content
UniRTM Logo

UniRTM

GitHub GitHub Workflow Status Continuous Integration Continuous Delivery

Dev tools, env vars, and tasks in one CLI with built-in security.
Inspired by and paying tribute to mise.

Getting Started • Documentation • Dev Tools • Environments • Tasks


What is it?

UniRTM (Universal Runtime Manager) prepares your development environment before each command runs. It keeps project tools, environment variables, and tasks in one .unirtm.toml file so new shells, checkouts, and CI jobs all start from the exact same setup.

  • Install and switch between dev tools like node, python, go, and more.
  • Load environment variables per project directory, including values from .env files and secure secret managers like SOPS.
  • Define and run tasks for building, testing, linting, and deploying projects.

While taking heavy inspiration from the brilliant tool mise (dev tools, env vars, and tasks in one CLI), UniRTM introduces several distinct architectural choices:

  • Pure Go Engine: Extreme parallel downloading capabilities leveraging goroutines.
  • Lightweight Native Shims: Replaces sluggish bash shims with a unified, high-performance Go router. This prevents $PATH explosion while maintaining near-native execution speeds.
  • Unifying Security via Tasks: While keeping the core engine minimal, UniRTM allows you to perfectly integrate external security scanners like Trivy or Syft into your reproducible task workflows.
  • Absolute Locking: Generates a unirtm.lock file that pins the exact checksums and versions of your downloaded tools for reproducible environments.

Supported Platforms

Fully supported on macOS (Apple Silicon / Intel), Linux (glibc & musl/Alpine), and Windows.

Demo

The following demo shows how to use UniRTM to install a specific version of go globally. Notice the speed and the built-in vulnerability scanning!

demo

Quickstart

Install UniRTM

See Getting started for more options.

Via Script (Linux/macOS):

$ curl -sL https://raw.githubusercontent.com/snowdreamtech/UniRTM/main/install.sh | bash
$ ~/.local/bin/unirtm --version
UniRTM v0.1.0 macos-arm64 (2026-05-28)

Via NPM:

npm install -g @snowdreamtech/unirtm

Via PyPI:

pip install snowdreamtech-unirtm

Hook UniRTM into your shell (pick the right one for your shell):

# note this assumes unirtm is located at ~/.local/bin/unirtm
echo 'eval "$(~/.local/bin/unirtm env)"' >> ~/.bashrc
echo 'eval "$(~/.local/bin/unirtm env)"' >> ~/.zshrc
echo '~/.local/bin/unirtm env | source' >> ~/.config/fish/config.fish

Execute commands with specific tools

$ unirtm exec node@20 -- node -v
unirtm node@20.x.x ✓ installed
v20.x.x

Install tools

$ unirtm use --global node@22 go@1.22
$ node -v
v22.x.x
$ go version
go version go1.22.x macos/arm64

See dev tools for more examples.

Manage environment variables

# .unirtm.toml
[env]
SOME_VAR = "foo"
$ unirtm set SOME_VAR=bar
$ echo $SOME_VAR
bar

Note that UniRTM can also load .env files.

Run tasks

# .unirtm.toml
[tasks.build]
description = "build the project"
run = "echo building..."
$ unirtm run build
building...

See tasks for more information.

Example UniRTM project

Here is a combined example to give you an idea of how you can use UniRTM to manage your a project's tools, environment, and tasks with security baked in.

# .unirtm.toml
[tools]
terraform = "1"
aws-cli = "2"
node = "20"

[env]
TF_WORKSPACE = "development"
AWS_REGION = "us-west-2"
NODE_ENV = "production"

[tasks.plan]
description = "Run terraform plan with configured workspace"
run = """
terraform init
terraform workspace select $TF_WORKSPACE
terraform plan
"""

[tasks.validate]
description = "Validate AWS credentials and terraform config"
run = """
aws sts get-caller-identity
terraform validate
"""

[tasks.audit]
description = "Run deep security scans using Trivy and Gitleaks"
run = """
trivy fs --format cyclonedx --output sbom.json .
gitleaks detect --source . --no-banner
"""

[tasks.deploy]
description = "Deploy infrastructure after validation and audit"
depends = ["validate", "audit", "plan"]
run = "terraform apply -auto-approve"

Run it with:

unirtm install # install all required tools specified in .unirtm.toml
unirtm run deploy # automatically runs validation and audit dependencies first

Full Documentation

See snowdreamtech.github.io/UniRTM

Architecture & Environments Comparison

We believe in making deliberate architectural choices to support modern enterprise environments. Here is how UniRTM compares to ecosystem pioneers like mise and asdf across multiple dimensions:

1. Core Architecture & Execution

Dimension asdf (Bash) mise (Rust) UniRTM (Go) Why it matters
Execution Path Bash Shims Rust Shims / PATH Lightweight Go Shims Uses a single compiled Go binary as a router to perfectly solve the performance issues of Bash shims and ensure cross-platform compatibility.
Concurrency Model None OS Threads Goroutines Go's ultra-lightweight goroutines provide extreme parallel throughput during massive toolchain downloads.
Config Hierarchy .tool-versions mise.toml .unirtm.toml Standardized, unified TOML configs across your entire project.

2. Environment & Context

Feature asdf mise UniRTM Details
Scope Management Tools only Tools + Env + Tasks Tools + Env + Tasks Seamlessly manage environments contextually per directory.
.env Parsing ❌ Native Native Reads traditional .env files automatically without external loaders.
Secrets Engine ❌ Plugins / Integrations Native SOPS Treats secure secret management as a first-class citizen using native SOPS integration.

3. Cross-Platform & Resilience

Feature asdf mise UniRTM Details
Windows Support WSL/MSYS Dependent Supported Native (Ground-up) Engineered natively for a flawless Windows and Cygdrive experience.
Alpine/Musl Partial Supported Hardcore Supported Runs flawlessly in minimal musl/Alpine containers without glibc overhead.
Reproducibility Versions mise.lock (Supported) unirtm.lock (Default) Strictly pins exact checksums to ensure reproducible team environments.

4. Ecosystem Affinity & Minimalism

Feature asdf mise UniRTM Details
Hybrid Path Resolution ❌ Partial Deeply Supported Dedicated optimizations for translating paths seamlessly across Windows Git Bash / Cygdrive environments.
External Dependencies Bash Ecosystem Minimal Absolute Zero Core plugins are compiled directly into the binary. Drop it into any minimal OS and it runs out of the box.
Shim Overhead Standard (Bash script) Optimized (Rust binary) Lightning Fast (Go) All tools symlink back to the unirtm engine for instant routing, perfectly preventing $PATH explosion.
DevOps Integration Custom Scripts Good Native Synergy Go-based architecture naturally aligns with cloud-native infrastructure, making custom integrations frictionless.

Special Thanks

Inspired by the architecture and developer experience pioneered by mise.

License

MIT License. Copyright (c) 2026-present SnowdreamTech Inc.

Metadata

Release files for snowdreamtech-unirtm 0.33.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for snowdreamtech-unirtm 0.33.1
File Actions
snowdreamtech_unirtm-0.33.1-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for snowdreamtech_unirtm-0.33.1-py3-none-win_arm64.whl
snowdreamtech_unirtm-0.33.1-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for snowdreamtech_unirtm-0.33.1-py3-none-win_amd64.whl
snowdreamtech_unirtm-0.33.1-py3-none-win32.whl Python 3 none Windows x86-32 Details for snowdreamtech_unirtm-0.33.1-py3-none-win32.whl
snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_x86_64.whl
snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_s390x.whl Python 3 none Linux glibc 2.17+ IBM System/390x Details for snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_s390x.whl
snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_ppc64le.whl Python 3 none Linux glibc 2.17+ PowerPC 64-le Details for snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_ppc64le.whl
snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details for snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_i686.whl
snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_armv7l.whl Python 3 none Linux glibc 2.17+ ARMv7l Details for snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_armv7l.whl
snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_aarch64.whl
snowdreamtech_unirtm-0.33.1-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for snowdreamtech_unirtm-0.33.1-py3-none-macosx_11_0_arm64.whl
snowdreamtech_unirtm-0.33.1-py3-none-macosx_10_9_x86_64.whl Python 3 none macOS 10.9+ x86-64 Details for snowdreamtech_unirtm-0.33.1-py3-none-macosx_10_9_x86_64.whl

Total release size: 211.3 MB

Release files / snowdreamtech_unirtm-0.33.1-py3-none-win_arm64.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-win_arm64.whl
Size 29.6 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
6cf167a1fbe49ef0d515e6cde7337ba4eefaf0d156254ba5b77567fcbde78851
BLAKE2b-256 checksum
How to use checksums
1e12c9ef30d1af9c67120aad87034f7569ad4516cb3103e7d7525a22d1c920cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-win_amd64.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-win_amd64.whl
Size 31.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
16cb49842a1002daaac137dac09108572fffd141dd7573bc10121e39b689a6b2
BLAKE2b-256 checksum
How to use checksums
5f8ad93a6a05befc52835105e1d08badab369b406937e4a7128586f4abc6911d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-win32.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-win32.whl
Size 30.7 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
65b264da925c0d20e617d83d96ecca917e2c5a2564527ad4396ab5dbc4f0a74b
BLAKE2b-256 checksum
How to use checksums
f18e4a8ddb37979083a4f0475b105992e5ca6909b848e2d3d76aa6ca65675b1e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_x86_64.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_x86_64.whl
Size 15.6 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
f243b5c7dfc8860c2822a46bbe2daef0aff8bb6de0cef570f56d5d3698a03b21
BLAKE2b-256 checksum
How to use checksums
932c1f4a549e1945bb3ce875cbdeb2df1bce3d074c6e101a795a1ca13691f9b4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_s390x.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_s390x.whl
Size 15.3 MB
Tags Linux glibc 2.17+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
92b172d5b6844daa56e8d693f262abe22ca3346ea0f017cc2534a4cd59489c01
BLAKE2b-256 checksum
How to use checksums
56bf8963af97c104af3d93261fd5d50d43c1ef7d37010abddea8af240b19ecc8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_ppc64le.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_ppc64le.whl
Size 14.3 MB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
e6455241c6e2deaea9335f9915d67bf034e5c154cd5426866c50df4b67909b00
BLAKE2b-256 checksum
How to use checksums
73c9a97c1b9791236f8cae38ce4d109ef4e64439b365997f9d69e3238c2b1b3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_i686.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_i686.whl
Size 14.8 MB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
5b6ced202e9fb63445efae9a1925ee77ed3b7d6d25a93b9a463ee6acaf74ae5b
BLAKE2b-256 checksum
How to use checksums
2270e024e20efcec3758de95a2b578a5174eaea426d952d31e1fda6a400af5a1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_armv7l.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_armv7l.whl
Size 14.8 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
6013d65680097c75d89e7feb9d63f036a2991eb27c1d472210b4d01fb2fca740
BLAKE2b-256 checksum
How to use checksums
659ba4e4b7361731a2ca2020e5de3d612a11d9d6f4d84c37d1a3c260302d0db0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_aarch64.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-manylinux2014_aarch64.whl
Size 14.2 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
fca96475ef35265650ee5b20758c3be8068dd7728f29f65f53353eac7f9d1086
BLAKE2b-256 checksum
How to use checksums
771003491f2ff2fae4296c515aac50c561a7bfcf6b0ea7043f8f4e731f0c8d5c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-macosx_11_0_arm64.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-macosx_11_0_arm64.whl
Size 14.7 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
6b456219d55b375accb6712446480c413b4d6b13887f32ba2dd433cc44103e59
BLAKE2b-256 checksum
How to use checksums
b5f9f5fd31c7d07a58d2ef23d196fe673bdd1c9885cfc73d743a6eba633d1863
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / snowdreamtech_unirtm-0.33.1-py3-none-macosx_10_9_x86_64.whl

Download URL snowdreamtech_unirtm-0.33.1-py3-none-macosx_10_9_x86_64.whl
Size 15.9 MB
Tags Python 3 macOS 10.9+ x86-64
SHA-256 checksum
How to use checksums
47b224c04cbf05daba88356daae9ed56ab2057606cbc096052bda513de2b0ab9
BLAKE2b-256 checksum
How to use checksums
b5849af14cedfb5d7bcd87d2d2aa0e0e99276dfef7e36b150c7f99aa5bdd8c7b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Security for snowdreamtech-unirtm 0.33.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page