Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mudler/luet

:package: :whale: 0-dependency Container-based Package Manager using SAT solver and QLearning
https://github.com/mudler/luet

build cloud containers docker golang kubernetes package-manager reinforcement-learning sat

Last synced: 26 days ago
JSON representation

:package: :whale: 0-dependency Container-based Package Manager using SAT solver and QLearning

Host: GitHub
URL: https://github.com/mudler/luet
Owner: mudler
License: gpl-3.0
Created: 2019-06-05T17:03:26.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-08-27T08:58:27.000Z (3 months ago)
Last Synced: 2024-10-07T17:32:46.563Z (about 1 month ago)
Topics: build, cloud, containers, docker, golang, kubernetes, package-manager, reinforcement-learning, sat
Language: Go
Homepage: https://luet.io
Size: 24.8 MB
Stars: 261
Watchers: 10
Forks: 24
Open Issues: 75
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        


  



# luet - Container-based Package manager

[![Docker Repository on Quay](https://quay.io/repository/luet/base/status "Docker Repository on Quay")](https://quay.io/repository/luet/base)

[![Build and release on push](https://github.com/mudler/luet/actions/workflows/release.yml/badge.svg)](https://github.com/mudler/luet/actions/workflows/release.yml)

[![GoDoc](https://godoc.org/github.com/mudler/luet?status.svg)](https://godoc.org/github.com/mudler/luet)

[![codecov](https://codecov.io/gh/mudler/luet/branch/master/graph/badge.svg)](https://codecov.io/gh/mudler/luet)

Luet is a multi-platform Package Manager based off from containers - it uses Docker (and others) to build packages. It has zero dependencies and it is well suitable for "from scratch" environments. It can also version entire rootfs and enables delivery of OTA-alike updates, making it a perfect fit for the Edge computing era and IoT embedded devices.

It offers a simple [specfile format](https://luet.io/docs/concepts/packages/specfile/) in YAML notation to define both [packages](https://luet.io/docs/concepts/packages/) and [rootfs](https://luet.io/docs/concepts/packages/#package-layers). As it is based on containers, it can be also used to build stages for Linux From Scratch installations and it can build and track updates for those systems.

It is written entirely in Golang and where used as package manager, it can run in from scratch environment, with zero dependencies.

[![asciicast](https://asciinema.org/a/388348.svg)](https://asciinema.org/a/388348)

## In a glance

- Luet can reuse Gentoo's portage tree hierarchy, and it is heavily inspired from it.

- It builds from containers, but installs, uninstalls and perform upgrades on machines

- Installer doesn't depend on anything ( 0 dep installer !), statically built

- You can install it aside also with your current distro package manager, and start building and distributing your packages

- [Support for packages as "layers"](https://luet.io/docs/concepts/packages/specfile/#building-strategies)

- [It uses SAT solving techniques to solve the deptree](https://luet.io/docs/concepts/overview/constraints/) ( Inspired by [OPIUM](https://ranjitjhala.github.io/static/opium.pdf) )

- Support for [collections](https://luet.io/docs/concepts/packages/collections/) and [templated package definitions](https://luet.io/docs/concepts/packages/templates/)

- [Can be extended with Plugins and Extensions](https://luet.io/docs/concepts/plugins-and-extensions/)

- [Can build packages in Kubernetes (experimental)](https://github.com/mudler/luet-k8s)

- Uses containerd/go-containerregistry to manipulate images - works also daemonless with the img backend

## Install

- **Using official installer script:**

    ```console

    $ curl https://luet.io/install.sh | sudo sh

    ```

- **Or using [`bin`](https://github.com/marcosnils/bin)**

    ```console

    $ bin i github.com/mudler/luet

    ```

### Test installation:

```console

$ luet --help

$ luet search ...

$ luet install ..

```

## Documentation

[Documentation](https://luet.io/) is available, or

run `luet --help`,  any subcommand is documented as well, try e.g.: `luet build --help`.

# Dependency solving

Luet uses SAT and Reinforcement learning engine for dependency solving.

It encodes the package requirements into a SAT problem, using [gophersat](https://github.com/crillab/gophersat) to solve the dependency tree and give a concrete model as result.

## SAT encoding

Each package and its constraints are encoded and built around [OPIUM](https://ranjitjhala.github.io/static/opium.pdf). Additionally, Luet treats

also selectors seamlessly while building the model, adding *ALO* ( *At least one* ) and *AMO* ( *At most one* ) rules to guarantee coherence within the installed system.

## Reinforcement learning

Luet also implements a small and portable qlearning agent that will try to solve conflict on your behalf

when they arises while trying to validate your queries against the system model.

To leverage it, simply pass ```--solver-type qlearning``` to the subcommands that supports it ( you can check out by invoking ```--help``` ).

## Authors

Luet is here thanks to our amazing [contributors](https://github.com/mudler/luet/graphs/contributors)!.

Luet was originally created by Ettore Di Giacinto, [email protected], [email protected].

## License

Luet is distributed under the terms of GPLv3, check out the LICENSE file.