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.2

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.2
File Actions
snowdreamtech_unirtm-0.33.2-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for snowdreamtech_unirtm-0.33.2-py3-none-win_arm64.whl
snowdreamtech_unirtm-0.33.2-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for snowdreamtech_unirtm-0.33.2-py3-none-win_amd64.whl
snowdreamtech_unirtm-0.33.2-py3-none-win32.whl Python 3 none Windows x86-32 Details for snowdreamtech_unirtm-0.33.2-py3-none-win32.whl
snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_x86_64.whl
snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_s390x.whl Python 3 none Linux glibc 2.17+ IBM System/390x Details for snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_s390x.whl
snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_ppc64le.whl Python 3 none Linux glibc 2.17+ PowerPC 64-le Details for snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_ppc64le.whl
snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details for snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_i686.whl
snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_armv7l.whl Python 3 none Linux glibc 2.17+ ARMv7l Details for snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_armv7l.whl
snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_aarch64.whl
snowdreamtech_unirtm-0.33.2-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for snowdreamtech_unirtm-0.33.2-py3-none-macosx_11_0_arm64.whl
snowdreamtech_unirtm-0.33.2-py3-none-macosx_10_9_x86_64.whl Python 3 none macOS 10.9+ x86-64 Details for snowdreamtech_unirtm-0.33.2-py3-none-macosx_10_9_x86_64.whl

Total release size: 211.8 MB

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

Download URL snowdreamtech_unirtm-0.33.2-py3-none-win_arm64.whl
Size 29.7 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
d6b556271e5d29780ec67ec65420401aa6dfa3b070b9ede1e685a690716df4ae
BLAKE2b-256 checksum
How to use checksums
e474c28f2bc402a25bd113658f601df73bae8f77fb174cbfaa0f8aee62511904
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.2-py3-none-win_amd64.whl

Download URL snowdreamtech_unirtm-0.33.2-py3-none-win_amd64.whl
Size 31.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
85a6a7615d944c13d60c6396ce9fcc3912e544e2ed50fb54c8f0b04b4b3e06d6
BLAKE2b-256 checksum
How to use checksums
490d456067e889f677bd5064393dad913d188a82139657bbfd3a03a7f540dc44
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.2-py3-none-win32.whl

Download URL snowdreamtech_unirtm-0.33.2-py3-none-win32.whl
Size 30.8 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
a8cf5c335de2fad17e224c4bcbaeda5c6632bce4f15c5ed5b58292c68c2949ff
BLAKE2b-256 checksum
How to use checksums
ff33f3614ecdd1b2ecc1110f56e60ec5d423f4883f3727d73d9d4956dffaa044
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.2-py3-none-manylinux2014_x86_64.whl

Download URL snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_x86_64.whl
Size 15.7 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
8ef4f2c534d864436c74608bcb9366606fe4e61434a8cdced88565e3e8e4241a
BLAKE2b-256 checksum
How to use checksums
524e38b102b196b7ca2cc6fe9c450120ee2b420153ae54cf52b594c0a8b9a0c0
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.2-py3-none-manylinux2014_s390x.whl

Download URL snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_s390x.whl
Size 15.4 MB
Tags Linux glibc 2.17+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
a6c00494744e15ccf116fe97efeb1421df39e80e22334682c75e695eeab52bcb
BLAKE2b-256 checksum
How to use checksums
3324d3fe7b19beab35457842888178049f5922dd81ab8a66cf0e56dd3eedeaa1
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.2-py3-none-manylinux2014_ppc64le.whl

Download URL snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_ppc64le.whl
Size 14.4 MB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
46bf7ccc608dd02935cb82713f0aa14e198964e21de405785ca3a7efb35c707c
BLAKE2b-256 checksum
How to use checksums
5128fa6a5d501f65ea9b75bad0abfeb7e0ffdf52c8d0e5d07aacad8511d0f413
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.2-py3-none-manylinux2014_i686.whl

Download URL snowdreamtech_unirtm-0.33.2-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
eea5c961df79234432d4f891f7fb058fbbc2d91288a0c624a2e7f2d3cafac1c4
BLAKE2b-256 checksum
How to use checksums
074dbab81d86dd070e4f871b55605c9cec35f39561b7359316f91dbd9aa9e6de
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.2-py3-none-manylinux2014_armv7l.whl

Download URL snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_armv7l.whl
Size 14.8 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
b48d25618789bc466901e19a5563d02c030769d5e43935f4a9413b726a5d9acc
BLAKE2b-256 checksum
How to use checksums
7858538c141725d4413c824ea4559c4a072cc55b2715bc10c85bd9a0847733bc
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.2-py3-none-manylinux2014_aarch64.whl

Download URL snowdreamtech_unirtm-0.33.2-py3-none-manylinux2014_aarch64.whl
Size 14.2 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
3dbb3b33adaed774835b4d47ce696f104d94e94c727bc165022d0022ce0e116a
BLAKE2b-256 checksum
How to use checksums
f8dbb29d01e969d67bd310f3ae0eab86f869550e792ee55a42b2bdf271798a58
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.2-py3-none-macosx_11_0_arm64.whl

Download URL snowdreamtech_unirtm-0.33.2-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
583a16fd3c2f71886a86d129ec4b91dbb46e2ee4842b2d96864f0fb2051ba06b
BLAKE2b-256 checksum
How to use checksums
130ac988964f3a19a6ca30b6d7270c97ad4d33b026007aed1ff196e163a03e56
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.2-py3-none-macosx_10_9_x86_64.whl

Download URL snowdreamtech_unirtm-0.33.2-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
a39fbfa17ebb975516788fca012b2052175570fd5190c6185fe4c40c7b5a5657
BLAKE2b-256 checksum
How to use checksums
cd319c6e784d3fcb6d6aaf7945be5033087b9806d00f0e9051c12c3c7f9a09f5
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.2

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