almandine

Almandine – Lua Package Manager 💎

A modern, cross-platform, developer-friendly package manager for Lua projects. Easily manage, install, and update Lua single-file dependencies..

Features

• 📦 Easy Dependency Management: Add, remove, and update Lua single-file dependencies with simple commands.
• 🔒 Reproducible Installs: Lockfiles ensure consistent environments across machines.
• 🛠️ Cross-Platform: Works on Linux, macOS, and Windows.

🚀 Installation

You can install almd by running the following commands in your terminal. These scripts will download and run the appropriate installer for your system from the main branch of the official repository.

macOS/Linux Install

curl -LsSf https://raw.githubusercontent.com/nightconcept/almandine/main/install.sh | sh

Windows Install

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/nightconcept/almandine/main/install.ps1 | iex"

Requirements

macOS/Linux Requirements

• Nix
• devenv

Windows Requirements

• Go 1.24
• pre-commit
• go-task task runner

Note: These can all be installed via Scoop.

Usage

almd init                # Create a new Lua project
almd add <package>       # Add a dependency
almd remove <package>    # Remove a dependency
almd install             # Install dependencies
almd list                # List installed dependencies
almd self update         # Update almd

Tasks

Project tasks are managed using go-task. You can list available tasks with task --list.

License

This project is licensed under the MIT License. See LICENSE for details.