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 PowerShell (Windows):

irm https://raw.githubusercontent.com/snowdreamtech/UniRTM/main/install.ps1 | iex
unirtm --version

Via Git Bash (Windows):

powershell.exe -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/snowdreamtech/UniRTM/main/install.ps1 | iex"
~/bin/unirtm.exe --version

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):

# Bash (Linux/macOS or Windows Git Bash)
echo 'eval "$(unirtm env)"' >> ~/.bashrc

# Zsh
echo 'eval "$(unirtm env)"' >> ~/.zshrc

# Fish
echo 'unirtm env | source' >> ~/.config/fish/config.fish

# PowerShell (Windows) - add to $PROFILE
unirtm env | Out-String | Invoke-Expression

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

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

Total release size: 196.4 MB

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-win_arm64.whl
Size 27.5 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
16b89acf377f36f832ff3102ddb5048f6b7cff954e54e690cc533bf69f481f7c
BLAKE2b-256 checksum
How to use checksums
9a6a84af907fe1d6a7f11565bee386a447f36e9b9c47bcfe7b40d6abdb5a412a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-win_amd64.whl
Size 29.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
65147eb3ee7dbef20b9b0f68c879b5b8a6b1e400eaf84fb3a5fa839dc3a0f74c
BLAKE2b-256 checksum
How to use checksums
fbea1bd34126cd7e795a28eb0cabf1b2baa0cab2c3b7b7b5f4a818a255ce2f1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-win32.whl
Size 28.5 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
f16640967aa9ac6176883d33492b0d8163234f6df404236c2ac1dccd2715c91d
BLAKE2b-256 checksum
How to use checksums
02a8568a3dadabffbd4c83b21fc7eec1ba45359a15809fc5b76542b99b8da377
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-manylinux2014_x86_64.whl
Size 14.6 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
debb1ba4f9a0ac5d0384efc8357d076f2dc7559dddc489df421e421f32fc5bb7
BLAKE2b-256 checksum
How to use checksums
046cf1b2fd473440e98d2cf4f485dc15987f2f60abd75911780e2246958c6c39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-manylinux2014_s390x.whl
Size 14.3 MB
Tags Linux glibc 2.17+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
a3be15c92ecbddf1b8a10d10f6cb671fa2bfca92439c03b06f84abd74ae03ac5
BLAKE2b-256 checksum
How to use checksums
8bfbed2821242f13ab9e3e0d4b9dc963c67c88f9d7684f9bfa93f0546c947369
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-manylinux2014_ppc64le.whl
Size 13.3 MB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
af5480ef06f114232ee9feec5cc0df985673e2f054165e92d0126461c59a4dfa
BLAKE2b-256 checksum
How to use checksums
6dc0dad42e6f742131271777bb841874ce951cd5f8ef6ec4920c5fbdb87ac523
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-manylinux2014_i686.whl
Size 13.8 MB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
44ff29eb13c461e75788b98685bd292b0a449348a7ce765fb400d6c7a8e10c78
BLAKE2b-256 checksum
How to use checksums
0c0bbcb9d433c5c9c7767a5da12764e69fd96987ed1d877946c81fa24d5e12bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-manylinux2014_armv7l.whl
Size 13.7 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
13da49f62e026030062141227a64345f31c5b7d5de6ac698096b6381833f3b8d
BLAKE2b-256 checksum
How to use checksums
dd28dbdfdc5e9aa336965009d1fd43b0f3ef6579224d5ae612b377cccb0723c6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-manylinux2014_aarch64.whl
Size 13.2 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
71c49f0310b488df7b7009ecb25972b2beee2b3fa31616fae7ff19a71b8305e9
BLAKE2b-256 checksum
How to use checksums
43bc98455ad2329b369323b3662b2900f1e3f3d60787e4120f70c85a21676125
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-macosx_11_0_arm64.whl
Size 13.7 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
f9c5e354090aa3e6ebf57682ced21ed10dfe1c16c1ba48a6c8fd2749de93718a
BLAKE2b-256 checksum
How to use checksums
d5f40253f12efcc6f70f6d41ff3625752242f657625321098f08319001666f27
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

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

Download URL snowdreamtech_unirtm-0.42.0-py3-none-macosx_10_9_x86_64.whl
Size 14.7 MB
Tags Python 3 macOS 10.9+ x86-64
SHA-256 checksum
How to use checksums
ea3a1ed1e4ebe2ca055fc9d52df39cba0a376c72c5773096da9f3ed7a098a2d9
BLAKE2b-256 checksum
How to use checksums
078016c78f8d92927c254e97b9280c7c66ba720bb2bdcd60d0b82f6ca06e0ea0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Security for snowdreamtech-unirtm 0.42.0

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