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

Total release size: 211.2 MB

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

Download URL snowdreamtech_unirtm-0.33.0-py3-none-win_arm64.whl
Size 29.6 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
93f0afffe6b2f7e8ff852fd52a4e5c9962cb9caf852000abed92df7ff3e98255
BLAKE2b-256 checksum
How to use checksums
aa13cd813bba7f4cd6dc6d368f5e5431fd8f26e9ef15d6746ff2d12978b81d73
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.0-py3-none-win_amd64.whl

Download URL snowdreamtech_unirtm-0.33.0-py3-none-win_amd64.whl
Size 31.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
e1d34683085e8b1bcd05b9dd71864b55fe9954ac014e9d4ad8aa8b1b6383a792
BLAKE2b-256 checksum
How to use checksums
c06abc37147baddcf474c5c7c6bf751983c15e4fd9a8c8edc9d448bfd6a78b43
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.0-py3-none-win32.whl

Download URL snowdreamtech_unirtm-0.33.0-py3-none-win32.whl
Size 30.7 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
18207d050754ff2b8238c3072a257049fa665cb303fd9f86707ed8a415f2301d
BLAKE2b-256 checksum
How to use checksums
6031c40c4155fe102a1740786515de17b851b2016269bdc47fec4b2e3bb1ff3d
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.0-py3-none-manylinux2014_x86_64.whl

Download URL snowdreamtech_unirtm-0.33.0-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
5ad4276756b2c021d7446bce35ff520d12f163c54726d213602349e6dc897435
BLAKE2b-256 checksum
How to use checksums
909bf5ee62dd8dd1b7ef4167c11ce1a2315dda59fd5e0e677215118c144c059b
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.0-py3-none-manylinux2014_s390x.whl

Download URL snowdreamtech_unirtm-0.33.0-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
f28be4588ad057269a8edbce66bf673c45f107859f5153cde86645cbd4535123
BLAKE2b-256 checksum
How to use checksums
2d3bad391ec165951f62653fe1af27037b34c3872fa6b684069374214bdeb029
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.0-py3-none-manylinux2014_ppc64le.whl

Download URL snowdreamtech_unirtm-0.33.0-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
f1c13198139cc252918c522557dc770e8ef88912f04390e3e97af81d50e7b925
BLAKE2b-256 checksum
How to use checksums
9333f3f2001c97dc3156f4ed892090cf9c431b6c5057f0edba9dee3cd9287ccd
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.0-py3-none-manylinux2014_i686.whl

Download URL snowdreamtech_unirtm-0.33.0-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
a285685bf644b471a5bb1fc9e1d0da8ea48f8a8cf8e42b07307df9f55750e5d6
BLAKE2b-256 checksum
How to use checksums
aa4f4ba4bc50274a56433ff30a72ad25a77419da4541821051072b95e8a69775
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.0-py3-none-manylinux2014_armv7l.whl

Download URL snowdreamtech_unirtm-0.33.0-py3-none-manylinux2014_armv7l.whl
Size 14.8 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
d7671b52160c60a1970d4d081b0a29ddaae85b6da4bc3e8159e43229e03c7bd9
BLAKE2b-256 checksum
How to use checksums
579bf2bae9479fa9070478ece664dc99304350b9acc1f933440865f115a0b49f
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.0-py3-none-manylinux2014_aarch64.whl

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

Download URL snowdreamtech_unirtm-0.33.0-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
b1a899766eb95942c41982077f97fc079170d67fede68eddd4830e61b86f0563
BLAKE2b-256 checksum
How to use checksums
b58ed6add41c93ff1e990a8d43f120da8eeecea5787b8fac5c67d557fbe356c7
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.0-py3-none-macosx_10_9_x86_64.whl

Download URL snowdreamtech_unirtm-0.33.0-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
a9b46d917beb2b1a667b3ed9c940341b2eb173a6e50c8f083e5513be09c0507d
BLAKE2b-256 checksum
How to use checksums
1a8afa173abc320f649caff2e9684af661b46bd80320550e5c6fba3ef65a6d5b
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.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