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

Total release size: 209.6 MB

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

Download URL snowdreamtech_unirtm-0.31.0-py3-none-win_arm64.whl
Size 29.4 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
833d86334db1a74b43b948f3d7c29d819c077bac64c65ed2e963024157d1c6a3
BLAKE2b-256 checksum
How to use checksums
dd8875d2cc82f1a785b296f8f2508309e046d5ddb19eef193e474f2fa1a36cdd
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.0-py3-none-win_amd64.whl

Download URL snowdreamtech_unirtm-0.31.0-py3-none-win_amd64.whl
Size 31.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
fe291ae6d1ece7eabf7575b0ca81f9b561d8765a4dbcde79fc99d841c9f62732
BLAKE2b-256 checksum
How to use checksums
5e931674e6a38018b9b8d553b82c9bff75a69ecb640f7b7a0de5d0675b2c7e01
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.0-py3-none-win32.whl

Download URL snowdreamtech_unirtm-0.31.0-py3-none-win32.whl
Size 30.5 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
3051de33b99cb29927b165cb963b64e9e7f2462f230659f90f26b5984bb84e5f
BLAKE2b-256 checksum
How to use checksums
18ed5c45a0a279fd7a010d11947ccd829118ddfc5415fc4bb0c54a6d5193046b
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.0-py3-none-manylinux2014_x86_64.whl

Download URL snowdreamtech_unirtm-0.31.0-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
a625b0ea1ecc3a27fa5a2331c2a445ae5c39f4097ea2fc7469400bd545e1cf5a
BLAKE2b-256 checksum
How to use checksums
1a0022a014e2bafeb1729da2c46ad82b7843c7aca318d912cfda26eb9aa362cc
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.0-py3-none-manylinux2014_s390x.whl

Download URL snowdreamtech_unirtm-0.31.0-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
34d7bfa6bc53325cd045ec3776dd3804fc0c0d738d69897c8cdab61754376768
BLAKE2b-256 checksum
How to use checksums
c1cb6eb208b2133fa9468500fc323d62f755dc7743efe893b6c07905b77b938a
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.0-py3-none-manylinux2014_ppc64le.whl

Download URL snowdreamtech_unirtm-0.31.0-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
348010707a7fc8db5a75e164ce25d1a878853bdba0a93641ad85b6b09857eeeb
BLAKE2b-256 checksum
How to use checksums
8aef55e0d4bd4ca6ea02a7217a310543b3a68bb7cf39f890160717009e534ed7
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.0-py3-none-manylinux2014_i686.whl

Download URL snowdreamtech_unirtm-0.31.0-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
6ea33c8485495b015b998e5d99f1933984f5c8ec31cae3f243372ccabb78ffbc
BLAKE2b-256 checksum
How to use checksums
6107be187a63d47653895d796d9864ad5fe9c276f5b551827fbaca0c6080172d
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.0-py3-none-manylinux2014_armv7l.whl

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

Download URL snowdreamtech_unirtm-0.31.0-py3-none-manylinux2014_aarch64.whl
Size 14.1 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
819369d5e0f6291f392ccfea6b9b316c920805cbe032476077e051f637e4f64b
BLAKE2b-256 checksum
How to use checksums
402c6dcfe2be2c92336ac9ae23adfc99f90dae721af67dde41010b7d0a08193d
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.0-py3-none-macosx_11_0_arm64.whl

Download URL snowdreamtech_unirtm-0.31.0-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
6898d723306aa36526b5354338100858e7872ebe4bd4223ec0312813ab00fbbc
BLAKE2b-256 checksum
How to use checksums
0082fed7a238de41fddd181756bc7fcb86f53805614b2d8d860eddfba074a212
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.0-py3-none-macosx_10_9_x86_64.whl

Download URL snowdreamtech_unirtm-0.31.0-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
c9372c3aff425a8c3ada31d38ee0dae001fe72f05968cb83fbe2ad7bd4e2507d
BLAKE2b-256 checksum
How to use checksums
936e612b90a4d2d1dcdbd0d425fdcaa4ff0d152b91cc5594967e51edb9b18e41
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.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