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

Total release size: 209.6 MB

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

Download URL snowdreamtech_unirtm-0.31.1-py3-none-win_arm64.whl
Size 29.4 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
9dd72d328572a0e15e1541ab191999c5eb910ef250b3d7a6765d858f2e5ce3fc
BLAKE2b-256 checksum
How to use checksums
e3a76d2b59e95e049e21db4429f4892af6b201dc0faaed8095cf1ad13310d0b1
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.31.1-py3-none-win_amd64.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-win_amd64.whl
Size 31.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
07efb6d64dc88d1b0cb4f090a95bf5ad885ef746b0960be2015a278c221a37d5
BLAKE2b-256 checksum
How to use checksums
1f6406eaec2f1f18e819e33fbd0f70eb2f69c62bbb3152602defad9c74a5892e
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.31.1-py3-none-win32.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-win32.whl
Size 30.5 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
c80e640d6a49ad73c30e85df653df1b814099dec26d09b4c53b58e9f6d2b21bb
BLAKE2b-256 checksum
How to use checksums
ff10cb2877529745011e49b4babb7b12b2fd819dfa1f943c9b4c135807de55ae
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.31.1-py3-none-manylinux2014_x86_64.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-manylinux2014_x86_64.whl
Size 15.5 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
fe88c4620f5b57001102293130e785559a38fb31ae08cadba01d3f23b0a621db
BLAKE2b-256 checksum
How to use checksums
7420c4fa5031799ddfa1f1eced7f24d1ff93c7efe2dc9f4ddd43784c0d62a657
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.31.1-py3-none-manylinux2014_s390x.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-manylinux2014_s390x.whl
Size 15.2 MB
Tags Linux glibc 2.17+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
b31e0aa903150eaea6d048318b75e3f5cfc75ce68aeb6f2723e6b61c12b6da72
BLAKE2b-256 checksum
How to use checksums
9a8e7ec61f0362b416cb0973503eeb64d865910d5c8c9da3c4b82e2aeacef285
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.31.1-py3-none-manylinux2014_ppc64le.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-manylinux2014_ppc64le.whl
Size 14.2 MB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
1f28a3695dac8b430b6608fe2dee2a65dc3930dffd36d8304645768797b6cfca
BLAKE2b-256 checksum
How to use checksums
709ea20e867b7fe88b87808f54ce3db521e792051a3a25a7cfc4dcdc928ab68c
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.31.1-py3-none-manylinux2014_i686.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-manylinux2014_i686.whl
Size 14.7 MB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
e05c9c3b9e9ba2daa2d14d138739b99947938a33faa1b1c87919fd92b3f9db2e
BLAKE2b-256 checksum
How to use checksums
3a4adff120080016abe5a8850280cee6530b1e546f7dcf7ad9dc3b3449e8b9ce
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.31.1-py3-none-manylinux2014_armv7l.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-manylinux2014_armv7l.whl
Size 14.7 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
3253a2ffbcd808daff2ccca51ebe670c5b27f7913f63cd1d3d94256435dbbc7c
BLAKE2b-256 checksum
How to use checksums
0f5cef5403d32b532ffc008a55fbcbf5de1c6c468b3c2f314409e1688f179c07
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.31.1-py3-none-manylinux2014_aarch64.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-manylinux2014_aarch64.whl
Size 14.1 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
c5794096500972745830409ca131830f4efcd1c5be6b4a853c2fc9be540b0bc4
BLAKE2b-256 checksum
How to use checksums
d42afece0fb42b4ef51d54492e21055a61c4c36728b9143d4e76dc41a58537c4
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.31.1-py3-none-macosx_11_0_arm64.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-macosx_11_0_arm64.whl
Size 14.6 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
df8caece3b9bb4fd2ec7e7fabfb9a183a2114a36fefb9676f0a97f40d813271b
BLAKE2b-256 checksum
How to use checksums
fa71fe3d1d4c67bbffbde3c4b134eba1e97be6d557569489ebd308c0218a6625
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.31.1-py3-none-macosx_10_9_x86_64.whl

Download URL snowdreamtech_unirtm-0.31.1-py3-none-macosx_10_9_x86_64.whl
Size 15.8 MB
Tags Python 3 macOS 10.9+ x86-64
SHA-256 checksum
How to use checksums
a94b9b9daa3674423ac9d133cb8d34607a90a47336904f00fa8cb1f5555c4aef
BLAKE2b-256 checksum
How to use checksums
dc0c2ad3deb43ee507e705ac10adb806b870909acde6e4888a05fd05a1b30e71
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.31.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