LibScript

LibScript is a radically evolved, zero-dependency, cross-platform software provisioning framework and global package manager. It operates entirely on native shell scripts (sh, cmd, bat) to bring sophisticated configuration management, environment scoping, and application deployment to Linux, macOS, modern Windows, and legacy MS-DOS—without requiring external runtimes like Python or Ruby.

What Makes LibScript Interesting?

• Zero-Dependency Bootstrapping: Needs nothing more than a POSIX shell or Windows command prompt. You can bootstrap a bare-metal machine instantly.
• Universal Package Management: Abstracted package manager layer (pkg_mgr.sh) seamlessly translates and delegates to apt, apk, dnf, brew, pacman, choco, or winget.
• Deployment Generator (package_as): Dynamically compile declarative manifests into Dockerfiles, docker-compose.yml, Debian/RPM/APK packages, or Windows Installers (MSI, InnoSetup, NSIS), and even interactive TUI installers.
• Native Component Dependencies: Applications can natively declare dependencies (e.g., mariadb, caddy) in their vars.schema.json. LibScript automatically resolves these via selectable strategies (reuse, install-alongside, overwrite)—fully exposed to interactive CLIs, env vars, and generated UI wizards.
• Environment & Version Scoping: Install multiple versions of toolchains and isolate their environments (using --prefix and env/run/exec commands).
• Daemon Management: Built-in translation to Systemd, OpenRC, and Windows Services for persistent databases and web servers.

Features & Use-Cases

• Toolchain Provisioning: Natively install Rust, Go, Python, Node.js, C/C++, Zig, Java, PHP, Ruby, Bun, Deno, Swift, etc.
• Server & Web Setup: Instantly stand up Caddy, Nginx, Docker, Node.js, and lightweight Kubernetes (k0s).
• Database & Storage Management: Deploy PostgreSQL, MongoDB, SQLite, Valkey, Etcd, and RabbitMQ natively.
• Third-Party App Deployment: Provision JupyterHub, OpenVPN, Firecrawl, and Celery stacks directly to the host.
• Declarative Environments: Use libscript.json (via install-deps) to define and provision a complex stack in parallel.
• Local Execution: Run commands inside a component’s isolated environment (libscript.sh run python 3.11 --version).

Quick Start

# List components
./libscript.sh list

# Search for a component
./libscript.sh search nodejs

# Install globally or to a specific prefix
./libscript.sh install rust latest
./libscript.sh install postgres 16 --prefix=/opt/db

# Generate a Docker Compose stack from your environment
./libscript.sh package_as docker_compose postgres 16 redis latest > docker-compose.yml

Documentation Index

• ARCHITECTURE.md - Internal execution lifecycle and directory structure.
• DEPENDENCIES.md - How cross-platform package resolution works.
• DEVELOPING.md - Guide to contributing and scaffolding new components.
• USAGE.md - Deep dive into commands, flags, and JSON manifests.
• WHY.md - The philosophy behind zero-dependency shell scripting.
• WINDOWS.md - Specifics on Windows, PowerShell, and legacy DOS support.
• TEST.md - Testing methodologies (CI, local, Vagrant).
• ROADMAP.md / FUTURE.md / IDEAS.md - Project trajectory.

CI Checks Matrix