IRL™ 🌱

Software for Humans.

 ╔══════════════════════╗
 ║      IRL™ 🌱         ║
 ║ Software for Humans  ║
 ╚══════════════════════╝

irl is a universal package installer built natively in Python. Whether it's an NPM package, a PyPI module, or a GitHub repository, just ask irl to install it. It will magically figure out the registry, check your system, and give you a beautiful "Touching grass" progress bar along the way.

Features

Universal Installer: irl install <package>. It automatically figures out if <package> is on NPM, PyPI, or GitHub.
Doctor Diagnostics: irl doctor <package> checks your dependencies, network, and storage before you install.
Detective Glasses: irl glasses <package> peeks into a registry and tells you the version, size, and source of a package.
Beautiful UI: Powered by Rich, you get buttery-smooth spinners, colored ASCII menus, and clear visual feedback.

Installation

pip install irl-pkg

Usage

 [bold cyan]👓 Glasses[/bold cyan]  - See Clearly
 [bold red]🩺 Doctor[/bold red]   - Stay Healthy
 [bold yellow]📦 Install[/bold yellow]  - Get Started
 [bold green]🌱 Grass[/bold green]    - Go Outside
 [bold magenta]🦐 Posture[/bold magenta]  - Fix your back
 [bold blue]💧 Hydrate[/bold blue]  - Drink water
 [bold cyan]🪟 Window[/bold cyan]   - Look outside
 [bold magenta]🪞 Mirror[/bold magenta]   - Get a compliment
 
 Usage: irl <command> <package>

Wellness Commands

IRL cares about your health as a developer. Run these commands anytime:

irl grass: Daily streak tracker for going outside and touching green things.
irl posture: Gives a friendly reminder to fix your "shrimp posture".
irl hydrate: A daily tracker to ensure you hit your 8 glasses of water.
irl window: Gives you a real-time weather report without having to actually open your blinds.
irl mirror: Provides a random, lovely developer compliment.
Bedtime Enforcer: If you try to run any command past 1:00 AM, irl will gently remind you to go to sleep.

Install Packages

Installs seamlessly using NPM, PIP, or direct Git clone under the hood.

# Trans Power™ App
irl install transpower

# Direct internet downloads (auto-extracts ZIP/TAR files)
irl install https://example.com/package.zip
irl install https://example.com/script.py

# PyPI
irl install requests

# NPM
irl install chalk

# GitHub Repo
irl install octocat/Hello-World

Run Diagnostics

Make sure you are ready to install.

irl doctor chalk

🩺 Checking package...

✅ Dependencies installed
✅ Network available
✅ Storage available

Diagnosis:
Ready for installation.

Inspect Packages

Peek into the registry to see what you are getting before you download.

irl glasses requests

👓 Looking closely...

Package: requests 
Version: 2.31.0
Source: PyPI
Install Method: pip install

Vision enhanced.

Rollback / old versions

If a new release does not feel right on your terminal, the easy way is the Moai rollback command:

# See available versions
pip index versions irl-pkg

# Roll back to a specific version
pip install --upgrade irl-pkg==1.7.1

# Example: return to the previous stable release
pip install --upgrade irl-pkg==1.7.0

Moai note: rolling back only changes the CLI package version. Your local IRL profile/state files stay on your machine.

Authors

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

Release files for irl-pkg 1.7.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for irl-pkg 1.7.3
File	Interpreter	ABI	Platform	Reset
irl_pkg-1.7.3-py3-none-any.whl 13.4 MB Jun 26, 2026	Python 3	none	any	Details

Release files / irl_pkg-1.7.3-py3-none-any.whl

Download URL	irl_pkg-1.7.3-py3-none-any.whl
Size	13.4 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`d1962057057215dfc0cf872ef6ecdf7c09d3476c35fd677db2f94a6c12896f3d`
BLAKE2b-256 checksum How to use checksums	`7136e5f33db5a04c9a6aa127fd87c0752587e5ce359fd984048e04b5fb7926a1`
Upload date	Jun 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.11`